Docker-Jitsi-Meet 中 Jibri 录制服务配置问题解析

问题背景

在使用 Docker-Jitsi-Meet 搭建视频会议系统时，用户遇到了 Jibri 录制服务无法正常工作的问题。具体表现为当尝试通过 API 触发录制时，Jibri 无法成功加入会议，控制台显示错误信息："Cannot read properties of undefined (reading 'isJoined')"。

错误现象分析

从日志中可以观察到几个关键现象：

1. Jibri 尝试访问会议页面时，反复出现 "Not joined yet" 错误
2. 最终因超时而失败，状态变为 "FailedToJoinCall"
3. 在 Prosody 日志中可以看到 Jibri 连接后立即断开
4. 错误直接指向 JavaScript 中无法读取 isJoined 属性

根本原因

经过深入分析，发现问题源于配置中的域名设置不当。具体来说：

1. 用户配置了 XMPP_RECORDER_DOMAIN=recorder.meet.jitsi
2. 实际上该项目已将此配置项重命名为 XMPP_HIDDEN_DOMAIN
3. 默认值也从 recorder.meet.jitsi 更改为 hidden.meet.jitsi
4. API 调用中仍使用旧的域名配置，导致 XMPP 连接失败

解决方案

要解决此问题，需要进行以下配置调整：

1. 移除或更新 XMPP_RECORDER_DOMAIN 配置：

   • 完全移除该配置项，使用默认值
   • 或者使用新的配置项名称：XMPP_HIDDEN_DOMAIN

2. 确保 API 调用中的域名配置：

   • 更新 API 调用参数中的 domain 值
   • 确保与 Jibri 配置中的域名一致

3. 完整配置检查：

   • 验证 Jibri 用户名和密码在所有配置文件中一致
   • 确认 PUBLIC_URL 设置正确
   • 检查网络连接和端口开放情况

配置最佳实践

为避免类似问题，建议遵循以下 Jibri 配置原则：

1. 使用最新配置项名称：

   • 定期查阅项目文档，了解配置变更
   • 避免使用已弃用的配置项

2. 保持配置一致性：

   • 确保 Jibri 容器和主 Jitsi 容器的相关配置匹配
   • 特别注意认证信息的同步

3. 日志监控：

   • 关注 Jibri 和 Prosody 的日志输出
   • 特别留意连接建立和认证相关的日志条目

技术原理深入

Jibri 录制服务的工作流程大致如下：

1. 通过 XMPP 协议与 Jitsi 系统建立连接
2. 使用特殊用户身份加入会议
3. 通过浏览器实例捕获会议内容
4. 将捕获内容保存为文件或流

在此过程中，域名配置错误会导致 XMPP 连接无法正确建立，进而使浏览器实例无法加入会议，最终表现为录制失败。

总结

Docker-Jitsi-Meet 项目中的配置变更可能会影响 Jibri 录制服务的正常工作。遇到类似问题时，开发者应该：

1. 仔细检查所有相关配置项
2. 确认使用的是最新的配置项名称和默认值
3. 确保各组件间的配置一致性
4. 通过日志分析定位问题根源

通过正确的配置和系统理解，可以确保 Jibri 录制服务稳定可靠地工作，为视频会议提供完整的录制功能。