Docker-Jitsi-Meet部署中CONFERENCE FAILED问题排查指南

问题现象

在使用Docker Swarm部署最新稳定版Docker-Jitsi-Meet时，用户遇到了无法加入会议的问题，前端显示"Unfortunately something went wrong"错误。控制台日志显示关键错误信息"CONFERENCE FAILED: conference.focusDisconnected"。

组件版本信息

部署使用了以下容器镜像版本：

• jitsi/prosody:prosody-0.12.4
• jitsi/web:web-1.0.8187-1
• jitsi/jicofo:jicofo-1.0-1097-1
• jitsi/jvb:jvb-2.3-165-gb7dba824-1

网络架构说明

该部署采用了较为复杂的网络架构：

1. 互联网流量首先被转发到一个运行Nginx的Docker节点
2. Nginx再将相关TCP/UDP端口转发到其他节点上的服务
3. 已正确转发的端口包括：
   • JVB的10000端口
   • WebSocket的5280端口
   • Web服务相关端口

详细错误分析

从浏览器控制台日志中可以观察到完整的连接流程：

1. 初始化阶段正常：

   • 成功加载页面
   • 检测到媒体设备
   • 建立WebSocket连接
   • XMPP连接成功建立

2. 关键错误点：

   • 尝试获取TURN凭证失败
   • 会议焦点(focus)连接断开
   • 最终导致会议失败

根本原因

通过检查jicofo日志发现，问题源于XMPP主机名配置不一致。系统默认使用"meet.jitsi"作为XMPP主机名，但用户在网络配置中将其更改为"jitsi"，导致组件间无法正确识别和连接。

解决方案

1. 确保所有组件使用一致的XMPP主机名配置
2. 检查jicofo日志确认焦点服务是否正常运行
3. 验证网络配置中所有必要的端口转发是否正确

经验总结

在复杂网络环境下部署Jitsi-Meet时，需要特别注意：

• 各组件间的主机名配置必须一致
• 网络转发规则需要完整覆盖所有必要的通信端口
• 出现连接问题时，应首先检查jicofo日志，它通常包含关键的错误信息

通过系统性地检查这些配置点，可以有效避免类似"conference.focusDisconnected"问题的发生。