RELINK SERVER

搭建自己的服务器。

为你的 Room 提供语音中继和屏幕共享。第一次部署,按下面六步操作。

SHA-256 校验文件账号、Room 与消息仍使用官方服务。

新手教程 · Ubuntu 24.04

第一次部署,从这里开始。

这里教你把一台云服务器接入自己的 Room。语音中继和屏幕共享由它提供;账号、好友和消息仍由官方服务提供。

先拿到配置,再安装。新建自建 Room 时,Relink 会自动生成专属配置,你可以直接保存,不需要提交申请。只有部署包还不够,先完成第 2 步取得配置文件。

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 中直接生成并保存配置

使用支持自建配置导出的完整客户端并登录账号。找不到下面的入口时,先到 官网下载最新版。

  1. 点击左侧 +,选择「创建 Room」→「使用自有服务器创建」。
  2. 填写 Room 名称、服务器公网 IPv4、服务器名称和实际可用的出站带宽(5–1000 Mbps)。
  3. 点击「创建 Room 并生成配置」。系统会创建 Room,并自动登记属于你的节点。
  4. 点击「保存节点配置」,将 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 成员都能接入。

协议端口 / 范围用途
TCP3478语音接入
UDP3478语音接入
UDP49160–50183语音中继
UDP8890屏幕共享

端口范围的分隔符以控制台要求为准。保留已有的 SSH 管理规则,不要放开所有端口。服务器若还有系统防火墙,也需要允许上述四项。

Ubuntu 的 UFW 防火墙怎么检查?

先执行下面这条命令。显示 Status: inactive 就跳过本项;只有显示 Status: active 才执行接下来的四条规则。

sudo ufw status
sudo 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 中检查:

  1. 确认节点接入状态在线,屏幕共享线路里能找到第 2 步填写的服务器名称。
  2. 请另一位成员使用不同网络进入同一 Room,例如一人用宽带,另一人用手机网络。
  3. 测试语音;开启屏幕共享时,选择你的自建线路,确认对方有画面和声音。

完成标志:节点在线,选中自建线路后的屏幕共享实际可用。语音可能走成员直连,通话成功不能单独证明中继已经打通。

安装好了,但线路离线 / 没有画面

离线:核对配置登记的 IP 与实际出口 IP,并检查服务器能否访问官方服务的 TCP 443。没画面:确认选择了你的线路,并在云端和系统防火墙都允许 UDP 8890。查看详细排错。

完整技术文档其他系统、配置规划与维护排错

01

准备服务器

Linux x64、glibc 2.28 或更新版本、systemd,支持 apt-get 或 dnf。需要公网 IPv4、Bash、Python 3.9+、unzip 和管理员权限,安装时至少留出 2 GB 磁盘空间。

小型 Room 可先从 2 核 / 2 GB 开始,带宽按实际可用值登记。无需显卡或域名;服务器位置尽量靠近成员。租金、带宽和流量由服务器所有者承担。

仅适用于 Room 媒体节点。ARM、Windows、Alpine/musl 及完整业务服务器部署不在本方案内。

02

选购与配置

雨云推荐入口:按活动要求注册并绑定微信领取新人五折券,领取状态、有效期和适用产品以雨云页面为准。请选独立公网 IP,NAT 映射套餐不适用本安装器。

优先选靠近成员的地域、Ubuntu 24.04 LTS x86_64、固定公网 IPv4 和稳定公网出站带宽。无需显卡;不要选择 ARM 或竞价实例。

阿里云 ECS 与 轻量服务器 均限制流量穿透类服务。本节点包含 TURN 中继,购买前请向厂商确认用途;此入口不表示厂商已批准 Relink。

人数与语音配置

按每频道最多 8 人、96 kbps、全部同时说话并经过中继,留 25% 带宽余量。人数指同时语音人数。以下是购买起点,尚非实测容量承诺。

同时语音CPU / 内存系统盘出站带宽 · 仅语音
1–8 人2 核 / 2 GB40 GB10 Mbps
9–16 人2 核 / 4 GB40 GB20 Mbps
17–32 人4 核 / 4 GB40 GB40 Mbps
33–64 人4 核 / 8 GB40 GB80 Mbps

单个频道人数增加时,语音流量按逐对连接增长。同频道 16 人约需 30 Mbps,32 人约需 120 Mbps(含余量);不能直接套用分组表。完整文档含计算公式。

屏幕共享额外带宽

当前视频目标码率加 25% 余量并向上取整,需加在语音带宽上。一路最多 7 位观看者,多路共享需累加;声音、重传和线路波动另留余量。

共享画质 / 码率1 人观看3 人观看7 人观看
720p · 30 FPS / 3 Mbps+4 Mbps+12 Mbps+27 Mbps
1080p · 30 FPS / 5 Mbps+7 Mbps+19 Mbps+44 Mbps
1080p · 60 FPS / 8 Mbps+10 Mbps+30 Mbps+70 Mbps
1440p · 120 FPS / 20 Mbps+25 Mbps+75 Mbps+175 Mbps

8 人语音加一路 1080p / 60 FPS、3 人观看,可从 2 核 / 4 GB、40 GB、50 Mbps 开始试用,再按实际占用和丢包调整。成员自身的上行、下行同样需要够用。

带宽和流量怎么选?

每天长时间使用,优先比较固定带宽;偶尔使用,比较按流量并设置费用提醒。5 Mbps 画面发给 4 人,视频载荷约 9 GB/小时,60 小时约 540 GB,尚未包含语音、音频和重传。宣传峰值不等于持续带宽,价格和续费以下单页为准。

参考:阿里云计费说明 · 腾讯云计费说明。资料核对:2026-10-02。

03

取得节点配置

新建自建 Room:在完整客户端点击「+ → 创建 Room → 使用自有服务器创建」,填写名称、公网 IPv4 和可用出站带宽,点击「创建 Room 并生成配置」,然后「保存节点配置」。查看逐步操作。

系统会自动登记节点并交付专属 relink-node-setup.json,无需人工申请。配置包含节点 ID、接入令牌和 TURN 密钥,不是公共下载文件,也不能使用示例占位值。

同一 Room 最多登记三个节点,登记 IP 必须与服务器连接官方服务的实际出口 IP 一致。给已有 Room 增加节点或配置恢复超时,由域主通过 反馈留言 → 使用问题 申请协助。

上传配置到 /root/relink-node-setup.json,或按新手教程先上传到登录账号的主目录。不要公开配置或将其提交到 GitHub。

sudo chmod 600 /root/relink-node-setup.json

04

放行端口

同时检查云安全组和系统防火墙。安装器不会修改防火墙。

入站端口用途
TCP / UDP 3478语音接入
UDP 49160–50183语音中继
UDP 8890屏幕共享

出站需要允许官方 HTTPS/WSS(TCP 443)、DNS、媒体流量与系统软件源。SSH 端口保留给自己的管理 IP。8554、9997、9998、4329 仅供本机使用,不要开放到公网。

05

下载并安装

以下命令下载固定版本并核对完整性,解压后执行安装。校验失败时重新下载,不要跳过。

mkdir -p ~/relink-server-install
cd ~/relink-server-install
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

安装器会检查系统、端口和配置,安装媒体组件并启用开机自启。编译需要几分钟,请保留 SSH 会话。已有节点或未完成的安装会停止覆盖,保留原文件。

只检查包和配置,不安装
bash setup.sh plan --setup /root/relink-node-setup.json

预演不会修改系统,也不会验证目标主机、官方接入或公网端口。

06

检查并使用

sudo bash setup.sh doctor
sudo systemctl is-enabled relink-room-media relink-room-turn relink-room-agent
  1. 确认三个服务为 active,开机自启为 enabled。
  2. 确认官方接入状态已在线,屏幕共享线路中出现你的自建线路。
  3. 两位成员使用不同网络测试语音和屏幕共享;共享时选择该自建线路。语音可能直接连接,成功通话不能替代中继测试。
  4. 安排维护窗口重启服务器,再检查服务、语音和屏幕共享。

自动检查和源码测试不能替代具体服务器的公网验收。是否已完成部署,以在线状态和实际媒体传输为准。

07

维护与排错

服务运行,但节点仍离线

检查 DNS、系统时钟、出站 TCP 443 及官方 WSS 连接。核对登记 IP 是否与出口 IP 一致;代理、NAT 或多出口可能造成不一致。

语音正常,屏幕共享无画面

确认选择了自建线路,并在安全组和系统防火墙放通 UDP 8890。语音直连成功不代表 SRT 屏幕链路已经可用。

安装失败或已有旧节点

保留原配置和安装日志,运行 doctor。不要杀掉未知进程、删配置或跳过保护重装。安装日志在 /var/log/relink-node-install-*.log。

备份、容量规划、日志检查与停用命令请阅读 运维文档。完整教程也可 下载 Markdown 文档。