MeshCentral WebRDP连接超时问题分析与解决方案

问题背景

在MeshCentral服务器管理系统中，用户报告了一个关于WebRDP功能的异常行为。当在config.json配置文件中设置了"AgentPong"或"AgentPing"参数后，WebRDP连接会在达到设定时间后意外断开，而预期行为应该是保持连接直到用户主动断开。

问题现象

管理员在配置文件中设置了AgentPong为45秒后，观察到所有通过WebRDP建立的远程桌面连接都会在45秒后自动断开。这种异常行为影响了远程支持的连续性和用户体验。

技术分析

经过深入分析，发现这是一个与MeshCentral中WebRDP功能相关的心跳检测机制问题。WebRDP协议依赖于MeshCentral的底层通信框架，其中包含了用于检测连接状态的心跳包机制。

当配置AgentPong或AgentPing参数时，系统会按照设定时间间隔发送心跳检测包。然而，在WebRDP场景下，这些心跳检测被错误地应用到了RDP会话上，导致系统误判连接状态并主动断开连接。

解决方案

该问题已在MeshCentral 1.1.21版本中得到修复。修复方案主要涉及以下技术改进：

1. 修改了apprelays.js文件中的连接状态检测逻辑
2. 分离了WebRDP会话和普通代理连接的心跳处理机制
3. 确保WebRDP会话不受AgentPong/AgentPing参数的影响

对于无法立即升级的用户，可以单独替换apprelays.js文件来解决问题。替换后需要重启MeshCentral服务使更改生效。

实施建议

1. 对于生产环境，建议升级到MeshCentral 1.1.21或更高版本
2. 如果选择单独替换apprelays.js文件，请确保备份原始文件
3. 修改配置后，建议在测试环境验证WebRDP连接的稳定性
4. 监控系统日志，确认WebRDP连接能够按预期保持

总结

这个案例展示了远程管理软件中连接保持机制的重要性。通过这次修复，MeshCentral的WebRDP功能现在能够正确处理心跳检测与连接保持的关系，为用户提供更稳定的远程桌面体验。系统管理员应当定期关注软件更新，及时应用此类关键修复，以确保系统功能的完整性和可靠性。