BigBlueButton 从零到上线:一份完整快速的安装部署指南

📅 2026/8/13 15:31:24
BigBlueButton 从零到上线:一份完整快速的安装部署指南
BigBlueButton 从零到上线一份完整快速的安装部署指南【免费下载链接】bbb-installBASH script to install BigBlueButton in 30 minutes.项目地址: https://gitcode.com/gh_mirrors/bb/bbb-installBigBlueButton 是一款开源的网络会议与在线教学系统而本指南要带你使用的 bbb-install 项目正是它的一键安装器——一个 BASH 脚本能让一台全新的服务器在 30 分钟内变身上线可用的在线课堂。无论你是学校机房管理员、企业培训负责人还是想自建视频会议室的技术爱好者跟着本文一步步走无需深厚的 Linux 功底也能完成 BigBlueButton 安装部署。一、为什么要自己部署一套 BigBlueButton先说说最现实的问题市面上的商业会议软件虽然好用但往往按人头收费数据还放在别人的服务器上。BigBlueButton 想解决的就是这件事——它把开在线课堂这件事彻底开源支持多人视频、共享白板、屏幕共享、分组讨论、全程录制功能完全对标商业产品且你的数据始终掌握在自己手里。但开源不等于免安装。BigBlueButton 涉及十几个组件Web 服务器、录制引擎、媒体服务……手动部署一天都未必能搞定。这正是 bbb-install 存在的意义它是一段可执行的脚本核心文件bbb-install.sh会把安装、配置、签发证书、开防火墙等琐碎步骤全部自动化它负责安装和升级同一段脚本既能装新机也能在日后随时重跑实现版本升级它把时间压缩到 30 分钟只要服务器满足要求从空白系统到可开会一壶茶的功夫。仓库里除了脚本还有详细的README.md使用文档和images目录下的配置截图跟着本指南即可全部用上。适合谁想低成本搭建网课平台的教育机构、需要私有视频会议的企业以及一切不想把会议数据交给第三方的团队。二、出发前检查清单硬件、域名与防火墙安装前请先对照这份清单做行前检查避免装到一半才返工。1. 服务器配置建议BigBlueButton 对硬件有明确的最低要求达不到会出现安装失败或卡顿项目最低要求推荐配置操作系统Ubuntu 20.04 64 位对应 2.7.xUbuntu 22.04 64 位对应 3.0.x内存4 GB8 GB 以上CPU多核4 核以上磁盘能装下系统即可预留足够空间存放会议录像小提示如果你计划开 20 人以上的大型会议建议直接按推荐一列采购会议体验会流畅很多。2. 域名解析一张必须的入场券你需要一个域名比如bbb.example.com并把它做成A 记录指向服务器的公网 IP。这一步不能跳过——后面签发 HTTPS 证书和用户浏览器访问都依赖它。解析生效后可以用dig命令快速确认dig bbb.example.com 8.8.8.8如果返回的地址和服务器公网 IP 一致说明解析没问题可以进入下一步。3. 云平台的隐形门禁端口放行如果你的服务器在云厂商后面AWS、Azure、GCE 等光装系统还不够云控制台里的安全组/防火墙规则默认会挡住外部流量。请务必放行以下端口端口协议用途22TCPSSH 远程登录80 / 443TCPHTTP / HTTPS 访问16384 - 32768UDP音视频 RTP 流以 Azure 为例在创建实例时添加对应入站规则效果类似下图其他云平台如 AWS 安全组操作同理只是界面不同。注意这层外部防火墙和脚本里-w参数安装的系统防火墙UFW是两回事两者都需要配置云平台那层必须手动放行。三、三步拿到安装脚本万事俱备现在去拿脚本。用 SSH 登录服务器后把仓库克隆到本机git clone https://gitcode.com/gh_mirrors/bb/bbb-install cd bbb-install克隆下来的目录里有三个关键东西bbb-install.sh主角、README.md说明文档和images截图素材。如果你想先看看脚本到底会执行什么可以用任意文本编辑器打开bbb-install.sh翻阅源码脚本开头就写着详细的参数用法看不懂源码也没关系接下来你只需要记住一条命令。四、核心部署一条命令装好 BigBlueButton安装核心其实只有一条命令。以安装 BigBlueButton 2.7 为例在服务器上执行bash bbb-install.sh -v focal-270 -s bbb.example.com -e infoexample.com -w把bbb.example.com换成你自己的域名infoexample.com换成你的邮箱剩下的交给脚本。整个安装过程约 30 分钟期间脚本会自动安装组件、生成 4096 位的 Lets Encrypt SSL 证书并配置好防火墙。关键参数拆解新手不需要背参数只要理解下面这几行的含义就能举一反三参数作用必填-v focal-270安装 BigBlueButton 2.7.x 版本是-s bbb.example.com设置服务器主机名你的域名是-e infoexample.com提供给 Lets Encrypt 的邮箱用于签发证书是-w安装 UFW 防火墙只放行必要端口推荐-x私有网络下手动 DNS 验证证书按需-v的取值就是版本代号focal-270对应 Ubuntu 20.04 上的 2.7.xjammy-300对应 Ubuntu 22.04 上的 3.0.x。装哪个版本就按系统选哪个别混搭。服务器在私有网络怎么办如果你部署在纯内网无法被公网访问Lets Encrypt 的自动验证会失败。此时加上-x参数即可切换为手动 DNS 验证bash bbb-install.sh -v focal-270 -s bbb.example.com -e infoexample.com -w -x脚本会生成一段验证码你需要在 DNS 服务商处为_acme-challenge.bbb.example.com添加一条 TXT 记录确认生效后回车继续。需要提醒的是手动验证的证书有效期只有 90 天到期前记得按脚本提示手动续期。五、验收时刻确认服务器真的能开会装完不等于万事大吉建议按下面的三步体检验收一遍确认服务器真的能开会。第一步跑一遍体检命令在服务器上执行 BigBlueButton 自带的检查命令bbb-conf --check它会逐项检测内存、端口、服务状态、域名解析等全部通过会显示绿色提示。如果有红色报错对照报错信息排查即可。第二步打开浏览器测试会议在浏览器访问https://你的域名/用官方测试页创建一个临时会议输入昵称后点击加入能成功进入会议界面说明 Web 服务、HTTPS 证书、媒体服务都正常工作第三步测试麦克风与摄像头在会议里点击加入音频选择麦克风并授权浏览器使用摄像头能听到回音或看到画面就说明音视频链路畅通整套系统验收通过可以正式投入使用。六、给会议装个友好门面Greenlight 前端BigBlueButton 核心装好后用户面对的是一个相对技术化的界面。如果想给老师、学生一个友好的操作页面——注册账号、预约房间、管理录像那就需要安装官方房间管理器Greenlight。安装只需在原命令后加一个-gbash bbb-install.sh -v focal-270 -s bbb.example.com -e infoexample.com -w -g装好后访问https://你的域名/看到的就是 Greenlight 的欢迎页用户可以自助注册、创建个人会议室创建管理员并管理平台Greenlight 装好后用脚本在控制台提示的管理员信息登录就能进入管理后台在后台你可以管理用户与角色、设置房间和录像策略比如把注册方式改为需要审批这样既保证了平台的开放性又避免了陌生人随意注册占用资源。七、想对接学校平台LTI 与更多进阶玩法如果学校或公司已经在用 Moodle 等学习管理系统LMS还有更进阶的玩法。对接 LMS安装 LTI 框架通过-t参数可以安装 BigBlueButton 的 LTI 框架让老师直接在课程页面里一键发起会议bash bbb-install.sh -v focal-270 -s bbb.example.com -e infoexample.com -w -t MY_KEY:MY_SECRET这里的MY_KEY:MY_SECRET是你要自己保管的对接凭证请换成足够复杂的随机字符串别用示例值。一条命令装完所有扩展如果你想要全家桶——Greenlight Keycloak统一身份认证 LTI一条命令全部搞定bash bbb-install.sh -v focal-270 -s bbb.example.com -e infoexample.com -w -g -k -t MY_KEY:MY_SECRET更多实用参数-c 域名:密钥为网络受限的用户单独架设 coturn TURN 服务器让被防火墙卡住的用户也能顺畅通话-m /路径把录像存储目录/var/bigbluebutton软链到独立磁盘防止录像撑爆系统盘升级日后想升级到最新版本不需要重装原样重跑当初的安装命令即可脚本会自动完成平滑升级。八、新手最容易踩的坑与上线后的下一步常见错误及解决方法把这几年新手最常踩的坑列成清单遇到问题对号入座现象原因解决办法客户端页面打不开域名 A 记录没解析成功用dig检查解析确认指向公网 IP能进会议但没声音/没画面UDP 16384-32768 端口未放行去云控制台安全组放行 UDP 端口段安装过程直接报错退出内存不足或系统版本不对确认 ≥4GB 内存系统为 64 位 Ubuntu页面加载但客户端不启动安装时没加-s/-e证书未签发重跑命令补齐这两个参数升级失败跨大版本或系统已更换检查脚本提示必要时新装服务器并迁移录像上线之后该做什么配置管理员登录 Greenlight 后台创建管理员账号锁定注册策略接入课程平台按第七节把服务器接进 Moodle、Canvas 等系统或者直接集成进官网自定义门面修改 Greenlight 的 Logo、主题、条款让它看起来像是自家产品扩展与求助想深度定制可查看bbb-install.sh与README.md里的参数说明遇到问题可到 BigBlueButton 社区论坛提问附上报错日志能更快得到帮助。至此一套从零搭建、可正常开会、带友好界面、能对接课程平台的 BigBlueButton 服务器就正式上线了。30 分钟的投入换来一个自主可控的在线课堂这笔账怎么算都划算。祝你开课顺利【免费下载链接】bbb-installBASH script to install BigBlueButton in 30 minutes.项目地址: https://gitcode.com/gh_mirrors/bb/bbb-install创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考