如何解決 Jitsi Meet “無法連接到網橋”錯誤

您打開一個 Jitsi Meet 會議室，頁面正常加載，甚至連信令似乎也正常工作——但會議始終無法建立媒體連接。 Jitsi 會報告「無法連接到網橋」 ，或在加入會議時重複斷開連線。在自架部署中，此訊息通常指向瀏覽器和Jitsi Videobridge (JVB)之間，或 Jicofo 和網橋本身之間存在問題。

最快的故障排除方法是從伺服器端開始：確認 JVB 正在運作並已註冊，確認其媒體連接埠可達，驗證 NAT/公網位址處理，最後再檢查客戶端網路限制。 Jitsi 官方自架指南將 UDP 連接埠 10000 列為預設媒體路徑，而 Jicofo 負責為每個會議選擇視訊橋接器。

錯誤通常意味著什麼

Jitsi Meet 由多個元件構成。網頁介面和 Prosody 負責訊號處理，Jicofo 負責協調會議，Jitsi Videobridge 負責轉發音訊和視訊串流。如果瀏覽器可以存取網頁但無法與 JVB 建立媒體連接，或者 Jicofo 沒有可用的正常橋接，則會議可能在橋接階段失敗。

對於當前的 Debian/Ubuntu 安裝，Jitsi 文件中記錄了以下網絡要求：TCP 80 用於證書驗證和續訂，TCP 443 用於 Web 訪問，UDP 10000 用於通用音頻/視頻傳輸，UDP 3478 用於可選的 STUN 查詢，TCP 的備用媒體。請參閱官方的 Jitsi Debian/Ubuntu 自架指南。 JVB 目前的參考配置也顯示，UDP 連接埠 10000 是Jitsi Videobridge 參考設定中的預設 ICE/UDP 連接埠。

1. 確認 Jitsi Videobridge 正在運行

首先，從錯誤訊息中指定的元件入手。在標準的基於軟體包的安裝中，運行：

sudo systemctl status jitsi-videobridge2

你想查看一下active (running)。如果設備發生故障，重新啟動設備可能會暫時恢復服務，但不要就此止步——檢查日誌以了解設備停止運作的原因：

sudo systemctl restart jitsi-videobridge2
sudo journalctl -u jitsi-videobridge2 -n 200 --no-pager

尋找綁定失敗、驗證錯誤、XMPP 連線失敗、重複出現的 ICE 問題，或指示沒有有效位址的訊息。不要想當然地認為 systemd 處於活動狀態就證明 JVB 可用：即使媒體網路或 XMPP 註冊出現故障，Java 進程也可能正在運行。

2. 確認 UDP 連接埠 10000 正在監聽，並且已允許通過主機防火牆。

Jitsi 的預設 JVB 媒體連接埠是 UDP 10000。請先確認伺服器正在監聽：

sudo ss -lunp | grep ':10000'

如果沒有任何裝置在監聽，請/etc/jitsi/videobridge/jvb.conf在變更防火牆規則之前檢查 JVB 日誌。如果連接埠正在監聽，請檢查主機防火牆：

sudo ufw status verbose

在執行 UFW 的 Ubuntu 伺服器上，Jitsi 自己的指南使用了以下方法：

sudo ufw allow 10000/udp
sudo ufw status verbose

如果您使用 firewalld、nftables、iptables 或雲端防火牆而不是 UFW，請在這些防火牆中新增等效的入站 UDP 規則。一個常見的錯誤是在 Ubuntu 中打開了 UDP 10000 端口，但卻被 AWS 安全群組、Azure 網路安全群組、Google Cloud VPC 防火牆、VPS 提供者防火牆或上游硬體防火牆阻止。

3. 當伺服器位於NAT之後時，檢查路由器連接埠轉送設定。

如果 Jitsi 運行在私人位址（例如 10000）上192.168.x.x，僅開啟 UFW 防火牆是不夠的。您的邊緣路由器必須將外部 UDP 媒體連接埠轉送到執行 JVB 的機器。在簡單的單一伺服器部署中，這通常意味著將 UDP 10000 連接埠轉送到 Jitsi 伺服器上的 UDP 10000 連接埠。

如果您變更了 JVB 的端口，請使用配置值，而不是盲目地開放 10000 端口。同時，請確認該連接埠未被其他機器或容器佔用。連接埠轉送介面因路由器而異，因此請將此圖視為配置範例，而非您裝置的精確介面。

4. 修復公網/私網位址映射

NAT 可能會導致更隱蔽的故障：即使路由器轉發了正確的端口，JVB 也可能向互聯網用戶端通告私有地址。 Jitsi 目前的快速入門文件展示了一種靜態映射，/etc/jitsi/videobridge/jvb.conf適用於需要明確本地位址到公網位址轉換的系統：

ice4j {
  harvest {
    mapping {
      static-mappings = [
        {
          local-address = "<Local.IP.Address>"
          public-address = "<Public.IP.Address>"
        }
      ]
    }
  }
}

將佔位符替換為 JVB 主機的實際私有位址和遠端用戶端可以存取的公用位址。然後重啟 JVB：

sudo systemctl restart jitsi-videobridge2

僅當此配置與您的網路拓撲結構相符時才使用。具有直接公網位址的伺服器、Docker 部署、多網卡、IPv6 或更複雜的 NAT 可能需要不同的設定。權威範例請參閱Jitsi 快速入門 NAT 部分。

5. 對於 Docker，請驗證 JVB UDP 連接埠是否已實際發布

在 Docker 中，如果 JVB 容器沒有發布其媒體端口，即使主機上的防火牆規則正確也無濟於事。 Jitsi 的 Docker 文件中列出的JVB_PORT預設值為 10000，並指示管理員在主機上開啟 UDP 10000 連接埠。請檢查您正在執行的部署：

docker compose ps
docker compose logs --tail=200 jvb

然後檢查您的 Compose 檔案和環境變數文件，確認 JVB 服務是否暴露了預期的 UDP 連接埠。如果您進行了更改JVB_PORT，則主機對映、防火牆規則和任何 NAT 轉送都必須保持一致。請參考Jitsi 官方的 Docker 自託管指南，而不是從第三方教學課程複製舊的 Compose 程式碼片段。

6. 確認 Jicofo 可以看到 Videobridge

即使UDP連接埠完全可達，如果JVB從未向XMPP控制平面註冊，也是不夠的。 Jicofo會為會議選擇一個Videobridge，Jitsi的可擴展部署指南建議在重啟服務後檢查Prosody和Jicofo的日誌，以確認視訊橋接器已連接並被識別。

sudo journalctl -u jicofo -n 200 --no-pager
sudo journalctl -u prosody -n 200 --no-pager
sudo journalctl -u jitsi-videobridge2 -n 200 --no-pager

如果您自訂了 XMPP 域或執行了多個節點，請確認 Jicofo 和 JVB 使用的是同一個橋接器「brewery」MUC。 Jitsi Videobridge 官方 MUC 文件指出，Jicofojicofo.bridge.brewery-jid必須指向與 Videobridge 實例相同的 MUC。

在主機名稱更改、遷移、拆分主機部署或手動編輯配置後，這一點尤其重要。對於使用官方安裝程式建立的標準​​軟體包安裝，除非日誌確實表明存在註冊或身份驗證問題，否則請避免重寫 XMPP 設定。

7. 排除客戶端網路限制、VPN 或代理的可能性

如果伺服器對部分使用者有效，但對其他使用者無效，請在變更伺服器設定之前，先從其他網路進行測試。企業網路、訪客 Wi-Fi、VPN 和嚴格代理可能會阻止 UDP 協定。暫時中斷 VPN 或代理連線是一種有效的診斷測試方法；如果您的組織需要，之後請重新連線。

Jitsi 的 Debian/Ubuntu 指南中提到，當 UDP 被阻止時，TCP 5349 可作為 coturn 音訊/視訊的備用路徑。如果您需要受限網路上的使用者能夠可靠地連接，請檢查您的 TURN/coturn 配置，而不是想當然地認為為網站開放 TCP 443 會自動提供媒體備用方案。

8. 僅在伺服器檢查通過後，才使用乾淨的瀏覽器會話重試。

雖然瀏覽器會話過期導致所有參與者都看到相同的橋接錯誤的可能性不如 JVB 路由故障那麼大，但這個問題也很容易解決。您可以重新載入房間、嘗試使用隱私瀏覽窗口，或清除 Jitsi 網域的網站數據，如果啟用了身份驗證，請重新登入。

如果錯誤在不同的瀏覽器和網路上重現，則應傳回伺服器端檢查，而不是重複清除瀏覽器資料。

如何驗證修復是否真正有效

不要因為錯誤彈窗消失就認為問題已解決。請測試完整的媒體路徑。

• 建立一個新房間，並使用兩台設備加入。
• 如果可能，請將裝置連接到不同的網絡，例如一台裝置連接到家庭寬頻，另一台裝置連接到行動資料。
• 確認音訊和視訊雙向傳輸均能持續幾分鐘。
• 加入會議時，請觀察 JVB 和 Jicofo 日誌，並驗證會議是否已分配給網橋，且沒有重複的 ICE 或網橋健康狀況故障。
• 重新啟動電腦或變更防火牆設定後，請重新運作sudo ss -lunp | grep ':10000'並檢查防火牆狀態。

對於多橋接部署，請測試多個會議。 Jitsi 的可擴展設定指南解釋說，Jicofo 會為新會議選擇一個視訊橋接器，因此即使另一個橋接器工作正常，一個故障的橋接器也可能導致間歇性故障。

快速診斷表

結論

對於自架的 Jitsi Meet 伺服器，「無法連線到網橋」錯誤最好先排查為媒體路徑或網橋註冊問題。請確認 Jitsi Videobridge 運作正常，UDP 10000 連接埠已監聽且可透過所有防火牆/NAT 層訪問，JVB 在啟用 NAT 時會通告可用的公網位址，以及 Jicofo 可以偵測到該橋接器。只有在完成這些檢查後，才應考慮檢查瀏覽器快取或客戶端設定。

具體的解決方案取決於您的網路拓撲結構，因此請勿僅因某些舊的 Jitsi 配置密鑰出現在歷史論壇帖子中就直接應用。以上命令和設定均與 2026 年 10 月核實的最新官方 Jitsi 手冊和 Jitsi Videobridge 組態來源一致。