避坑指南：在Linux服务器上部署Docker版Jitsi Meet时，你可能遇到的5个典型问题及解决
避坑指南：在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容器内部运行正常，错误的宿主机网络配置也会导致外部无法访问。排查步骤：
检查防火墙规则：
sudo ufw status # Ubuntu sudo firewall-cmd --list-all # CentOS确保以下端口开放：
- 80/tcp (HTTP)
- 443/tcp (HTTPS)
- 10000/udp (媒体传输)
SELinux问题：
sudo setenforce 0 # 临时关闭 sudo getenforce # 检查状态如需永久禁用，编辑
/etc/selinux/config设置SELINUX=disabledDocker网络模式： 确保
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权限问题通常表现为以下症状：
| 症状 | 可能原因 | 解决方案 |
|---|---|---|
| Prosody无法启动 | 无法写入证书 | 检查prosody/config目录权限 |
| Jicofo日志报错 | 无法创建配置文件 | 检查jicofo目录权限 |
| 无法录制会议 | 无法写入转录文件 | 检查transcripts目录权限 |
4. 证书配置陷阱：自签名与Let's Encrypt
HTTPS是Jitsi正常工作的必要条件，但证书配置常出问题：
自签名证书方案：
- 生成证书：
openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes - 将证书放入正确位置：
cp cert.pem ~/.jitsi-meet-cfg/web/nginx.crt cp key.pem ~/.jitsi-meet-cfg/web/nginx.key
Let's Encrypt方案：
- 修改
.env：ENABLE_LETSENCRYPT=1 LETSENCRYPT_DOMAIN=meet.yourdomain.com LETSENCRYPT_EMAIL=admin@yourdomain.com - 确保域名解析已生效且80端口可访问
提示：使用Let's Encrypt时，首次启动可能需要较长时间（最多5分钟）来获取证书。
5. 服务器公网IP与域名解析设置不当
错误的网络配置会导致ICE协商失败，表现为音视频无法连接：
NAT环境特殊配置： 在
.env中添加：JVB_ADVERTISE_IPS=your.public.ip DOCKER_HOST_ADDRESS=your.local.ipSTUN服务器配置： 编辑
~/.jitsi-meet-cfg/web/config.js：config.hosts.anonunce = ['your.public.ip']; config.iceServers = [{ urls: 'stun:stun.l.google.com:19302' }];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 # 最后启动视频桥接服务