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。之后把主机名和邮箱交给脚本它就能自动向 Lets 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 infoexample.com -w这条命令的逻辑是先拉取脚本源码再交给 Bash 逐参数执行。各参数含义如下-v focal-270指定安装 BigBlueButton 2.7.x 版本想尝鲜 3.0 则用jammy-300-s bbb.example.com把服务器主机名配置为你的域名-e infoexample.com提供给 Lets 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用 Lets 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 infoexample.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 infoexample.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 infoexample.com -w -x脚本会提示你在 DNS 服务商处添加一条临时 TXT 记录添加完成后继续执行即可拿到证书。整个过程不用开放任何入站端口对内网部署非常友好。另外提醒一句如果脚本检测到服务器处于 NAT 之后内外网 IP 不一致它会自动读取内外网地址做适配万一适配失败建议对照官方防火墙配置文档手动校准。装完之后别急着收工先做这三件小事第一件验证客户端能正常开会。用浏览器打开你的域名进入任意房间系统会弹出音频接入选择试试麦克风与仅收听两个选项是否都能正常工作HTML5 客户端音频接入选项第二件初始化 Greenlight 管理员。脚本在安装 Greenlight 后通常会在终端输出创建管理员账号的命令照做即可。之后在页面右上角用管理员身份登录就能进入后台管理录制、用户和组织Greenlight 管理员后台入口第三件记住升级 重跑同一命令。想升级到新的小版本或给系统打补丁直接以相同参数重新执行安装命令即可脚本会检测版本差异并完成增量更新省心程度拉满。避坑清单九成事故都出在这五个地方排查问题时优先按下面顺序自检能省下大量时间域名解析dig bbb.example.com是否返回了服务器公网 IP安全组与 UFWTCP 22/80/443 与 UDP 16384–32768 是否全部放行内外防火墙缺一不可。服务器资源内存是否低于 4 GBfree -h看一眼swap 耗尽往往表现为各种服务反复重启。HTTPS 是否生效浏览器地址栏锁标是否正常证书缺失时客户端会白屏。是否重复安装冲突本机若已有 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），仅供参考 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。之后把主机名和邮箱交给脚本它就能自动向 Lets 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 infoexample.com -w这条命令的逻辑是先拉取脚本源码再交给 Bash 逐参数执行。各参数含义如下-v focal-270指定安装 BigBlueButton 2.7.x 版本想尝鲜 3.0 则用jammy-300-s bbb.example.com把服务器主机名配置为你的域名-e infoexample.com提供给 Lets 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用 Lets 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 infoexample.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 infoexample.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 infoexample.com -w -x脚本会提示你在 DNS 服务商处添加一条临时 TXT 记录添加完成后继续执行即可拿到证书。整个过程不用开放任何入站端口对内网部署非常友好。另外提醒一句如果脚本检测到服务器处于 NAT 之后内外网 IP 不一致它会自动读取内外网地址做适配万一适配失败建议对照官方防火墙配置文档手动校准。装完之后别急着收工先做这三件小事第一件验证客户端能正常开会。用浏览器打开你的域名进入任意房间系统会弹出音频接入选择试试麦克风与仅收听两个选项是否都能正常工作HTML5 客户端音频接入选项第二件初始化 Greenlight 管理员。脚本在安装 Greenlight 后通常会在终端输出创建管理员账号的命令照做即可。之后在页面右上角用管理员身份登录就能进入后台管理录制、用户和组织Greenlight 管理员后台入口第三件记住升级 重跑同一命令。想升级到新的小版本或给系统打补丁直接以相同参数重新执行安装命令即可脚本会检测版本差异并完成增量更新省心程度拉满。避坑清单九成事故都出在这五个地方排查问题时优先按下面顺序自检能省下大量时间域名解析dig bbb.example.com是否返回了服务器公网 IP安全组与 UFWTCP 22/80/443 与 UDP 16384–32768 是否全部放行内外防火墙缺一不可。服务器资源内存是否低于 4 GBfree -h看一眼swap 耗尽往往表现为各种服务反复重启。HTTPS 是否生效浏览器地址栏锁标是否正常证书缺失时客户端会白屏。是否重复安装冲突本机若已有 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），仅供参考