在VMware安装全新BigBlueButton后出现空白蓝屏如何解决？

我之前帮不少人排查过BBB的这类问题，你遇到的这个蓝屏+Uncaught TypeError: Cannot set property 'ondevicechange' of undefined的错误，核心原因其实是BigBlueButton依赖HTTPS环境来正常启用WebRTC媒体设备API，而你一开始无域名无SSL的配置，加上之前自签名证书配置不当，导致浏览器安全限制阻断了必要的API调用。下面是一步步的可行解决方案：

1. 用BBB自带工具正确配置自签名SSL与域名 #

手动配置SSL很容易踩坑，BBB提供了官方脚本帮你一键搞定，步骤如下：

• 先给你的BBB服务器设置一个本地可访问的域名，比如bbb.local：
  • 在VMware主机的hosts文件（Windows是C:\Windows\System32\drivers\etc\hosts，Linux/macOS是/etc/hosts）里添加一行：你的虚拟机IP地址 bbb.local
• 登录BBB服务器，执行命令自动配置IP和SSL：

  bbb-conf --setip bbb.local
  bbb-conf --ssl bbb.local
  

• 重启所有BBB服务并检查状态：

  bbb-conf --restart
  bbb-conf --check
  

  确保输出里所有服务都是Running状态，没有红色报错。

2. 让浏览器信任自签名证书 #

因为是自签名证书，浏览器会默认拦截，必须手动信任才能正常使用媒体API：

• 打开浏览器访问https://bbb.local，会提示“不安全”，选择“高级”→“继续前往bbb.local（不安全）”
• 在Chrome里，点击地址栏的锁图标→“证书”→“详细信息”→“复制到文件”，把证书导出成.cer格式，然后导入到系统的信任证书列表里（不同系统操作略有不同，比如Windows是双击证书选“安装证书”→“本地计算机”→“将所有证书放入下列存储”→“受信任的根证书颁发机构”）

3. 验证bbb-demo的配置正确性 #

确保bbb-demo指向正确的BBB API地址：

• 编辑bbb-demo的配置文件：

  nano /usr/share/bbb-demo/conf/application.conf
  

• 找到并确认以下配置项：

  bigbluebutton.api.url=https://bbb.local/bigbluebutton/api/
  bigbluebutton.api.demo.url=https://bbb.local/demo/
  

• 重启bbb-demo服务：

  systemctl restart bbb-demo
  

4. 清除浏览器缓存与重置WebRTC状态 #

旧缓存可能残留错误配置，导致问题持续：

• 清除浏览器的Cookie、站点数据和缓存（快捷键Ctrl+Shift+Delete）
• 在Chrome里访问chrome://webrtc-internals/，点击页面顶部的“Delete all peer connections”重置WebRTC状态，然后关闭浏览器重新打开。

5. 检查VMware网络与防火墙设置 #

确保主机能正常访问BBB服务器的必要端口：

• VMware虚拟机网络建议用桥接模式，保证主机和虚拟机在同一局域网；如果用NAT模式，要在VMware里配置端口转发，映射80、443、1935端口到虚拟机。
• 在BBB服务器上开放必要端口：

  ufw allow 80/tcp
  ufw allow 443/tcp
  ufw allow 1935/tcp
  ufw reload
  

为什么之前自签名配置没解决？ #

大概率是手动配置时没同步更新BBB所有关联服务的配置（比如nginx的SSL反向代理、BBB API的域名设置等），而bbb-conf脚本会自动处理所有依赖配置，避免遗漏。

内容的提问来源于stack exchange，提问作者MTB