设置你的中继

当两台设备无法直接连接时,由中继转发传输。自己运行中继,这部分流量就留在你自己的基础设施上。个人使用免费;商业许可证可增加多台中继、不限同时传输数量和使用统计。你需要一台有公网 IP 并已安装 Docker 的服务器。

安装

  1. 1

    开放 UDP 49737 端口

    在服务器防火墙和云服务商的安全组中都要放行。

    sudo ufw allow 49737/udp
  2. 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. 3

    设置服务器地址

    Compose 每次执行命令都会读取 .env,所以请把地址写在这个文件里,不要在命令行中临时传入。

    echo 'RELAY_HOST=203.0.113.7' > .env
  4. 4

    启动中继

    首次启动时,它会生成一个永久身份,并保存在数据卷中。

    docker compose up -d
  5. 5

    复制中继代码

    日志会显示你的代码和供手机扫描的二维码;运行起来后,每 30 秒还会输出一行统计信息。

    docker compose logs relay
    AlterSend 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. 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:7f6f2d059d8a549e30314fa436a98fbe1f62d314a5ec2a2b2be980075ef75226

org 代码是网络上一条签名记录的公钥,这条记录保存着你的中继列表,包括地址。设备从这条记录读取列表,所以更换服务器永远不会改变代码。

运行多台中继

在每台服务器上按同样的步骤安装,并使用同一个许可证,这样每台都不受限制。获取新中继的公钥,然后在显示你 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 而不是域名,因为应用是根据连接地址来标注传输方式的。

谁可以使用我的中继?

任何持有你中继代码的人。它不是可以更换的共享密钥,所以请把它当作邀请:只交给你自己的设备和一起工作的人。无论如何,传输始终是端到端加密的。