jfederico/scalelite

Scalelite

https://docs.bigbluebutton.org/ 是一款用于在线学习的开源网络会议系统。Scalelite 是一款开源负载均衡器，用于管理 BigBlueButton 服务器池，使服务器池呈现为单个（高可扩展的）BigBlueButton 服务器。前端系统（如 https://moodle.org/plugins/mod_bigbluebuttonbn 或 https://github.com/bigbluebutton/greenlight%EF%BC%89%E5%90%91 Scalelite 服务器发送标准 BigBlueButton API 请求，Scalelite 再将这些请求分发到服务器池中负载最低的 BigBlueButton 服务器。

单个满足 http://docs.bigbluebutton.org/2.2/install.html#minimum-server-requirements 的 BigBlueButton 服务器支持约 200 名并发用户。对于许多学校和组织，支持 4 个同时进行的 50 人班级或 8 个同时进行的 25 人会议可能已足够。但如果学校需要支持 50 个同时进行的班级共 1500 名用户，单台服务器无法承担此负载。通过 Scalelite，学校可创建包含 4 台 BigBlueButton 服务器的池，支持 16 个同时进行的 50 人班级；如需更高容量，只需向池中添加更多服务器。

概述与主要用途

Scalelite 旨在解决单台 BigBlueButton 服务器的并发用户限制问题，通过负载均衡技术将请求分发到多台 BigBlueButton 服务器，实现横向扩展。其核心价值在于：

• 将多台 BigBlueButton 服务器抽象为单个服务端点，简化前端集成
• 自动将新会议分配到负载最低的服务器，优化资源利用率
• 支持录制文件集中管理，通过数据库索引快速检索
• 允许通过添加服务器节点线性扩展系统容量

核心功能与特性

负载均衡

• 定期轮询服务器池中的 BigBlueButton 服务器，检查在线状态、API 可用性及当前负载（运行中的会议数量）
• 创建新会议时，自动选择负载最低的服务器，实现负载均匀分布

可扩展性

• 支持动态扩展：通过向服务器池添加 BigBlueButton 服务器提升整体容量，无需修改前端配置
• 负载乘数（loadMultiplier）机制：可针对不同性能的服务器设置权重，实现精细化负载分配

录制管理

• 集中存储和索引所有服务器的录制文件
• 通过数据库索引加速 getRecordings API 请求，快速返回可用录制列表

服务器监控与管理

• 实时监控服务器在线状态、负载情况及会议信息
• 支持服务器启用/禁用、隔离（cordon）等管理操作，便于维护升级

使用场景与适用范围

Scalelite 适用于以下场景：

• 学校或培训机构需要支持数百至数千名并发用户（如 500+ 并发用户）
• 组织需同时运行多个会议/班级，且总用户数超过单台 BigBlueButton 服务器容量
• 需要高可用性部署，避免单台服务器故障导致服务中断
• 计划逐步扩展在线会议服务容量的场景

架构与最低要求

核心组件

Scalelite 部署需以下组件：

1. 多台 BigBlueButton 服务器
2. Scalelite 负载均衡服务器
3. NFS 共享存储卷（用于录制文件）
4. PostgreSQL 数据库（用于录制索引）
5. Redis 缓存（用于服务器状态和会议信息）

最低服务器要求

BigBlueButton 服务器

每台服务器需满足 http://docs.bigbluebutton.org/2.2/install.html#minimum-server-requirements%EF%BC%8C%E5%BB%BA%E8%AE%AE%E8%87%B3%E5%B0%91%E9%83%A8%E7%BD%B2 3 台以确保高可用性。

Scalelite 负载均衡服务器

• 4 CPU 核心
• 8 GB 内存

PostgreSQL 数据库

• 2 CPU 核心
• 2 GB 内存
• 20 GB 磁盘空间（可支持数万个录制文件）

Redis 缓存

• 2 CPU 核心
• 0.5 GB 内存
• 必须启用持久化

部署步骤

1. 部署 BigBlueButton 服务器池

推荐使用 https://github.com/bigbluebutton/bbb-install 自动化部署，该脚本可自动完成安装、SSL 配置（Let's Encrypt）及版本更新。每台服务器需配置 TURN 服务器以优化防火墙后的媒体传输（音频、视频、屏幕共享）。

2. 配置录制文件共享存储卷

需设置 NFS 共享存储卷，用于集中存储所有 BigBlueButton 服务器的录制文件。详细步骤参见 Setting up a shared volume for recordings。

3. 部署 PostgreSQL 数据库

根据基础设施环境选择合适的部署方式（自建或云服务），确保 DATABASE_URL 环境变量配置正确（格式：postgresql://username:password@connection_url）。

4. 部署 Redis 缓存

配置 Redis 服务器并启用持久化，确保 REDIS_URL 环境变量正确（格式：redis://username:password@connection_url）。

5. 部署 Scalelite Docker 容器

详细部署步骤参见 Deploying Scalelite Docker Containers，核心为配置环境变量并启动容器。

6. 配置前端系统

将前端系统（如 Moodle、Greenlight）的 BigBlueButton 配置修改为：

• 服务器 URL：http(s)://<scalelite-hostname>/bigbluebutton/api/
• 共享密钥：Scalelite 的 LOADBALANCER_SECRET 值

配置说明

环境变量

必需变量

Docker 专用变量

可选变量

包括端口配置（PORT、BIND）、轮询间隔（INTERVAL）、Rails 进程/线程数（WEB_CONCURRENCY、RAILS_MAX_THREADS）、会议时长限制（MAX_MEETING_DURATION）、录制文件路径（RECORDING_SPOOL_DIR 等）、服务器健康阈值（SERVER_HEALTHY_THRESHOLD、SERVER_UNHEALTHY_THRESHOLD）等，详细说明见官方文档。

Redis 连接配置（config/redis_store.yml）

Docker 部署建议通过 REDIS_URL 环境变量配置，非 Docker 部署可通过该文件设置每个环境的 Redis 参数，包括连接池大小（pool）、超时时间（pool_timeout）、命名空间（namespace）等。

管理命令

所有管理命令通过 rake 任务执行，Docker 部署需先进入容器（如 docker exec -it scalelite-api /bin/sh）。

服务器管理

查看服务器详情

sh
./bin/rake servers

输出包括服务器 ID、URL、密钥、状态（启用/禁用）、负载、在线状态等。

添加服务器

sh
./bin/rake servers:add[url,secret,loadMultiplier]

• url：BigBlueButton 服务器 API 完整 URL（需包含 /api）
• secret：服务器 API 密钥（通过 bbb-conf --secret 获取）
• loadMultiplier：负载乘数（可选，默认 1，性能较弱的服务器可设更高值）

移除服务器

sh
./bin/rake servers:remove[id]

警告：不要移除有运行中会议的服务器，以免数据不一致。

启用/禁用服务器

sh
./bin/rake servers:enable[id]   # 启用服务器
./bin/rake servers:disable[id]  # 禁用服务器（不再分配新会议）

隔离服务器（Cordon）

sh
./bin/rake servers:cordon[id]

隔离后不再分配新会议，但保留现有会议，负载降为 0 后自动禁用，适用于维护升级。

修改负载乘数

sh
./bin/rake servers:loadMultiplier[id,newLoadMultiplier]

状态监控

立即轮询所有服务器

sh
./bin/rake poll:all

手动触发服务器状态和负载检查，无需等待默认轮询间隔。

检查整体部署状态

sh
./bin/rake status

输出服务器列表及关键指标（状态、在线状态、会议数、用户数等）。

升级方法

升级 Scalelite 至最新版本：

sh
systemctl restart scalelite.target

验证升级：访问 http(s)://<scalelite-hostname>/bigbluebutton/api，检查 <build> 标签中的版本号是否为最新。

获取帮助

如需 Scalelite 部署和配置的商业支持，可联系 Blindside Networks。

商标信息

本项目使用 BigBlueButton，但未经 BigBlueButton Inc. 认可或认证。BigBlueButton 及 BigBlueButton 徽标是 https://bigbluebutton.org 的商标。