Docker Jitsi Meet 录制功能配置问题分析与解决方案

2025-06-25 23:44:36作者：咎竹峻Karen

问题背景

在使用Docker部署Jitsi Meet视频会议系统时，用户遇到了录制功能无法正常工作的问题。具体表现为：

录制文件无法保存到指定目录
Safari浏览器中看不到录制选项
S3存储集成失败

核心问题分析

1. 录制功能未启用

检查配置文件发现缺少关键参数ENABLE_RECORDING=1，这是启用Jitsi录制功能的必要条件。没有此参数，系统不会加载录制相关组件。

2. 浏览器兼容性问题

Safari浏览器不显示录制选项是因为：

Jitsi的原生录制功能主要针对Chrome浏览器设计
Safari需要额外的配置才能支持录制功能
服务端录制(Jibri)需要在所有浏览器中单独配置

3. 存储配置问题

S3存储集成失败可能原因：

脚本权限问题：上传脚本可能没有执行权限
环境变量传递问题：AWS凭证可能未正确传递到容器
路径配置错误：录制目录与脚本预期路径不匹配

解决方案

1. 完整启用录制功能

在环境变量中添加以下关键配置：

ENABLE_RECORDING=1
ENABLE_LOCAL_RECORDING=1
JIBRI_RECORDING_DIR=/config/recordings

2. 浏览器兼容性处理

对于Safari用户：

明确告知需要使用Chrome进行本地录制
或者配置服务端录制(Jibri)作为替代方案
考虑使用Polyfill或转码方案增强兼容性

3. S3存储集成优化

改进上传脚本：

#!/bin/bash
set -e

RECORDING_DIR="${1:-/config/recordings}"
S3_BUCKET="${AWS_S3_BUCKET}"
TIMESTAMP=$(date +"%Y%m%d-%H%M%S")

# 确保AWS CLI可用
command -v aws >/dev/null 2>&1 || {
    apt-get update && apt-get install -y awscli
}

# 处理录制文件
find "${RECORDING_DIR}" -type f \( -name "*.mp4" -o -name "*.webm" \) | while read file; do
    MEETING_ID=$(basename "${file}" | cut -d'_' -f1)
    aws s3 cp "${file}" "s3://${S3_BUCKET}/recordings/${MEETING_ID}/${TIMESTAMP}/"
    rm -f "${file}"
done

4. 完整配置建议

在docker-compose.yml中确保包含：

services:
  jibri:
    environment:
      - ENABLE_RECORDING=1
      - JIBRI_RECORDING_DIR=/config/recordings
      - FINALIZE_RECORDING_SCRIPT_PATH=/config/scripts/upload-to-s3.sh
    volumes:
      - ./recordings:/config/recordings
      - ./scripts:/config/scripts