👋 歡迎來到 Link 幫助中心
在這裏可以找到你想要的答案～
幫助中心 / 音視頻部署與使用 / 常見問題排查
常見問題排查
1. 域名無法訪問或證書籤發失敗
檢查順序：
1. 域名 A/AAAA 記錄是否指向當前伺服器。
2.
80/TCP 和 443/TCP 是否已放行。3. Caddy 是否正常執行，配置校驗是否透過。
4. 是否存在其他程式佔用
80 或 443 埠。5. 伺服器是否能夠訪問 ACME 證書服務。
6. 安裝時輸入的證書聯絡郵箱格式是否正確。
2. 客戶端無法加入房間
檢查：
• Link 中的域名、埠和金鑰是否正確。
• 客戶端是否使用
wss://<livekit-domain>。• Caddy 能否連線
127.0.0.1:7880。• LiveKit 和 Link 伺服器時間是否同步。
• AccessKeyID/AccessKeySecret 是否完全一致，是否包含多餘空格。
3. 能加入房間但沒有聲音或畫面
這通常表示信令成功，但 RTC 媒體鏈路失敗。檢查：
•
50000-60000/UDP 是否完整放行並正確對映。•
7881/TCP 是否放行。• 伺服器公網 IP 是否正確，NAT 對映是否完整。
• 客戶端是否授予麥克風和攝像頭許可權。
• 企業網路或運營商是否限制 UDP。
• 是否需要啟用 TURN/UDP 或部署 TURN/TLS 以支援受限網路。
4. 只有一方能聽到或看到
檢查雙方客戶端許可權、上行網路、UDP 埠對映和防火牆回包規則。單向媒體通常不是 Caddy 反向代理問題，應重點檢查 WebRTC ICE 候選地址和媒體埠。
5. Webhook 沒有到達 Link
在 LiveKit 伺服器上測試 Gateway 地址的網路連通性，並檢查：
•
webhook.urls 地址、埠和路徑是否正確。• Gateway 是否註冊了
/live/v1/webhook 路由。• LiveKit 到 Gateway 的出站網路是否被攔截。
• Gateway 和 Infrastructure 日誌中是否存在簽名或請求體解析錯誤。
•
webhook.api_key 是否存在於 LiveKit keys 中。