设置你的中继
当两台设备无法直接连接时,由中继转发传输。自己运行中继,这部分流量就留在你自己的基础设施上。个人使用免费;商业许可证可增加多台中继、不限同时传输数量和使用统计。你需要一台有公网 IP 并已安装 Docker 的服务器。
安装
- 1
开放 UDP 49737 端口
在服务器防火墙和云服务商的安全组中都要放行。
sudo ufw allow 49737/udp - 2
创建 docker-compose.yml
services: relay: image: ghcr.io/altersend/relay:latest network_mode: host restart: unless-stopped environment: RELAY_HOST: ${RELAY_HOST:?set RELAY_HOST to this server's public IP} ALTERSEND_LICENSE: ${ALTERSEND_LICENSE:-} volumes: - relay-data:/etc/altersend-relay volumes: relay-data: - 3
设置服务器地址
Compose 每次执行命令都会读取 .env,所以请把地址写在这个文件里,不要在命令行中临时传入。
echo 'RELAY_HOST=203.0.113.7' > .env - 4
启动中继
首次启动时,它会生成一个永久身份,并保存在数据卷中。
docker compose up -d - 5
复制中继代码
日志会显示你的代码和供手机扫描的二维码;运行起来后,每 30 秒还会输出一行统计信息。
docker compose logs relayAlterSend relay listening relay public key: 6fad022df811a2bfbc734260df47c55499973409bc34b89f66ad791c24be2197 add this relay in AlterSend — Settings → Connection: relay:6fad022df811a2bfbc734260df47c55499973409bc34b89f66ad791c24be2197@203.0.113.7 [stats] egress 0GB | sessions=0 pairings=0 matched=0 - 6
在 AlterSend 中添加
打开“设置 → 中继 → 自托管中继”,粘贴代码后点按发送按钮,即可一步完成保存和连接测试。
只有你自己的设备需要这个代码。发送给别人时,应用会在建立连接时把中继信息一并传给对方。
商业许可证
把许可证添加到 .env 并重启。中继随后显示的不再是 relay 代码,而是 org 代码。把这一个代码交给团队里的每台设备;它背后的服务器集中管理,可以随时更换,谁都不用重新粘贴。
ALTERSEND_LICENSE=<你的许可证>
# 可选:每次传输只 POST 字节数和时间戳,不含其他内容
REPORT_URL=https://example.com/hook
REPORT_TOKEN=<bearer token>[selfhost] licensed to Acme GmbH until 2027-08-27
[selfhost] published org relay record (seq 1)
add this relay in AlterSend — Settings → Connection:
org:7f6f2d059d8a549e30314fa436a98fbe1f62d314a5ec2a2b2be980075ef75226org 代码是网络上一条签名记录的公钥,这条记录保存着你的中继列表,包括地址。设备从这条记录读取列表,所以更换服务器永远不会改变代码。
运行多台中继
在每台服务器上按同样的步骤安装,并使用同一个许可证,这样每台都不受限制。获取新中继的公钥,然后在显示你 org 代码的那台服务器上发布完整列表。其他服务器首次启动时也会显示各自的 org 代码;忽略它们,始终只分发第一个。
# 在新服务器上
docker compose exec relay node key.js
# 在显示你 org 代码的服务器上
docker compose exec relay node conf/publish.js \
<key1>@203.0.113.7@-5 \
<key2>@198.51.100.4@8更新与备份
更新会拉取新镜像并重启;身份和设置都保存在数据卷中,所以代码依然有效。
docker compose pull
docker compose up -d故障排查
日志提示缺少变量 RELAY_HOST
Compose 每次执行命令都会读取 .env,而不只是 up。请确认该文件与 docker-compose.yml 在同一目录,并且包含 RELAY_HOST。
应用提示无法连接到中继
几乎总是 UDP 49737 端口的问题。请同时检查服务器防火墙和云服务商的安全组,再用 docker compose ps 确认容器正在运行。
传输仍然显示为直连
这通常是正常的:只有两台设备无法直接连接时,中继才会转发传输,而能直连时直连更快。如果从未显示“已通过中继连接”,请检查 RELAY_HOST 填的是 IP 而不是域名,因为应用是根据连接地址来标注传输方式的。
谁可以使用我的中继?
任何持有你中继代码的人。它不是可以更换的共享密钥,所以请把它当作邀请:只交给你自己的设备和一起工作的人。无论如何,传输始终是端到端加密的。
