tgrl/excalidraw-backend

Jitsi Meet白板支持镜像

镜像概述

本Docker镜像为Jitsi Meet开源视频会议系统提供白板协作功能扩展，旨在增强实时视频会议中的可视化协作能力。通过集成该镜像，用户可在Jitsi Meet会议中启动共享白板，支持多参与者同时进行绘图、标注、文本输入等操作，内容实时同步，适用于远程教学、团队协作、在线培训等场景。

核心功能与特性

实时协作能力

• 支持多用户同时操作白板，所有参与者的操作实时同步至其他用户界面
• 低延迟数据同步，确保多人协作时的流畅体验

丰富绘图工具集

• 基础绘图工具：画笔（可调粗细/颜色）、橡皮擦、直线、箭头、矩形、圆形等基础图形
• 文本工具：支持多字体、字号文本输入，支持文本框编辑
• 辅助功能：撤销/重做、清空白板、缩放/平移白板视图

Jitsi Meet无缝集成

• 与Jitsi Meet会议系统深度整合，可直接从会议界面启动/关闭白板
• 支持白板权限控制（如仅主持人可编辑，其他参与者只读）
• 保持Jitsi Meet原有用户认证体系，无需额外登录

数据管理

• 可选白板内容持久化：支持将会议中的白板内容保存为图片或JSON格式
• 历史记录回溯：可查看白板操作历史，支持回溯至特定时间点的状态

使用场景与适用范围

在线教学与培训

• 教师可在白板上实时讲解知识点、绘制图表，学生可标注疑问或补充内容
• 适用于K12教育、职业培训、学术讲座等场景

团队协作会议

• 团队讨论时实时绘制流程图、思维导图、项目规划图
• 远程团队脑暴会议中，收集并可视化团队想法

设计与评审

• 设计师共享设计稿后，团队成员可直接在白板上标注修改建议
• 产品原型评审时，实时标记界面元素问题与优化点

使用方法与配置说明

前提条件

• 已部署Jitsi Meet服务（建议使用官方Docker部署方案）
• Docker环境版本≥19.03，Docker Compose（可选）版本≥2.0
• 确保Jitsi Meet服务与白板容器处于同一网络环境（或可通过网络互通）

快速启动（docker run）

1. 创建专用网络（若Jitsi服务未使用现有网络）

bash
docker network create jitsi-network

2. 启动白板容器

bash
docker run -d \
  --name jitsi-whiteboard \
  --network jitsi-network \
  -p 8080:8080 \
  -e JITSI_DOMAIN="meet.example.com" \  # 替换为你的Jitsi Meet域名
  -e WHITEBOARD_SECRET="your_secure_secret" \  # 自定义安全密钥，需与Jitsi配置一致
  -e PORT=8080 \  # 白板服务监听端口
  -e PERSISTENCE_ENABLED="false" \  # 是否启用内容持久化（true/false）
  [镜像名称]:[标签]  # 替换为实际镜像名称与标签

环境变量配置说明

Jitsi Meet集成配置

1. 修改Jitsi Meet配置文件

在Jitsi Meet的配置目录（通常为/path/to/jitsi-meet/config.js）中添加以下配置：

javascript
config.whiteboard = {
  enabled: true,
  url: "http://jitsi-whiteboard:8080",  // 容器名称:端口（基于Docker网络）或宿主机IP:端口
  secret: "your_secure_secret"  // 与容器中WHITEBOARD_SECRET一致的密钥
};

2. 重启Jitsi Meet服务

使配置生效：

bash
# 若使用Docker Compose部署Jitsi
docker-compose -f /path/to/jitsi-meet/docker-compose.yml restart web

白板使用流程

1. 发起或加入Jitsi Meet会议
2. 在会议控制栏中点击「白板」按钮（通常位于「共享屏幕」按钮附近）
3. 首次使用需授权白板访问权限，授权后自动加载白板界面
4. 使用左侧工具栏选择绘图工具，开始协作操作
5. 会议结束后，若启用持久化，可通过容器内PERSISTENCE_PATH路径获取历史白板文件

注意事项

• 网络配置：确保Jitsi Meet服务容器与白板容器在同一Docker网络，或通过端口映射实现跨网络通信
• 安全密钥：WHITEBOARD_SECRET建议使用随机复杂字符串，避免明文传输或硬编码
• 持久化数据：启用持久化时，建议通过Docker卷（Volume）挂载PERSISTENCE_PATH，防止容器重建导致数据丢失：

  bash
  docker run -d \
    ... \
    -v jitsi-whiteboard-data:/data \  # 创建命名卷挂载持久化路径
    ...
  

• 性能优化：单白板并发用户超过30人时，建议调整服务器资源（CPU/内存）以保障流畅性