Docker-Jitsi-Meet 在 Plesk 服务器上通过 NGINX 反向代理的配置实践

背景介绍

Jitsi 是一个开源的视频会议解决方案，而 docker-jitsi-meet 项目提供了基于 Docker 的部署方式。本文将详细介绍在 Plesk 服务器环境中，通过 NGINX 反向代理配置 Jitsi 服务的完整过程及常见问题解决方案。

核心配置要点

端口规划

在 Plesk 环境中部署时，需要注意以下端口配置：

1. 避免使用 Plesk 默认占用的端口（如 8080、8443）
2. 建议将 JVB Colibri 端口从默认的 8080 改为 8085
3. HTTP 端口设置为 8000
4. HTTPS 端口设置为 8448

环境变量配置

关键的 .env 文件配置应包括：

HTTP_PORT=8000
HTTPS_PORT=8448
PUBLIC_URL=https://meet.example.com
DISABLE_HTTPS=1
ENABLE_HTTP_REDIRECT=0
ENABLE_LETSENCRYPT=0

特别注意：当使用反向代理时，PUBLIC_URL 中不应包含端口号，否则会导致 WebSocket 连接失败。

NGINX 反向代理配置

正确的 NGINX 配置应包含三个关键部分：

主请求代理

location / {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
}

WebSocket 代理

location /xmpp-websocket {
    proxy_pass http://127.0.0.1:8448/xmpp-websocket;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Colibri 状态代理

location /colibri {
    proxy_pass http://127.0.0.1:8085;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

常见问题及解决方案

WebSocket 连接失败

症状：控制台出现 "WebSocket connection to 'wss://meet.example.com:8448/xmpp-websocket' failed" 错误。

解决方案：

1. 确保 PUBLIC_URL 中不包含端口号
2. 检查 NGINX 的 WebSocket 代理配置是否正确
3. 验证防火墙是否放行了相关端口

JVB 服务连接问题

症状：日志中出现 "Connection refused" 或 "Cannot set presence extension: not connected" 错误。

解决方案：

1. 检查 JVB 容器的端口映射是否正确
2. 确认内部服务发现是否正常工作
3. 验证 XMPP 服务是否正常启动

最佳实践建议

1. 在 Plesk 环境中，建议完全禁用容器内的 HTTPS 功能，由 Plesk 统一管理 SSL 证书
2. 对于生产环境，应考虑配置适当的重试机制和健康检查
3. 定期检查容器日志，及时发现潜在问题
4. 考虑配置资源限制，防止单个会议占用过多服务器资源

通过以上配置和注意事项，可以在 Plesk 服务器上稳定运行基于 Docker 的 Jitsi Meet 服务，为用户提供高质量的视频会议体验。