01
准备一台 Ubuntu 服务器
已经有符合要求的服务器,可以直接用。新购时核对下面几项:
- 系统:Ubuntu Server 24.04 LTS,x86_64 / x64。
- 网络:固定公网 IPv4,允许 UDP。不要选仅有内网 IP 或 NAT 端口映射的套餐。
- 权限:能使用 root 或 sudo;安装时至少留出 2 GB 空间。
小型 Room 可从 2 核 / 2 GB 开始,屏幕共享重点看上传 / 出站带宽。不需要显卡或域名。查看人数和带宽参考。
完成标志:服务器控制台显示运行中,并能找到公网 IP、登录用户名和远程连接入口。
02
在 Relink 中直接生成并保存配置
使用支持自建配置导出的完整客户端并登录账号。找不到下面的入口时,先到 官网下载最新版。
- 点击左侧 +,选择「创建 Room」→「使用自有服务器创建」。
- 填写 Room 名称、服务器公网 IPv4、服务器名称和实际可用的出站带宽(5–1000 Mbps)。
- 点击「创建 Room 并生成配置」。系统会创建 Room,并自动登记属于你的节点。
- 点击「保存节点配置」,将
relink-node-setup.json保存到电脑上,文件名保持不变。
这份文件由系统即时生成,包含这个节点独有的 ID、接入令牌和语音中继密钥,不需要联系客服申请。生成后 30 分钟内可恢复领取;保存好的文件可在之后安装使用。
配置包含专属密钥,只传到自己的服务器。官网不提供所有人共用的配置文件,示例文件也不能代替它。
已有 Room 想增加节点,或配置没有保存怎么办?
上面的自动流程会创建一个新的 Room,不会给已有 Room 添加节点。给已有 Room 加节点、超过 30 分钟仍未保存配置或需要更换密钥时,由 Room 域主通过 反馈留言 → 使用问题 提供 Room Code、节点名称、公网 IPv4 和带宽,申请协助处理。不要重复创建 Room 来处理旧节点。
完成标志:你已经保存 relink-node-setup.json,客户端显示「Room 已创建,等待服务器上线」。接下来把这份文件传到服务器。
03
连接服务器,把配置文件拖进去
打开服务器终端
在云厂商控制台打开这台服务器,找到「远程连接」「终端」或「SSH」。按控制台提示,用你的用户名和密码或 SSH 密钥登录。后面的命令都在服务器终端执行,不是在电脑的 Windows 命令窗口。
上传配置文件
Windows 可以使用 WinSCP。打开它并新建连接:
- 文件协议
- SFTP
- 主机名
- 服务器的公网 IPv4
- 端口
- 控制台给出的 SSH 端口,通常是 22
- 用户名 / 登录方式
- 与刚才服务器终端相同的账号;按你的服务器配置使用密码或密钥
登录后,右侧是服务器文件。进入这个账号的主目录:root 是 /root,ubuntu 是 /home/ubuntu。将电脑上的 relink-node-setup.json 拖到右侧,确认上传。WinSCP 上传说明
回到服务器终端,用同一个账号执行:
test -s "$HOME/relink-node-setup.json" && echo '配置文件已找到,可以继续'完成标志:终端显示「配置文件已找到,可以继续」。没有这句话,先检查文件名、目录和登录账号。
04
在控制台添加四条入站规则
找到这台服务器的「安全组」或「防火墙」,进入「入站规则」。下面每行是一条规则,选择允许;媒体端口的来源填 0.0.0.0/0,让不同网络的 Room 成员都能接入。
| 协议 | 端口 / 范围 | 用途 |
|---|---|---|
| TCP | 3478 | 语音接入 |
| UDP | 3478 | 语音接入 |
| UDP | 49160–50183 | 语音中继 |
| UDP | 8890 | 屏幕共享 |
端口范围的分隔符以控制台要求为准。保留已有的 SSH 管理规则,不要放开所有端口。服务器若还有系统防火墙,也需要允许上述四项。
Ubuntu 的 UFW 防火墙怎么检查?
先执行下面这条命令。显示 Status: inactive 就跳过本项;只有显示 Status: active 才执行接下来的四条规则。
sudo ufw statussudo ufw allow 3478/tcp
sudo ufw allow 3478/udp
sudo ufw allow 49160:50183/udp
sudo ufw allow 8890/udp如果提示找不到 ufw,不要为了本教程安装或启用它;检查你已有的系统防火墙。这里不需要执行 ufw enable。
完成标志:控制台已保存四条允许规则,现有系统防火墙也已放行。
05
复制整段命令,开始安装
在第 3 步的服务器终端,以同一个账号粘贴下面整段命令,按回车。它会把配置放到安装位置、下载部署包、校验文件并安装。输入 sudo 密码时,终端不会显示字符,这是正常的。
(
set -e
config="$HOME/relink-node-setup.json"
test -s "$config" || { echo '未找到配置文件,请先完成第 3 步'; exit 1; }
if [ "$config" = /root/relink-node-setup.json ]; then
sudo chmod 600 "$config"
else
sudo install -o root -g root -m 600 "$config" /root/relink-node-setup.json
fi
sudo apt-get update
sudo apt-get install -y curl unzip python3
cd "$(mktemp -d)"
curl -fLO https://relinkus.cn/server/releases/Relink-Room-Node-2.1.3.zip
curl -fLO https://relinkus.cn/server/releases/Relink-Room-Node-2.1.3.zip.sha256
sha256sum -c Relink-Room-Node-2.1.3.zip.sha256
unzip Relink-Room-Node-2.1.3.zip -d bundle
cd bundle
sudo bash setup.sh --setup /root/relink-node-setup.json
)等待安装结束,不要关闭终端。编译组件可能需要几分钟。出现报错时先停下来,保存报错内容;不要跳过校验或删除旧节点重装。
完成标志:显示「3/3 安装完成,正在检查服务状态」,随后三个服务都为 active。这表示本机安装完成,还要继续检查实际接入。
06
回到 Relink,测试你的线路
先在服务器终端复制执行:
sudo systemctl is-active relink-room-media relink-room-turn relink-room-agent
sudo systemctl is-enabled relink-room-media relink-room-turn relink-room-agent第一条应显示三行 active,第二条应显示三行 enabled。然后在 Relink 中检查:
- 确认节点接入状态在线,屏幕共享线路里能找到第 2 步填写的服务器名称。
- 请另一位成员使用不同网络进入同一 Room,例如一人用宽带,另一人用手机网络。
- 测试语音;开启屏幕共享时,选择你的自建线路,确认对方有画面和声音。
完成标志:节点在线,选中自建线路后的屏幕共享实际可用。语音可能走成员直连,通话成功不能单独证明中继已经打通。
安装好了,但线路离线 / 没有画面
离线:核对配置登记的 IP 与实际出口 IP,并检查服务器能否访问官方服务的 TCP 443。没画面:确认选择了你的线路,并在云端和系统防火墙都允许 UDP 8890。查看详细排错。