Docker-compose部署Apache Guacamole 1.2.0偶发容器卡住502错误问题咨询

异常可能原因 #

• Guacamole 1.2.0 版本存在已知的连接泄漏缺陷：从日志可以观察到guacd频繁报User is not responding错误，而guacamole端持续重复加载GUACAMOLE_HOME，说明服务的HTTP工作线程被长期占用没有释放，运行2-3天后线程池被完全占满，无法处理新的获取token请求，nginx反向代理无法收到响应就返回502错误，服务彻底卡住后不再生成新的日志。
• 异常RDP连接资源残留：日志中存在Error connecting to RDP server报错，连接RDP服务失败的会话没有被guacd和guacamole正确回收，持续占用系统资源，累积到阈值后就会导致服务无响应。
• 系统资源耗尽：服务长期运行过程中，内存、文件句柄等系统资源被逐步占用且没有自动释放，最终资源不足导致服务停止响应。

容器卡住自动重启方案 #

• 方案1：使用Docker原生健康检查，在docker-compose.yml中为guacamole和guacd服务增加健康检测规则，服务异常后自动重启，配置示例如下：

services:
  guacamole:
    image: guacamole/guacamole:1.2.0
    restart: always
    # 其他原有配置保留
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/guacamole/"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 60s
  guacd:
    image: guacamole/guacd:1.2.0
    restart: always
    # 其他原有配置保留
    healthcheck:
      test: ["CMD", "nc", "-z", "localhost", "4822"]
      interval: 30s
      timeout: 10s
      retries: 3

• 方案2：自定义业务监控脚本，编写定时任务定期调用获取token的业务接口，检测到返回502或超时后，自动执行docker-compose restart guacamole guacd命令重启服务，该方案可以直接贴合实际业务逻辑做检测，准确性更高。

升级到1.3.0是否可以解决问题 #

Guacamole 1.3.0版本正式修复了多个1.2.0版本存在的连接泄漏、异常会话资源未回收、HTTP线程池耗尽类缺陷，其中就包含你遇到的RDP连接失败后资源残留、周期性服务卡住的问题，绝大多数相同场景的用户升级后问题都得到了彻底解决。
升级前请务必备份guacamole关联的数据库数据，避免配置丢失，升级完成后建议观察1-2周确认服务稳定性。

内容的提问来源于stack exchange，提问作者gsr