BigBlueButton安装终极指南：用bbb-install.sh从零搭建完整会议服务器

BigBlueButton安装终极指南：用bbb-install.sh从零搭建完整会议服务器

【免费下载链接】bbb-installBASH script to install BigBlueButton in 30 minutes.项目地址: https://gitcode.com/gh_mirrors/bb/bbb-install

如果你正在为在线课堂、远程答辩或团队协同寻找一套开源方案，那么 BigBlueButton安装 这件事多半已经出现在你的待办清单上了。官方仓库里的bbb-install项目，用一份 BASH 脚本把"下载组件、写配置、签证书、开防火墙"这些繁琐环节全部自动化，从一台裸机到可用的会议服务器，普遍不超过 30 分钟。本文不打算罗列手册原文，而是以"踩坑过来人"的视角，带你绕开那些让新手最容易卡壳的环节，一步步把服务真正跑起来。

bbb-install 安装脚本横幅

为什么大多数人自己手搓部署会翻车

很多人在接触bbb-install.sh之前，习惯性地以为"用 apt 装几个包就算完事"。坦白讲，BigBlueButton 的依赖链条相当长，牵涉 Nginx、FreeSWITCH、HTML5 客户端、录制组件等多个子系统，手工拼装极易遗漏关键步骤。这里先纠正四个高频认知误区，帮你省下半天排查时间：

  • 误区一：装完核心包就万事大吉。会议服务还需要反向代理、SSL 证书、TURN 中继等一系列配套配置，缺一环客户端就起不来。
  • 误区二：域名和 HTTPS 可有可无。现在的浏览器都要求 HTTPS 才允许调用摄像头、麦克风和屏幕共享（WebRTC 硬性要求）。不配-s和-e参数，前端根本加载不了。
  • 误区三：只放行 80/443 就够。语音和屏幕共享走的是 UDP 段 16384–32768，漏掉它，与会者能进房间但听不见彼此。
  • 误区四：云厂商安全组不用管。在 AWS、Azure、GCE 这类环境里，外部防火墙默认拦截流量，需要在控制台手动放行后才轮到脚本内置的 UFW 上场。

理解了这几点，再回头看脚本的设计逻辑，你会发现它其实把上面所有坑都替你填好了。

动工前的三件事：硬件、域名、端口

安装脚本本身并不挑剔，但你的服务器得先过"体检"。建议逐项核对下表，避免装到一半发现内存不足导致各组件反复崩溃。

检查项最低配置推荐配置
操作系统Ubuntu 20.04 / 22.04 64 位同上，纯净全新实例
内存4 GB8 GB 及以上
CPU双核4 核及以上
磁盘能容纳会议录制即可越大越好，SSD 更佳
公网 IP必须建议固定（弹性 IP）

域名这一步千万别跳过。你需要一个完全合格的域名（FQDN），比如bbb.example.com，并在域名注册商处为它添加一条 A 记录，解析到服务器的公网 IP。之后把主机名和邮箱交给脚本，它就能自动向 Let's Encrypt 申请 4096 位的 TLS 证书。

端口放行是第二道保险。无论服务器是否处在云厂商的防火墙之后，建议都按下面这张清单核对一遍：

协议端口用途
TCP22SSH 远程管理
TCP80 / 443HTTP 与 HTTPS 访问
UDP16384 – 32768FreeSWITCH 与 HTML5 客户端的音视频流

例如在 Azure 创建实例时，需要在入站规则中加上 80、443 以及这段 UDP 端口范围；在 AWS 上则是修改安全组（Security Group）。下面这张截图就是典型的云安全组配置界面，看到类似页面时把上表端口填进去即可。

云服务器安全组端口配置示例

一条命令跑通最小可用版本

基础准备就绪后，真正的"安装"只有一条命令。SSH 登录服务器（以 root 身份）执行：

wget -qO- https://raw.githubusercontent.com/bigbluebutton/bbb-install/v2.7.x-release/bbb-install.sh | bash -s -- -v focal-270 -s bbb.example.com -e info@example.com -w

这条命令的逻辑是：先拉取脚本源码，再交给 Bash 逐参数执行。各参数含义如下：

  • -v focal-270：指定安装 BigBlueButton 2.7.x 版本（想尝鲜 3.0 则用jammy-300）
  • -s bbb.example.com：把服务器主机名配置为你的域名
  • -e info@example.com：提供给 Let's Encrypt 用来签发证书的邮箱
  • -w：顺带装好 UFW 防火墙，只放开上表提到的几个端口

小提示：首次运行会下载大量依赖包，耗时取决于服务器带宽，二十分钟到半小时都属正常。期间保持 SSH 连接别断开，耐心等它输出完成提示即可。

安装脚本完整参数说明书

bbb-install.sh的能力远不止"最小安装"这一种姿势。运行-h可以随时查看帮助，这里挑几个高价值参数单独说明：

参数作用适用场景
-g安装 Greenlight 房间管理前端想给用户提供网页端入口
-k安装 Keycloak 20（单点登录）需要统一身份认证时
-t key:secret安装 LTI 框架并登记消费方凭据对接 Moodle 等 LMS 平台
-c hostname:secret对接独立 coturn TURN 服务器跨网段开会、NAT 穿透不佳
-x用 Let's Encrypt 手动 DNS 校验私有网络、无法开放 80 端口的场景
-j放宽生产环境要求校验开发、测试、CI 环境
-l只签发 SSL 证书，不装会议本体证书先行或单独续期

另外，脚本支持"只做一件事"的安装模式，比如只想给现有站点补一张证书，单独带-s -e -l即可，不会触碰其他服务。

进阶玩法：房间管理、单点登录、LMS 一次装齐

裸装出来的 BigBlueButton 只有 API 接口，普通用户没法"开个网页就进房间"，所以多数团队会叠加 Greenlight——它是官方出品的房间管理器，提供注册、建房间、管理录制等完整交互界面。

Greenlight 前端功能界面

一条命令把 Greenlight 一起装好：

wget -qO- https://raw.githubusercontent.com/bigbluebutton/bbb-install/v2.7.x-release/bbb-install.sh | bash -s -- -v focal-270 -s bbb.example.com -e info@example.com -w -g

如果你的组织已经跑在 Moodle、Canvas 之类的学习管理系统上，再加-t MY_KEY:MY_SECRET就能装上 LTI 框架，让课程页面里直接嵌入会议入口。想一步到位，把所有组件打包装齐：

wget -qO- https://raw.githubusercontent.com/bigbluebutton/bbb-install/v2.7.x-release/bbb-install.sh | bash -s -- -v focal-270 -s bbb.example.com -e info@example.com -w -g -k -t MY_KEY:MY_SECRET

特殊网络环境：私有内网与手动 DNS 校验

如果服务器跑在私有网络，80 端口对外不可达，自动化的 HTTP 校验会失败。此时改用-x参数，让 certbot 进入手动 DNS 校验模式：

wget -qO- https://raw.githubusercontent.com/bigbluebutton/bbb-install/v2.7.x-release/bbb-install.sh | bash -s -- -v focal-270 -s bbb.example.com -e info@example.com -w -x

脚本会提示你在 DNS 服务商处添加一条临时 TXT 记录，添加完成后继续执行即可拿到证书。整个过程不用开放任何入站端口，对内网部署非常友好。

另外提醒一句：如果脚本检测到服务器处于 NAT 之后（内外网 IP 不一致），它会自动读取内外网地址做适配；万一适配失败，建议对照官方防火墙配置文档手动校准。

装完之后别急着收工，先做这三件小事

第一件，验证客户端能正常开会。用浏览器打开你的域名，进入任意房间，系统会弹出音频接入选择，试试"麦克风"与"仅收听"两个选项是否都能正常工作：

HTML5 客户端音频接入选项

第二件，初始化 Greenlight 管理员。脚本在安装 Greenlight 后通常会在终端输出创建管理员账号的命令，照做即可。之后在页面右上角用管理员身份登录，就能进入后台管理录制、用户和组织：

Greenlight 管理员后台入口

第三件，记住"升级 = 重跑同一命令"。想升级到新的小版本，或给系统打补丁，直接以相同参数重新执行安装命令即可，脚本会检测版本差异并完成增量更新，省心程度拉满。

避坑清单：九成事故都出在这五个地方

排查问题时，优先按下面顺序自检，能省下大量时间：

  1. 域名解析：dig bbb.example.com是否返回了服务器公网 IP？
  2. 安全组与 UFW：TCP 22/80/443 与 UDP 16384–32768 是否全部放行？内外防火墙缺一不可。
  3. 服务器资源：内存是否低于 4 GB？free -h看一眼，swap 耗尽往往表现为各种服务反复重启。
  4. HTTPS 是否生效：浏览器地址栏锁标是否正常？证书缺失时客户端会白屏。
  5. 是否重复安装冲突：本机若已有 Apache 占着 80 端口，需要加-i参数放行。

下一步规划：给你一张行动自检表

如果你此刻准备动手，不妨把下面的清单走一遍，走完就基本稳了：

  • 已确认服务器系统与硬件达到建议配置
  • 已配置域名 A 记录并验证解析生效
  • 已在云控制台放行 22/80/443 与 UDP 16384–32768
  • 已执行-v ... -s ... -e ... -w完成最小安装并输出成功提示
  • 已用浏览器加入会议，麦克风与共享屏幕均可用
  • 已按需叠加 Greenlight（-g）、Keycloak（-k）、LTI（-t）
  • 已建立管理员账号并熟悉录制管理后台
  • 已把重新运行安装命令纳入日常升级流程

顺带一提，想逐行研读脚本细节，可以把仓库克隆到本地慢慢看：git clone https://gitcode.com/gh_mirrors/bb/bbb-install，仓库里的README.md和bbb-install.sh注释都很完整，适合作为进阶参考资料。至于遇到解决不了的问题，社区论坛是问路的好地方——把你的安装日志贴出来，通常很快就能得到热心人的答复。

到这里，你的 BigBlueButton 部署已经不再是"别人的教程"了。按这份清单走完一遍，你会拥有一套可以交付使用的在线会议服务；剩下的调优、换肤、对接 LMS，都是水到渠成的事。祝你一次装通，开会顺利。

【免费下载链接】bbb-installBASH script to install BigBlueButton in 30 minutes.项目地址: https://gitcode.com/gh_mirrors/bb/bbb-install

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考