RustDesk 连接中断：OS Error 10054 如何解决？

Question

RustDesk连接中断时出现“OS Error 10054”通常表示远程主机强制关闭了现有连接，常见于网络不稳定或防火墙干预。该错误在Windows系统上对应“WSAECONNRESET”，多发生在客户端与中继服务器通信过程中被中断。可能原因包括：NAT/防火墙阻断长连接、路由器超时设置过短、RustDesk服务端配置不当，或使用公共ID服务器时遭遇限流。为解决此问题，建议检查本地网络稳定性，关闭干扰的杀毒软件或防火墙规则；优先部署私有中继服务器（如hbbs/hbbr），避免依赖公共服务器；调整设备电源和网络适配器设置以防止休眠断连；确保RustDesk版本一致并启用日志排查连接细节。

Answer 1

1. 错误现象解析：OS Error 10054 与 WSAECONNRESET 的底层含义

RustDesk 在远程连接过程中若出现 OS Error 10054，表示操作系统底层接收到一个 TCP 连接重置（RST）包，导致现有连接被强制中断。在 Windows 平台上，该错误映射为 Winsock 错误码 WSAECONNRESET (10054)，属于典型的网络通信异常。

此错误通常发生在客户端与中继服务器（hbbr）或 ID 服务器（hbbs）建立长连接后，突然被对端主动关闭连接。从 TCP 协议栈角度看，可能是对方主机发送了 RST 包，而非正常的 FIN 握手断开。

常见触发场景包括：

• 防火墙或 NAT 设备中途丢弃连接
• 路由器设置的 TCP 超时时间过短
• 服务端进程崩溃或主动终止会话
• 公共服务器限流策略触发连接剔除
• 客户端休眠导致 socket 不再响应

2. 常见原因分类分析

类别	具体原因	影响层级
网络设备层	NAT 超时、路由器连接数限制	L3/L4
安全策略层	防火墙拦截、杀毒软件阻断	L7
服务架构层	公共 hbbs/hbbr 限流或拥塞	应用层
系统配置层	电源管理关闭网卡、适配器节能模式	OS 内核
软件版本层	客户端与服务端协议不兼容	应用逻辑

3. 深度排查流程图（Mermaid 格式）

```mermaid
graph TD
    A[出现 OS Error 10054] --> B{是否使用公共服务器?}
    B -- 是 --> C[切换至私有 hbbs/hbbr]
    B -- 否 --> D{检查服务端日志}
    D --> E[查看是否有异常断开记录]
    E --> F{客户端是否频繁休眠?}
    F -- 是 --> G[调整电源选项: 禁用快速启动 & 唤醒定时器]
    F -- 否 --> H[抓包分析 TCP 流量]
    H --> I[观察是否收到 RST 包]
    I -- 是 --> J[定位中间设备如防火墙/代理]
    I -- 否 --> K[检查 RustDesk 版本一致性]
    K --> L[启用 debug 日志并复现问题]
```

4. 解决方案实施路径

1. 优先部署私有中继服务：使用官方提供的 hbbs（ID 服务器）和 hbbr（中继服务器）部署于内网或云主机，避免公共服务器限流风险。
2. 配置 Keepalive 参数：在服务端启动参数中加入心跳保活机制，例如：

   ./hbbr --api --relay-only --keepalive-interval 30

3. 调整 Windows 防火墙规则：允许 RustDesk 可执行文件通过防火墙，禁用第三方安全软件临时测试。
4. 修改注册表延长 TCP 存活时间：

   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\KeepAliveTime = 30000 (ms)

5. 禁用网卡节能功能：设备管理器 → 网络适配器 → 属性 → 电源管理 → 取消勾选“允许计算机关闭此设备以节约电源”。
6. 统一客户端与服务端版本：确保所有节点运行相同 major.minor 版本，防止协议差异引发异常断连。
7. 启用日志收集：在 RustDesk 设置中开启“日志级别”为 debug，并保存日志用于分析握手阶段失败点。
8. 使用 Wireshark 抓包验证：过滤 tcp.port == 21115（默认 hbbr 端口），查看是否存在异常 RST 或 FIN 序列。
9. 优化路由器设置：提高 NAT 表超时时间（建议 ≥ 7200 秒），开启 UPnP 或手动配置端口转发。
10. 监控服务进程稳定性：通过 systemd 或 Windows Service 管理 hbbs/hbbr，设置自动重启策略。