MSST-Net Relay 3.1.x

MSST-Net 的 UDP 中转服务。两台设备无法直连时，由它转发 WireGuard 加密的数据，并代理游戏发现广播。适用于 MSST-Net Core 3.1.x 与 Coordinator 3.1.x，不支持 3.0.x 客户端。

同一个程序有两种运行方式：

• 官方中转（默认）：向 Coordinator 登记，出现在中转列表里，供所有用户使用。
• 自托管中转：自己部署，建房时用连接串指定，只为指定了它的房间服务。

文档

使用教程与完整文档见文档站：https://msst-net.msst2031.cn

仓库内的技术文档（英文，面向开发者）：

文档	内容
REFERENCE.md	报文处理、信任模型、Coordinator 接口、配置项与资源上限
SELF_HOSTED.md	自托管模式：配置、连接串、登记流程
REGISTRATION_AUTH.md	注册认证（sreg v1，0x0E）
SECURE_DISCOVERY.md	安全游戏发现（sdisc v1）

快速开始

从 Releases 下载对应平台的预编译包（Linux / Windows / macOS，amd64 与 arm64），解压后运行：

./msstnetRelay31x -config config.yaml               # 首次运行生成默认配置（权限 0600）
./msstnetRelay31x -config config.yaml -print-link   # 自托管：打印连接串后退出
./msstnetRelay31x -version

默认监听 UDP 21031。按文档站说明填好 config.yaml 后重启即可。

日志同时写到标准错误和工作目录下的 relay.log（权限 0600），按大小轮转：默认每个文件 50 MB，保留 relay.log.1 至 relay.log.5 五个旧文件。可用 log.file、log.max_size_mb、log.max_backups 调整；log.file 设为空则只写标准错误。

校验下载的文件：

sha256sum -c SHA256SUMS --ignore-missing
gh attestation verify msstnetRelay31x_<版本>_linux_amd64.tar.gz -R MSST-Net-Developers/msstnetRelay31x

也可以自行编译（需要 Go 1.27+）：go build -o msstnetRelay31x .

开发

go vet ./... && go test -race ./...

CI 在 Linux、macOS、Windows 上运行测试，并构建 linux / windows / darwin 的 amd64 与 arm64 版本。

发布：推送形如 v1.2.3 的标签（v1.2.3-rc.1 发布为预发布版）。release.yml 先跑完整 CI，再用 scripts/build-release.sh 打包、生成 SHA256SUMS 与构建来源证明，发布到 GitHub Releases。本地可用 scripts/build-release.sh v1.2.3 预先检查打包结果（输出到 dist/）。

许可证

MIT，见 LICENSE。发行的二进制包含第三方组件（BSD-3-Clause、MIT、Apache-2.0），分发时请一并附上 THIRD_PARTY_NOTICES。