ExoPlatform Jitsi Docker 镜像文档

一、镜像概述和主要用途

ExoPlatform Jitsi Docker 镜像是由 ExoPlatform 提供的开源视频会议解决方案容器化封装，基于 Jitsi 生态系统构建。该镜像旨在简化 Jitsi 视频会议系统的部署流程，整合了 Jitsi Meet（Web 会议前端）、Jitsi Video Bridge（媒体服务器）、Jicofo（会议焦点控制器）及 Prosody（XMPP 服务器）等核心组件，并可能包含与 ExoPlatform 协作平台的集成能力。

主要用途：快速部署企业级实时音视频会议系统，支持多用户在线协作、远程会议、在线教育等场景，提供开箱即用的 WebRTC 音视频通信能力。

二、核心功能和特性

2.1 基础音视频功能

• WebRTC 标准支持：基于 WebRTC 协议，实现浏览器端无插件音视频通信。
• 多用户会议：支持数十人同时参与的视频会议（取决于服务器资源）。
• 实时互动功能：屏幕共享、应用窗口共享、白板协作、实时文字聊天。
• 媒体控制：支持麦克风/摄像头开关、音量调节、视频质量自适应。

2.2 安全与隐私

• 端到端加密（E2EE）：支持会议内容端到端加密，保障通信隐私。
• 会议权限控制：支持密码保护、主持人权限（禁言、踢出用户等）。
• ***参会：支持无需注册即可加入会议（可配置是否开启）。

2.3 部署与集成特性

• 简化部署：容器化封装，减少依赖配置，支持单节点或集群部署。
• ExoPlatform 集成：可选与 ExoPlatform 协作平台联动，实现会议与文档、任务管理的无缝衔接。
• 配置持久化：支持外部卷挂载，保存自定义配置、证书及会议数据。
• 跨平台兼容：支持 Linux/macOS/Windows 系统 Docker 环境运行。

三、使用场景和适用范围

3.1 企业协作场景

• 远程团队日常同步会议、项目复盘会。
• 跨部门协作沟通，支持屏幕共享与文档协作。

3.2 在线教育场景

• 小班直播课（师生音视频互动、屏幕共享课件）。
• 一对一辅导、小组讨论室（多会议室隔离）。

3.3 外部沟通场景

• 客户演示会议（共享应用窗口展示产品）。
• 行业研讨会（支持百人级观众模式，主持人控制发言）。

四、使用方法和配置说明

4.1 环境要求

• Docker Engine ≥ 20.10.x
• Docker Compose ≥ 2.0（如需多服务部署）
• 服务器资源：2核4G以上（支持10人以内会议），带宽≥10Mbps上行/下行。

4.2 快速启动（单节点部署）

4.2.1 直接运行（测试环境）

docker run -d \
  --name exo-jitsi \
  -p 80:80 \
  -p 443:443 \
  -p 4443:4443 \
  -e PUBLIC_URL="[***]" \
  -e TZ="Asia/Shanghai" \
  -v jitsi-config:/config \
  exoplatform/jitsi:latest

说明：

• -p 80:80：HTTP端口映射（建议生产环境启用HTTPS，通过443端口）。
• -p 443:443：HTTPS端口（需提前准备SSL证书，或通过环境变量配置自动生成）。
• -v jitsi-config:/config：持久化配置文件（证书、用户数据等）。

4.2.2 Docker Compose 部署（生产环境推荐）

创建 docker-compose.yml 文件：

version: '3.8'

services:
  jitsi:
    image: exoplatform/jitsi:latest
    container_name: exo-jitsi
    restart: unless-stopped
    ports:
      - "80:80"       # HTTP（可重定向到HTTPS）
      - "443:443"     # HTTPS
      - "4443:4443"   # JVBWebSocket端口
      - "***:***/udp"  # JVB媒体流端口（UDP）
    environment:
      - PUBLIC_URL=[***]  # 对外访问URL（必填）
      - TZ=Asia/Shanghai                    # 时区
      - JICOFO_AUTH_USER=jicofo_user        # Jicofo认证用户名
      - JICOFO_AUTH_PASSWORD=secure_password # Jicofo认证密码（建议随机生成）
      - JVB_AUTH_USER=jvb_user              # JVB认证用户名
      - JVB_AUTH_PASSWORD=another_secure_pw # JVB认证密码
      - ENABLE_HTTPS=1                      # 启用HTTPS（1=启用，0=禁用）
      - CERTIFICATE_TYPE=letsencrypt        # 证书类型（letsencrypt/selfsigned/custom）
      - LETSENCRYPT_DOMAIN=meet.example.com # Let's Encrypt域名（当CERTIFICATE_TYPE=letsencrypt时必填）
      - LETSENCRYPT_EMAIL=*** # Let's Encrypt联系人***
    volumes:
      - jitsi-config:/config                # 配置文件持久化
      - jitsi-logs:/var/log/jitsi           # 日志持久化
      - jitsi-certbot:/etc/letsencrypt      # Let's Encrypt证书（如使用）

volumes:
  jitsi-config:
  jitsi-logs:
  jitsi-certbot:

启动服务：

docker-compose up -d

4.3 核心环境变量说明

4.4 持久化配置

容器内核心配置路径：

• /config：存放全局配置（jitsi-config卷挂载点）。
• /etc/letsencrypt：Let's Encrypt证书（jitsi-certbot卷挂载点，当CERTIFICATE_TYPE=letsencrypt时）。

自定义配置示例（修改会议欢迎消息）：

1. 进入容器：docker exec -it exo-jitsi bash
2. 编辑配置文件：vi /config/web/interface_config.js
3. 修改 WELCOME_PAGE_ENABLED: true 及 WELCOME_PAGE_URL: '/welcome'

4.5 访问与验证

部署完成后，通过 PUBLIC_URL 访问会议系统（如 [***]），创建会议房间（输入房间名称），邀请参与者加入，验证音视频、屏幕共享功能是否正常。

五、常见问题与故障排查

• 端口冲突：确保宿主机80/443/***等端口未被占用，可通过 netstat -tulpn 检查。
• 证书问题：使用自签证书时浏览器会提示不安全，生产环境建议配置 CERTIFICATE_TYPE=letsencrypt 并确保域名解析正确。
• 媒体流卡顿：检查服务器带宽（建议上行≥2Mbps/参会人），或调整JVB视频质量（修改 /config/jvb/sip-communicator.properties 中的 org.jitsi.videobridge.rtcp.reduceEncryptionOverhead=true）。

如需更多配置细节，可参考 ExoPlatform ***文档或 Jitsi 社区文档。