家庭网络部署WebRTC TURN服务器的内网客户端连接问题求助

• 问题根源分析：你遇到的核心问题是TURN服务器未正确配置公网映射，导致给内网客户端返回的中继候选带了内网IP——外网客户端无法直接访问这个内网地址，自然会忽略该候选。另外，家庭NAT的端口转发不完整、ICE候选优先级设置不合理也会触发这个问题。

• 调整TURN服务器的公网IP配置
  以常用的coturn为例，启动时必须指定--external-ip参数，格式为内网IP/公网IP，比如：

  turnserver --external-ip 192.168.3.10/202.XX.XX.XX --listening-ip 0.0.0.0 --relay-ip 192.168.3.10 --user test:test --realm your-domain.com
  

  这个参数会告诉TURN服务器：自身对内网暴露的是192.168.3.10，对外网暴露的是公网IP202.XX.XX.XX，返回给客户端的中继候选会自动用公网IP，而非内网IP。同时要确保TURN绑定0.0.0.0，允许接收来自任意网卡的请求。

• 优化ICE候选优先级
  客户端默认可能给内网主机候选（Host Candidate）设置了过高优先级，导致外网客户端优先尝试连接内网IP。你可以在客户端代码中调整优先级：

  • 降低主机候选的权重，让服务器反射候选（Server Reflexive Candidate）和中继候选（Relay Candidate）排在前面；
  • 确保客户端在收集候选时，优先处理TURN返回的中继候选，而非本地内网IP。

• 验证端口转发规则
  家庭路由器需要开放TURN的所有必要端口：

  • 基础监听端口：默认3478（UDP+TCP）；
  • 中继端口范围：比如49152-65535（UDP+TCP），要全部转发到TURN服务器的内网IP对应端口；
    可以用coturn自带的工具验证连通性：

  turnutils_uclient -v 202.XX.XX.XX -p 3478 -u test -w test
  

  输出里如果能看到relay addr: 202.XX.XX.XX:XXXX，说明公网中继候选正常返回。

• 对称NAT的特殊处理
  如果你的家庭网络是对称型NAT，普通STUN无法穿透，必须依赖TURN中继。此时要确保TURN服务器配置了正确的认证（用户名密码或长期密钥），否则客户端会拒绝使用中继候选，导致连接失败。

内容的提问来源于stack exchange，提问作者abeam