RMS 故障排查

沿完整链路排查最有效：矿机 → RMS 本地端口 → 公网 → RustMinerSystem RMS 端口 → 上游矿池。先确认故障停在哪一段，再修改参数。

矿机连不上 RMS

• 矿机是否填写端口表复制的本地地址。
• RMS 设备 IP 是否因 DHCP 发生变化。
• 本地监听端口是否运行并且没有被占用。
• 局域网与主机防火墙是否允许矿机访问。
• 是否误把远程 RMS 服务端端口填给矿机。

RMS 连不上服务端

• 远程地址是否为 域名或IP:端口。
• 服务端端口是否正在运行且从矿场网络可达。
• 两端币种、协议与密码是否完全一致。
• RMS3、RMS3(Zstd)、RMS3(NB) 与 RMS2 是否被错误混接。
• 安全组、防火墙、运营商网络或中间代理是否阻断端口。

RMS3(NB) 无法保存或连接

• 币种必须是 BTC 或 LTC。
• 服务端和客户端都必须选择 RMS3(NB)。
• 多远程地址中的所有目标都必须是相同币种和 NB 协议。
• 不要把 NB 端口通过 RMS3(Zstd) 或 RMS3 端口直接混接。

有连接但拒绝率升高

按风险从低到高回退：

1. 检查上游矿池延迟、丢包和服务端 CPU。
2. 增加每个端口的出口连接数量。
3. 降低协议压缩级别。
4. 减少单台 RMS 承载的矿机。
5. 将少量矿机切回旁路地址进行对照测试。

每次只改一个变量，等待指标稳定后再继续。

出口连接数不符合预期

• 不同本地端口和不同币种会形成独立出口组。
• 多远程地址可能产生更多出口路径。
• 自动端口与手动端口可能同时运行。
• 检查当前连接数量设置是否已保存并生效。

GUI 白屏或后台打不开

Windows GUI 白屏时，确认 WebView2Loader.dll 与 rms-production-gui.exe 位于同一目录，并安装 Edge WebView2 Runtime。

后台打不开时检查进程、管理端口、防火墙和安全访问路径。设置安全路径后，实际 URL 末尾必须带 /。

回滚清单

生产部署前应保存：

• 矿机直接连接 RustMinerSystem 的旁路地址。
• RMS 版本、端口映射和压缩参数。
• RustMinerSystem 端口 JSON 备份。
• 可用的旧配置与升级前日志。

大面积故障时先停止继续扩容，把测试批次切回旁路；如果问题仍在 RMS 链路，恢复之前记录的连接数和压缩参数。更换协议时要在服务端和本地创建一对新的匹配端口，不能只改单侧。