Win10 Docker部署ejabberd 21.04 Web管理访问报ERR_EMPTY_RESPONSE

已确认的问题现象 #

• 运行环境：Windows 10 操作系统，通过Docker部署ejabberd 21.04版本，使用Chrome浏览器进行Web访问
• 异常表现：
  • 点击Docker Desktop界面的Web管理入口按钮，浏览器提示localhost未返回数据，抛出ERR_EMPTY_RESPONSE错误
  • 参考官方镜像文档配置的5222端口访问Web管理界面时，浏览器提示无效HTTP响应
  • 改用8000端口尝试访问时，同样收到服务器空响应报错
• 初步排查结果：
  • 进入容器执行docker exec -it ejabberd tail -f logs/ejabberd.log查看运行日志，所有核心应用均正常启动，未发现Web管理服务相关的报错信息

排查及解决步骤 #

核对容器端口映射规则 #

• ejabberd Web管理界面默认在容器内部监听5280端口，与XMPP客户端通信端口5222、服务间通信端口5269完全独立
• 多数访问异常的根源是容器启动时未正确映射Web管理端口：
  • 常见错误配置：仅参考示例映射-p 5222:5222，遗漏Web管理端口的映射规则，导致宿主机所有端口都无法转发请求到容器内的Web服务
  • 正确的端口映射配置需包含Web服务规则：
    • 默认配置：添加-p 5280:5280映射，直接通过http://localhost:5280访问Web管理界面
    • 自定义端口配置：如果需要通过8000端口访问Web管理界面，将映射规则调整为-p 8000:5280即可

校验ejabberd内部Web管理模块的监听状态 #

• 进入容器执行命令查看当前所有监听服务状态：ejabberdctl list_listeners，确认5280端口对应的WebAdmin模块是否正常加载
• 如果模块未加载，需要调整ejabberd配置文件的listen配置段，确认存在如下规则：

  {5280, ejabberd_web_admin, [{ip, {0,0,0,0}}]}
  

• 重点确认监听地址为0.0.0.0，如果仅绑定回环地址127.0.0.1，Docker的端口转发规则将无法把外部请求路由到Web服务，会直接返回空响应

Windows 10 环境特殊注意事项 #

• 不要依赖Docker Desktop自带的Web入口快捷按钮，该按钮的跳转端口与镜像实际暴露的Web管理端口不一定匹配，手动输入对应端口的访问地址即可
• 容器启动后等待10-15秒再尝试访问：ejabberd 21.04版本会在核心XMPP服务启动完成后，才会加载Web管理模块的监听，过早访问会触发空响应错误
• 临时关闭Windows防火墙，测试端口连通性，排除系统防火墙拦截Docker流量的情况

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