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

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

2025-06-25 22:15:41作者:申梦珏Efrain

背景介绍

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 服务,为用户提供高质量的视频会议体验。

登录后查看全文
热门项目推荐
相关项目推荐