CrossGram GitHub
Linux / DEPLOYMENT

Linux 一键部署

在 Ubuntu / Debian 或支持 dnf 的发行版上，以 systemd 服务部署 CrossGram Server；QQNT Bridge 也提供独立一键脚本。

准备：一台具有公网 IP 或可被客户端访问的 Linux 主机、root 权限，以及开放的 TCP 4430 端口。CrossGram 安装器会检查并安装 Node.js 24+、Git 与 Corepack。

1. 安装 CrossGram Server

把 203.0.113.10 换成客户端实际可以连接到的公网 IP 或域名：

curl -fsSL https://raw.githubusercontent.com/std-microblock/crossgram/main/deploy/install.sh \
  | sudo CROSSGRAM_PUBLIC_HOST=203.0.113.10 sh

安装器会创建低权限用户 crossgram，将代码放在 /opt/crossgram，持久数据放在 /var/lib/crossgram/data，并启动 systemd 服务。

更新服务

sudo crossgram-update

检查状态

sudo systemctl status crossgram
sudo journalctl -u crossgram -f

2. 安装 QQNT Bridge

QQNT 协议端位于 crossgram-project/qqnt-bridge。在 QQNT Bridge 仓库的 Release / 部署文档中复制最新的一键安装命令，并在同一台或可互通的主机上执行。

QQNT Bridge 的 bearer token 应写入 /etc/qqnt-bridge.env。CrossGram 会从环境变量读取它，不会把 token 复制到应用 YAML。

3. 生成客户端配置

首次启动成功后会自动创建 RSA 密钥。生成一个可以被 CrossGram Desktop / Android 导入的 JSON：

sudo crossgram-client-config --host 203.0.113.10 --port 4430 \
  --name 'My CrossGram' --output /tmp/crossgram-server.json

4. 登录客户端

  1. 从下载页安装客户端，并导入刚才生成的服务器 JSON。
  2. 通过 SSH 端口转发访问仅绑定本机的 WebUI：ssh -L 3140:127.0.0.1:3140 user@server。
  3. 打开 http://127.0.0.1:3140/platform-accounts，找到虚拟手机号与每 30 秒轮换的六位登录码。
  4. 在客户端输入 +999... 虒拟手机号和登录码。