bigbluebutton/bbb-playback-proxy

bbb-playback-proxy

镜像概述

BigBlueButton会记录会话期间生成的所有事件和媒体数据用于后续回放。其录制流程包含捕获、归档、验证、处理、发布和回放六个阶段，最终生成的媒体文件默认存储在BigBlueButton服务器的文件系统中，由服务器内置的Nginx作为静态内容提供访问。

但在部分场景下（如本地文件系统存储容量不足、集群环境中多服务器录制内容需聚合），需要独立的服务来存储和提供录制内容。bbb-playback-proxy Docker镜像即为此设计，作为专注于提供录制内容访问的代理服务。

核心功能与特性

架构

基于Linux系统（alpine或amazonlinux）构建，内置Nginx，包含与BigBlueButton服务器完全一致的Nginx配置文件、媒体播放器及目录结构，可无缝对接录制内容存储。

端口

仅对外暴露80端口，用于提供HTTP服务。

使用场景

• 本地文件系统无法满足录制内容存储需求时
• 集群部署的BigBlueButton服务器需聚合录制内容时
• 需要独立管理录制内容访问权限或优化访问性能时

使用方法

docker run示例

bash
docker run -d -p 80:80 -v /mnt/scalelite-recordings/var/bigbluebutton/:/var/bigbluebutton/ bigbluebutton/bbb-playback-proxy:bionic-23-dev-alpine3.11

参数说明：

• -v /mnt/scalelite-recordings/var/bigbluebutton/:/var/bigbluebutton/：将本地录制内容目录挂载至容器内对应路径，需确保目录结构与BigBlueButton服务器一致

docker-compose示例

yaml
version: '3'
services:
  frontend-proxy:
    image: nginx:latest
    container_name: frontend-proxy
    restart: unless-stopped
    volumes:
      - ./proxy/log/nginx/:/var/log/nginx
      - ./proxy/nginx/sites.template.${DOCKER_PROXY_NGINX_TEMPLATE:-scalelite-proxy}:/etc/nginx/sites.template
      - ./data/certbot/conf/:/etc/letsencrypt
      - ./data/certbot/www/:/var/www/certbot
    ports:
      - "80:80"
      - "443:443"
    environment:
      - NGINX_HOSTNAME=${URL_HOST:-xlab.blindside-dev.com}
    depends_on:
      - certbot
      - recording-proxy
    command: /bin/bash -c "envsubst '$NGINX_HOSTNAME' < /etc/nginx/sites.template > /etc/nginx/conf.d/default.conf && exec nginx -g 'daemon off;'"

  recording-proxy:
    image: bigbluebutton/bbb-playback-proxy:bionic-23-dev-alpine3.11
    container_name: recording-proxy
    restart: unless-stopped
    volumes:
      - /mnt/recordings/var/bigbluebutton/published:/var/bigbluebutton/published

  certbot:
    image: certbot/certbot
    container_name: certbot
    volumes:
      - ./log/certbot:/var/log/letsencrypt
      - ./data/certbot/conf:/etc/letsencrypt
      - ./data/certbot/www:/var/www/certbot
    entrypoint: "/bin/sh -c 'trap exit TERM; while :; do certbot renew; sleep 12h & wait ${!}; done;'"

配置说明

• 挂载录制内容目录：通过-v参数将存储录制内容的目录（如/mnt/scalelite-recordings/var/bigbluebutton/）挂载至容器内的/var/bigbluebutton/路径，确保目录结构与BigBlueButton服务器一致（包含published等子目录）。
• 端口映射：通过-p 80:80将容器80端口映射至主机，提供HTTP访问。