
tgrl/excalidraw-backend本Docker镜像为Jitsi Meet开源视频会议系统提供白板协作功能扩展,旨在增强实时视频会议中的可视化协作能力。通过集成该镜像,用户可在Jitsi Meet会议中启动共享白板,支持多参与者同时进行绘图、标注、文本输入等操作,内容实时同步,适用于远程教学、团队协作、在线培训等场景。
bashdocker network create jitsi-network
bashdocker 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_DOMAIN | 必选 | Jitsi Meet服务域名,用于与会议系统建立通信 | 无 |
| WHITEBOARD_SECRET | 必选 | 与Jitsi Meet集成的安全密钥,需与Jitsi配置文件中的密钥保持一致 | 无 |
| PORT | 可选 | 白板服务内部监听端口 | 8080 |
| PERSISTENCE_ENABLED | 可选 | 是否启用白板内容持久化(true:启用,false:禁用) | false |
| PERSISTENCE_PATH | 可选 | 持久化文件存储路径(启用持久化时生效) | /data |
| MAX_USERS | 可选 | 单白板最大并发用户数限制 | 50 |
| CORS_ALLOWED_ORIGINS | 可选 | 允许跨域访问的源(格式:"[***]") | JITSI_DOMAIN |
在Jitsi Meet的配置目录(通常为/path/to/jitsi-meet/config.js)中添加以下配置:
javascriptconfig.whiteboard = { enabled: true, url: "[***]", // 容器名称:端口(基于Docker网络)或宿主机IP:端口 secret: "your_secure_secret" // 与容器中WHITEBOARD_SECRET一致的密钥 };
使配置生效:
bash# 若使用Docker Compose部署Jitsi docker-compose -f /path/to/jitsi-meet/docker-compose.yml restart web
PERSISTENCE_PATH路径获取历史白板文件WHITEBOARD_SECRET建议使用随机复杂字符串,避免明文传输或硬编码PERSISTENCE_PATH,防止容器重建导致数据丢失:
bashdocker run -d \ ... \ -v jitsi-whiteboard-data:/data \ # 创建命名卷挂载持久化路径 ...

manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务