👋 欢迎来到 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 中。