bigbluebutton/greenlight

Greenlight Docker镜像文档

概述和主要用途

Greenlight 是为 BigBlueButton（开源 Web 会议系统）设计的轻量级前端应用程序。它通过直观的用户界面简化了 BigBlueButton 会议的创建、管理和访问流程，使用户无需直接操作底层 API 即可高效使用视频会议功能，支持教育、企业和组织等场景的远程协作需求。

核心功能和特性

• 简化会议管理：提供可视化界面创建、编辑和删除会议，支持设置访问密码、会议时长等参数
• 一键加入会议：生成会议链接，支持注册用户和访客快速加入，无需复杂操作
• 多认证支持：兼容本地账号、OAuth、LDAP 等多种认证方式，适配不同组织的身份管理体系
• 响应式设计：自动适配桌面端和移动端，确保在手机、平板等设备上的良好体验
• 会议记录追踪：显示历史会议列表，记录会议时间、参与人数等关键信息
• 权限控制：支持管理员角色，可配置用户权限、会议可见性等系统参数

使用场景和适用范围

• 教育场景：学校或培训机构用于在线课程、远程教学、师生互动研讨
• 企业协作：团队日常会议、跨部门沟通、客户远程演示等商务场景
• 组织活动：非营利组织举办线上研讨会、志愿者培训、社区分享会
• 个人使用：创建临时会议与他人进行视频沟通，支持小规模协作需求

使用方法和配置说明

前置条件

• 已部署 BigBlueButton 服务器（推荐版本 2.2+），并获取 API 访问地址和密钥
• 安装 Docker 和 Docker Compose 环境
• 确保网络环境可访问 BigBlueButton 服务器的 API 端点

Docker 部署示例

1. 快速启动（单容器模式）

bash
docker run -d \
  --name greenlight \
  -p 80:80 \
  -e BIGBLUEBUTTON_URL=https://your-bbb-server.com/bigbluebutton/ \
  -e BIGBLUEBUTTON_SECRET=your-bbb-api-secret \
  -e DATABASE_URL=postgres://user:password@db-host:5432/greenlight \
  bigbluebutton/greenlight:v3

2. Docker Compose 部署（推荐生产环境）

创建 docker-compose.yml 文件：

yaml
version: '3'

services:
  greenlight:
    image: bigbluebutton/greenlight:v3
    container_name: greenlight
    ports:
      - "80:80"
    environment:
      - BIGBLUEBUTTON_URL=https://your-bbb-server.com/bigbluebutton/
      - BIGBLUEBUTTON_SECRET=your-bbb-api-secret
      - DATABASE_URL=postgres://postgres:password@db:5432/greenlight
      - SECRET_KEY_BASE=$(openssl rand -hex 64)
      - PORT=80
      - AUTH_METHOD=local
    depends_on:
      - db
    restart: unless-stopped

  db:
    image: postgres:13-alpine
    container_name: greenlight-db
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=password
      - POSTGRES_DB=greenlight
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:

启动服务：

bash
# 生成随机密钥并启动
SECRET_KEY_BASE=$(openssl rand -hex 64) docker-compose up -d

核心配置参数（环境变量）

访问与初始化

部署完成后，通过浏览器访问服务器 IP 或域名（默认端口 80）。首次登录需创建管理员账号，之后可通过管理员界面配置系统参数（如用户权限、认证方式、品牌定制等）。

注意：生产环境建议配置 HTTPS（可通过 Nginx 反向代理实现），并定期更新镜像以获取安全补丁。