避坑指南：在Linux服务器上部署Docker版Jitsi Meet时，你可能遇到的5个典型问题及解决

部署基于Docker的Jitsi Meet视频会议服务器看似简单，但实际操作中往往会遇到各种意料之外的障碍。本文将聚焦五个最常见的"坑点"，帮助开发者快速定位和解决问题。

1..env文件配置错误导致服务无法互联

.env文件是Docker版Jitsi Meet的核心配置文件，一个错误的参数就可能导致整个系统无法启动。以下是几个关键检查点：

• PUBLIC_URL：必须使用完整的HTTPS URL（如https://meet.example.com），不能省略协议或端口
• DOCKER_HOST_ADDRESS：必须设置为服务器的公网IP地址，不能使用127.0.0.1或localhost
• TZ：时区设置需符合标准格式（如Asia/Shanghai），错误的时区会导致日志时间混乱

# 典型正确的.env配置示例 PUBLIC_URL=https://meet.yourdomain.com DOCKER_HOST_ADDRESS=203.0.113.45 TZ=Asia/Shanghai

注意：修改.env后必须完全重建容器才能生效，简单的docker-compose restart不会加载新配置。

2. 宿主机防火墙或SELinux策略阻塞Docker容器网络

即使Docker容器内部运行正常，错误的宿主机网络配置也会导致外部无法访问。排查步骤：

1. 检查防火墙规则：

   sudo ufw status # Ubuntu sudo firewall-cmd --list-all # CentOS

   确保以下端口开放：

   • 80/tcp (HTTP)
   • 443/tcp (HTTPS)
   • 10000/udp (媒体传输)

2. SELinux问题：

   sudo setenforce 0 # 临时关闭 sudo getenforce # 检查状态

   如需永久禁用，编辑/etc/selinux/config设置SELINUX=disabled

3. Docker网络模式： 确保docker-compose.yml中未错误配置network_mode: host，这会导致端口冲突。

3.~/.jitsi-meet-cfg目录权限问题导致配置无法写入

Jitsi的配置目录需要特定权限，否则组件无法保存配置。解决方法：

sudo chown -R 1000:1000 ~/.jitsi-meet-cfg sudo chmod -R 755 ~/.jitsi-meet-cfg

权限问题通常表现为以下症状：

4. 证书配置陷阱：自签名与Let's Encrypt

HTTPS是Jitsi正常工作的必要条件，但证书配置常出问题：

自签名证书方案：

1. 生成证书：

   openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes

2. 将证书放入正确位置：

   cp cert.pem ~/.jitsi-meet-cfg/web/nginx.crt cp key.pem ~/.jitsi-meet-cfg/web/nginx.key

Let's Encrypt方案：

1. 修改.env：

   ENABLE_LETSENCRYPT=1 LETSENCRYPT_DOMAIN=meet.yourdomain.com LETSENCRYPT_EMAIL=admin@yourdomain.com

2. 确保域名解析已生效且80端口可访问

提示：使用Let's Encrypt时，首次启动可能需要较长时间（最多5分钟）来获取证书。

5. 服务器公网IP与域名解析设置不当

错误的网络配置会导致ICE协商失败，表现为音视频无法连接：

1. NAT环境特殊配置： 在.env中添加：

   JVB_ADVERTISE_IPS=your.public.ip DOCKER_HOST_ADDRESS=your.local.ip

2. STUN服务器配置： 编辑~/.jitsi-meet-cfg/web/config.js：

   config.hosts.anonunce = ['your.public.ip']; config.iceServers = [{ urls: 'stun:stun.l.google.com:19302' }];

3. DNS检查：

   dig +short meet.yourdomain.com nslookup meet.yourdomain.com

   确保解析结果与服务器公网IP一致

6. 性能优化与高级排错技巧

当基本功能正常后，你可能还需要关注性能问题：

日志查看命令：

docker-compose logs -f jvb # 查看Jitsi Videobridge日志 docker-compose logs -f prosody # 查看XMPP服务器日志

性能调优参数： 在.env中添加：

# 限制视频分辨率 VIDEOQUALITY_MAXRECVPIXELS=921600 # 720p # JVB内存限制 JVB_XMPP_USER=jvb JVB_XMPP_PASSWORD=yourpassword JVB_XMPP_PORT=5347 JVB_STUN_SERVERS=stun.l.google.com:19302

网络质量检测工具：

sudo apt install iperf3 iperf3 -s # 在服务器端运行 iperf3 -c your.server.ip # 在客户端运行

遇到复杂问题时，可以尝试逐步启动服务定位问题：

docker-compose up prosody # 先单独启动XMPP服务器 docker-compose up jicofo # 然后启动会议焦点组件 docker-compose up jvb # 最后启动视频桥接服务