修復 BigBlueButton 網路攝影機無法載入的問題：ICE Socket 連線失敗

當 BigBlueButton 網路攝影機畫面空白，瀏覽器或會議報告「ICE Socket 連線失敗」時，該訊息指向媒體連線失敗，但並未指出一個普遍適用的原因。攝影機權限、使用者網路、伺服器防火牆、NAT 位址和 TURN 中繼設定都可能產生影響。在變更伺服器配置之前，請先進行故障排除。

BigBlueButton 目前的故障排除指南中描述了一個相關的錯誤「1007：ICE 協商失敗」，該錯誤表示瀏覽器和媒體伺服器之間無法協商路徑。指南中列出了 NAT、UDP 連接埠被封鎖以及可能需要啟用限制性網路等問題。瀏覽器中顯示的具體資訊可能因 BigBlueButton 版本、託管平台或客戶端的不同而有所差異。請將其視為線索，而非診斷結果。請閱讀 BigBlueButton 4.0 故障排除指南。

首先，確定是攝影機故障還是網路連線故障。

瀏覽器需要獲得攝影機權限才能存取網路攝影機，且會議頁面必須使用安全上下文（例如 HTTPS）。這些檢查決定瀏覽器是否可以捕獲本機影片。 ICE 是 WebRTC 進程，負責尋找瀏覽器和 BigBlueButton 之間傳輸媒體的網路路由。攝影機權限被拒絕和 ICE 路由失敗是不同的問題，但兩者都會導致網路攝影機無法使用。 MDN文件詳細介紹了瀏覽器權限和安全上下文的要求。

檢查網址列旁的相機圖示和瀏覽器的網站設定。允許 BigBlueButton 網站存取攝像頭，確認已選擇目標攝像頭，並關閉其他可能正在使用該攝像頭的應用程式。如果瀏覽器顯示本地預覽，但會議仍然無法發布視頻，則表示本地設備訪問可能正常；請繼續進行網絡檢查。如果仍然沒有顯示預覽，請先檢查裝置選擇、作業系統隱私設定或瀏覽器權限。

嘗試按以下順序進行參與者檢查

刷新頁面並重新加入會議。退出會議，刷新頁面，然後再次加入並重試攝影機。這可以解決暫時的瀏覽器或媒體會話問題，但如果 ICE 故障反覆出現，通常需要從網路或伺服器端進行修復。
更新或切換到支援的瀏覽器。嘗試使用其他支援的桌面瀏覽器的最新版本。如果相機在該瀏覽器上可以正常運作，請記錄會議主持人使用的原始瀏覽器及其版本。不同瀏覽器可能會出現不同的行為，因此，一個瀏覽器可以正常運作並不能證明伺服器已針對所有使用者正確配置。
嘗試連接其他網路。如果允許，請嘗試使用手機熱點或其他可信任網路。如果第二次連接後攝影機能夠正常運作，則強烈提示原先的 Wi-Fi、VPN、代理程式或企業防火牆可能限制了網路流量。但這並不能確定具體是哪一條規則導致了這個問題。
用另一位與會者測試同一房間。如果多位使用不同網路的與會者都無法開啟鏡頭，請將可能的伺服器或主機問題回報給會議管理員。如果只有一位與會者無法開啟鏡頭，請先檢查該與會者的裝置、瀏覽器和網路。
測試另一個 BigBlueButton 房間或演示。如果貴組織允許，請使用單獨的房間或官方的 BigBlueButton 測試服務。如果攝影機在測試服務中可以正常運作，但在貴組織的伺服器上卻無法運作，請將此比較結果分享給管理員。

管理員應該核實哪些內容

當多個使用者受到影響時，請在每個網路邊界驗證媒體路徑：主機防火牆、雲端安全群組、路由器或 NAT 設備，以及任何上游網路防火牆。 BigBlueButton 的防火牆文件列出了用於 Web 流量的 TCP 80 和 443 端口，以及在文件中記錄的預設配置中用於媒體流量的 UDP 16384–32768 端口。您的安裝可能使用自訂範圍或特定版本的媒體堆疊，因此在變更規則之前，請確認實際配置。請勿開放比安裝所需範圍更廣的連接埠。請參閱最新的 BigBlueButton 防火牆配置指南。

對於位於 NAT 後的伺服器，請確認媒體服務已通告可存取的外部 IP 位址。 BigBlueButton 2.5 及更高版本使用 mediasoup 處理 HTML5 WebRTC 媒體；官方防火牆指南介紹如何設定通告的外部位址/etc/bigbluebutton/bbb-webrtc-sfu/production.yml。私有位址、過期的公網位址、錯誤的連接埠轉送或缺少 IPv6 設定都可能導致用戶端無法存取媒體服務。請僅套用與您的 BigBlueButton 版本和網頁佈局相符的說明，然後僅按照指南中的指示重新啟動服務。

也要檢查受影響的使用者是否位於阻止出站 UDP 的網路。當沒有直接路由時，TURN 伺服器可以轉送 WebRTC 流量，但必須安裝、可存取並針對對應的 BigBlueButton 版本進行設定。 TURN 文件和軟體包預設設定因版本而異；請遵循您所執行版本的指南。請勿從其他版本複製憑證或連接埠設定。請參閱 BigBlueButton 4.0 TURN 伺服器指南。

應避免的常見假設

“網路攝影機錯誤意味著攝影機壞了。”

不一定。如果本機預覽正常顯示且瀏覽器已取得權限，則裝置可能在媒體路由發生故障時正常運作。解決方法：嘗試連接其他網絡，並在更換攝影機前詢問其他參與者是否受到影響。

“允許攝影機運行可以解決所有網路攝影機故障。”

此權限僅允許瀏覽器擷取影片。它不會開啟被封鎖的UDP流量或更正伺服器的NAT位址。操作：確認權限後，請從其他網路測試連線。

“能夠正常加載的會議證明其媒體網絡是開放的。”

頁面和會議控制可以透過 HTTPS 加載，但即時音訊或視訊無法建立獨立的媒體路徑。 BigBlueButton 文件指出，ICE 故障以及 UDP 阻塞和 NAT 故障可能是造成此問題的原因。建議：使用網路攝影機測試並比較不同網路環境下的測試結果。

“所有伺服器都應該使用相同的連接埠和TURN設定。”

文件中記錄的預設設定僅供參考，不能作為實際配置的證明。連接埠可以自訂，TURN 設定也因版本而異。操作：在修改防火牆或中繼規則之前，請檢查已部署的版本和設定。

如何確認修復已完成

更改後，加入新的會議，並開啟相機至少一分鐘。確認本地預覽顯示正常，其他與會者可以看到視訊串流，並且重新連接不會重現 ICE 錯誤。請之前受影響網路上的使用者重複相同的測試。如果只有熱點測試成功，請將此結果告知網路管理員，並要求查看出站 WebRTC 流量。如果多個使用者的所有網路都發生故障，請將伺服器版本、大致時間、受影響的瀏覽器、錯誤代碼或確切錯誤訊息、音訊是否正常運作以及每次網路測試的結果傳送給 BigBlueButton 主機。請勿公開會議連結、存取權杖或未編輯的瀏覽器日誌。

有效的診斷可以縮小故障層級的範圍：本地攝影機存取、某個使用者的網路或伺服器的媒體路由。僅憑訊息本身無法區分這些情況，但這些檢查可以為管理員提供下一步變更的依據。