Docker-Jitsi-Meet部署中视频桥接失败的排查与解决

问题背景

在使用Docker-Compose部署Jitsi视频会议系统时，许多开发者会遇到一个典型问题：当第二个参与者加入会议后，所有参与者会在几秒钟内被断开连接，并显示"您已断开连接"的错误提示。这个问题在局域网(LAN)环境中尤为常见，特别是在MacOS系统上部署时。

错误现象分析

从日志中可以观察到几个关键错误点：

1. 前端控制台报错：CONFERENCE FAILED: conference.videobridgeNotAvailable
2. JVB(视频桥接服务)日志显示健康检查失败：Health check failed in PT14.820268S
3. Jicofo(会议焦点服务)日志显示Colibri分配超时：Failed to allocate a colibri2 endpoint: Timeout

根本原因

经过深入分析，这个问题主要由以下几个技术因素导致：

1. TLS加密要求：Jitsi的WebSocket连接(用于Colibri协议和XMPP通信)强制要求使用TLS加密
2. 域名验证机制：系统设计上要求PUBLIC_URL必须使用有效域名而非IP地址
3. 证书验证：自签名证书在某些配置下无法被系统完全信任

解决方案

方案一：使用有效域名和证书（推荐）

1. 购买一个有效域名
2. 为该域名申请正规的HTTPS证书(如Let's Encrypt)
3. 在.env配置文件中设置：

   PUBLIC_URL=https://yourdomain.com:8443
   JVB_ADVERTISE_IPS=your.server.ip.address
   

方案二：开放必要UDP端口

确保以下端口在防火墙中开放：

• UDP 10000：用于视频流传输
• TCP 8443：用于HTTPS连接
• TCP 5222：用于XMPP通信

配置优化建议

1. 在LAN环境中，可以添加以下配置：

   JVB_DISABLE_STUN=true
   ENABLE_HTTP_REDIRECT=false
   

2. 对于测试环境，可以尝试禁用部分安全检查：

   DISABLE_HTTPS=0  # 必须保持为0，不能禁用HTTPS
   ENABLE_XMPP_WEBSOCKET=0
   

技术原理深入

Jitsi的视频桥接架构依赖于几个关键组件协同工作：

1. JVB (Jitsi Videobridge)：负责实际的视频流传输
2. Jicofo：作为会议协调者，管理参与者连接
3. Prosody：XMPP服务器，处理信令通信

当第二个参与者加入时，系统会尝试建立点对点连接。如果TLS验证失败或网络配置不当，会导致整个会话终止，表现为所有参与者被断开。

最佳实践

1. 生产环境始终使用有效域名和证书
2. 定期检查服务日志，特别是JVB的健康状态
3. 在Docker-Compose部署时，确保所有服务使用相同网络配置
4. 对于企业内网部署，考虑配置内部DNS解析

通过以上方法，可以确保Jitsi视频会议系统在各种网络环境下稳定运行，避免参与者意外断开的问题。