設定可靠的矩陣語音和視訊通話的 coturn

對於參與者位於不同網路而導致的 Matrix 通話失敗,請在具有公網 IP 位址的主機上部署 coturn,啟用其有時限的 TURN REST 憑證,並使用相同的共用金鑰和 TURN URI 設定 Synapse。然後允許 TURN 監聽器和 UDP 中繼範圍通過所有防火牆。 STUN 可以幫助客戶端發現網路路徑,但當無法建立直接路徑時,TURN 才是傳輸媒體的中繼。

此配置適用於自架的 Synapse 家庭伺服器和一台獨立的 Debian 或 Ubuntu TURN 主機,該主機需具有靜態公網 IPv4 位址。範例中使用 coturn 的預設監聽器,連接埠為 3478,預設 UDP 中繼範圍為 49152–65535。請將範例中的網域名稱、金鑰和路徑替換為您自己的配置。如果 coturn 位於 NAT 之後,請參閱下方的 NAT 說明;直接存取的公網主機更簡單可靠。

1. 將 TURN 主機名稱指向伺服器

建立一條指向 coturn 主機公網 IPv4 位址的 DNS A 記錄turn.example.com。使用專用主機名,以便其網路和憑證設定可以獨立於 Matrix Web 服務進行管理。除非 coturn 具有可用的 IPv6 連線和對應的防火牆規則,否則請勿發佈 AAAA 記錄;無法存取的 IPv6 位址可能會導致某些用戶端選擇失敗的路徑。

Synapse 目前的 TURN 文件指出,TURN 服務需要一個公網 IP 位址。 NAT 只有在網關擁有公網位址並正確轉送所需連接埠的情況下才能正常運作,文件也警告說,NAT 設定仍然可能不可靠。請參閱Synapse TURN 設定文件。

2. 安裝 Coturn 並配置認證繼電器

在 Debian 或 Ubuntu 系統上,安裝發行版軟體套件:

sudo apt update
sudo apt install coturn

使用編輯器開啟/etc/turnserver.conf文件,並配置以下基本設定。使用密碼管理器或加密安全的密碼產生器產生一個較長的隨機金鑰。稍後將該金鑰存入 Synapse;切勿重複使用 Matrix 使用者密碼或將金鑰公開到公用儲存庫中。

listening-port=3478
fingerprint
use-auth-secret
static-auth-secret=REPLACE_WITH_A_LONG_RANDOM_SECRET
realm=turn.example.com
server-name=turn.example.com
min-port=49152
max-port=65535

use-auth-secret並static-auth-secret啟用 Synapse 用於頒發臨時憑證的 TURN REST 憑證機制。realm應該是您的 TURN 服務的域名。中繼埠範圍與監聽器是分開的:用戶端聯絡埠 3478 請求分配,然後媒體使用已指派的中繼埠。 coturn 範例設定文件介紹了監聽器、中繼、TLS 和外部 IP 選項;分發包的預設值和路徑可能有所不同。

啟用並啟動該服務,然後檢查其狀態:

sudo systemctl enable --now coturn
sudo systemctl status coturn

如果您的軟體包在 `.htm.conf` 檔案中有單獨的啟用標誌/etc/default/coturn,請在啟動服務之前按照該檔案的說明進行操作。sudo journalctl -u coturn -e如果服務未啟動,請檢查日誌。

3. 允許監聽和中繼流量

在主機防火牆和任何提供者層級的防火牆中,允許連接埠 3478 上的入站 UDP 和 TCP 連接,以及連接埠 49152–65535 上的入站 UDP 連接。例如,使用 UFW:

sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49152:65535/udp
sudo ufw status

盡可能縮小中繼範圍,使其min-port與max-port防火牆範圍相符。如果啟用 TLS 監聽器,請同時開啟其配置的端口,並使用匹配的turns:URI 和憑證設定。在本範例中,TURN 連線上的 TLS 是可選的;Synapse 說明指出,即使 TURN 使用其純 UDP/TCP 監聽器,WebRTC 語音和視訊媒體仍然保持加密狀態,而訊號安全性則取決於您的 Matrix HTTPS 設定。

對於位於 NAT 後的主機,請設定 coturn 的external-ip=PUBLIC_IP/PRIVATE_IP映射,並將連接埠 3478 和整個中繼範圍轉送到 coturn 主機,無需變更外部中繼連接埠號碼。例如,公共中繼埠 52000 必須能夠存取內部連接埠 52000。 Synapse 的指南指出,NAT 仍然可能導致問題;如果您無法轉送大範圍的 UDP 流量,通常將 coturn 部署在公網 IP 的 VPS 上是更實際的選擇。

4. 將 Synapse 連接到 coturn

將以下設定新增至目前 Synapse 設定檔中(通常情況下homeserver.yaml)。主機名稱、連接埠和金鑰應與 coturn 配置相符:

turn_uris:
  - "turn:turn.example.com:3478?transport=udp"
  - "turn:turn.example.com:3478?transport=tcp"
turn_shared_secret: "REPLACE_WITH_A_LONG_RANDOM_SECRET"
turn_user_lifetime: 86400000
turn_allow_guests: false

有效期限以毫秒為單位;本範例要求 Synapse 頒發有效期限為 24 小時的憑證。請根據您的註冊策略設定訪客存取權限;並非僅為了允許註冊用戶撥打電話而必須設定訪客存取權限。請保持turn_shared_secret私有性,並與 coturn 的配置保持一致static-auth-secret。請勿加入stun:URI 來取代 TURN:這兩個協議功能相關但用途不同。

驗證 YAML 語法後,請重新啟動 Synapse:

sudo systemctl restart matrix-synapse.service
sudo systemctl status matrix-synapse.service

容器部署必須更新已掛載的 Synapse 設定並重新啟動 Synapse 容器。用戶端可能需要重新載入或刷新其伺服器配置;Synapse 指出,客戶端刷新 TURN 設定也可能需要長達一小時的時間。

驗證中繼候選者

使用與 TURN 伺服器位於不同網路的瀏覽器或裝置(例如使用行動數據的手機)進行測試。在基於瀏覽器的 Matrix 用戶端中,檢查已認證的 homeserver 請求/_matrix/client/v3/voip/turnServer(舊版用戶端可能使用舊/r0/路徑)。回應應包含 TURN URI 和臨時使用者名稱/密碼欄位;Matrix 規範定義了此端點的憑證回應。

使用這些憑證進行官方WebRTC Trickle ICE 測試,輸入伺服器名稱(例如turn:turn.example.com:3478?transport=udp),如果頁面提供候選類型篩選,請選擇中繼測試。測試成功後,候選類型應為relay。最後,在不同網路上的裝置之間發起 Matrix 通話。如果呼叫響鈴後一直停留在「正在連線」狀態,通常表示中繼埠被封鎖、NAT 對映錯誤或憑證不符;在變更無關的通話設定之前,請檢查 coturn 日誌和 Synapse 的 TURN 故障排除說明。

Synapse 建議chrome://webrtc-internals/在 Chrome 和Firefox 中進行瀏覽器診斷。如果中繼候選位址未顯示,請先確認金鑰完全匹配,然後檢查主機和提供者防火牆中的 UDP 3478 連接埠以及完整的中繼位址範圍。 coturn 專案在其turnserver 參考文件about:webrtc中記錄了連接埠和外部 IP 選項。

留下評論

在您自己的網域上設定自訂矩陣房間別名

使用 Element 或 Matrix API,在您的網域上為 Matrix 房間分配一個易於共享的地址,並檢查權限、Synapse 命名和聯合。

設定可靠的矩陣語音和視訊通話的 coturn

使用匹配的 TURN 憑證配置 coturn 和 Synapse,打開所需的中繼端口,並驗證 Matrix 用戶端是否可以取得中繼候選位址。

使用 Docker Compose 和 PostgreSQL 部署 Matrix Synapse

使用 Docker Compose 和 PostgreSQL 部署 Matrix Synapse

使用 Docker Compose、PostgreSQL、私人配置和檢查來設定持久的 Synapse 主伺服器,然後再透過 HTTPS 公開它。

自訂 Element Web 的主題和品牌

為您的 Element Web 部署設定品牌名稱、自訂色彩和登入資源,同時了解哪些部分仍保留 Element 品牌。

無需猜測即可提高 Synapse 的 Systemd 檔案限制

無需猜測即可提高 Synapse 的 Systemd 檔案限制

診斷 Synapse 是否達到其每個程序開啟檔案上限,為正確的服務或工作進程設定 systemd drop-in,並驗證即時限制。

元素顯示“解密失敗”?恢復遺失的房間鑰匙

元素顯示“解密失敗”?恢復遺失的房間鑰匙

確定錯誤是否僅限於一個瀏覽器或一個事件,然後使用 Element 的恢復金鑰或受信任的設備,而不會危及您剩餘的加密歷史記錄。

清理舊的 Synapse 訊息和媒體檔案而不遺失數據

使用 Synapse 的歷史記錄和媒體清除 API 或保留設定安全地刪除過期數據,然後驗證完成情況和磁碟空間恢復情況。

使用 Simple-Matrix-Bot-Lib 在 Python 中建立矩陣迴聲機器人

使用 Simple-Matrix-Bot-Lib 在 Python 中建立矩陣迴聲機器人

安裝目前庫,連接專用 Matrix 帳戶,並運行一個小型 !echo 機器人,該機器人具有更安全的憑證處理和清晰的測試。

使用獨立橋接器將 Matrix 連接到 WhatsApp、Telegram 和 Discord

使用獨立橋接器將 Matrix 連接到 WhatsApp、Telegram 和 Discord

設定三個 Mautrix 橋接器,分別進行註冊、登入和測試-避免 Docker 網路、帳號原則和同步方面的意外情況。

無需破壞共用檔案即可回收 Synapse 媒體磁碟空間

尋找 Synapse 儲存空間佔用情況,設定安全媒體保留策略,並在不直接從磁碟刪除檔案的情況下清除遠端快取。