WebRTC ICE连接失败求助：Django实时视频聊天开发遇问题

问题核心原因 #

你遇到的ICE failed错误，本质是仅靠STUN服务器无法穿透对称NAT环境（大部分校园网、企业网都属于这类NAT）。STUN仅能帮助获取公网地址，但对称NAT会为每个连接分配不同端口，导致P2P连接无法建立，必须通过TURN服务器中转流量。

代码调整：添加TURN服务器配置 #

修改你的iceServers配置，加入TURN服务器信息：

let iceServers = {
  iceServers: [
    { urls: "stun:stun.services.mozilla.com" },
    { urls: "stun:stun.l.google.com:19302" },
    { 
      urls: "turn:你的服务器公网IP:3478",
      username: "自定义用户名",
      credential: "自定义密码"
    }
  ],
};

coTURN服务器搭建步骤（以Ubuntu为例） #

1. 安装coTURN #

sudo apt update && sudo apt install coturn

2. 修改配置文件 #

编辑/etc/turnserver.conf：

# 基础监听端口
listening-port=3478
# TLS加密端口（可选，推荐启用）
tls-listening-port=5349
# 启用指纹验证
fingerprint
# 使用长期凭证机制
lt-cred-mech
# 设置用户名和密码（替换为你自己的）
user=webrtc_user:your_secure_password
# 设置域名或服务器公网IP
realm=your_public_ip_or_domain
# 如果服务器在NAT内网，指定公网/内网IP映射（格式：公网IP/内网IP）
external-ip=123.45.67.89/192.168.1.100
# 日志路径，方便排查问题
log-file=/var/log/turnserver.log

3. 启动并设置开机自启 #

sudo systemctl start coturn
sudo systemctl enable coturn

4. 开放防火墙端口 #

TURN需要UDP和TCP端口支持，开放对应端口：

sudo ufw allow 3478/tcp
sudo ufw allow 3478/udp
sudo ufw allow 5349/tcp
sudo ufw allow 5349/udp
sudo ufw reload

coTURN启动失败排查要点 #

• 端口占用：用ss -tulpn | grep 3478检查端口是否被其他程序占用
• 配置错误：重点检查external-ip和realm是否正确，配置文件有无语法错误
• 公网访问：确保服务器有公网IP，内网服务器需做好端口映射
• 日志排查：查看/var/log/turnserver.log中的错误信息，定位具体问题

调试技巧 #

在Firefox中访问about:webrtc，查看ICE候选列表：如果出现relay类型的候选，说明TURN配置生效；若没有，检查TURN服务器的连接状态和配置细节。

内容的提问来源于stack exchange，提问作者Dennis Mathew Jose