Uptime Kuma 与 Traefik 代理的 WebSocket 连接问题解析

问题背景

在使用 Uptime Kuma 监控系统时，如果通过 Traefik 反向代理进行访问，可能会遇到 WebSocket 连接中断的问题。这个问题主要出现在 Traefik 2.11.1 和 3.0.0-rc4 版本中，会导致 WebSocket 连接不稳定或被意外终止。

技术原因分析

WebSocket 是一种在单个 TCP 连接上进行全双工通信的协议，常用于实时应用场景。Traefik 作为反向代理，需要正确处理 WebSocket 连接的升级和保持。在问题版本中，Traefik 的 TCP 连接处理存在缺陷，特别是与连接终止相关的超时设置不当，导致了 WebSocket 连接的中断。

解决方案演进

临时解决方案

在 Traefik 2.11.2 和 3.0.0-rc5 发布前，可以通过在 Traefik 的静态配置中添加特定的超时设置来缓解问题：

transport:
  respondingTimeouts:
    tcp:
      lingeringTimeout: 180

这个设置将 TCP 连接的 lingering 超时时间延长至 180 秒，有助于保持 WebSocket 连接的稳定性。

永久解决方案

Traefik 团队在后续版本(2.11.2 和 3.0.0-rc5)中彻底修复了这个问题。值得注意的是：

1. 新版本移除了 tcp.lingeringTimeout 配置项
2. 如果配置文件中仍保留此设置，Traefik v3 将无法启动
3. 用户需要检查并清理旧的配置项

最佳实践建议

对于使用 Uptime Kuma 并通过 Traefik 代理的用户，建议采取以下措施：

1. 及时升级到 Traefik 2.11.2 或 3.0.0-rc5 及以上版本
2. 检查并移除所有 lingeringTimeout 相关配置
3. 测试 WebSocket 连接的稳定性
4. 监控系统日志，确保没有连接异常

技术影响评估

这个问题对 Uptime Kuma 的影响主要体现在：

1. 监控数据的实时性可能受到影响
2. 报警通知可能出现延迟
3. 仪表板的实时更新可能不连贯

通过及时应用修复方案，可以确保监控系统的稳定运行和数据准确性。对于依赖 WebSocket 功能的其他服务，同样需要注意 Traefik 版本的选择和配置。