寻求Azure VM部署coturn STUN/TURN Server的经验与故障排查帮助

我之前在Azure VM上部署过coturn STUN/TURN Server，碰到过不少和你类似的坑，结合实战经验给你梳理几个排查和修复的关键点：

1. 务必检查双层防火墙配置 #

Azure VM的网络访问受**网络安全组（NSG）**和VM本地防火墙双重管控，任何一层没放行端口都会导致失败：

• NSG入站规则：必须添加以下规则：
  • 允许TCP/UDP端口3478（coturn默认的STUN/TURN控制端口）
  • 允许UDP端口范围（默认是49152-65535，对应媒体流传输）
    注意要确保NSG关联到VM所在的子网或VM本身，不要配置到错误的资源上。
• VM本地防火墙：如果用的是Ubuntu/Debian，执行以下命令放行端口：

  ufw allow 3478/tcp
  ufw allow 3478/udp
  ufw allow 49152:65535/udp
  ufw reload
  

  要是CentOS/RHEL，就用firewalld对应命令开放端口。

2. 修正coturn配置文件的核心参数 #

这是最容易踩坑的地方，很多部署失败都是配置参数不对：

• external-ip：必须设置为公网IP/内网IP的格式，比如external-ip=20.xx.xx.xx/10.0.0.4（前者是VM的公共IP，后者是VM的私有内网IP），这个参数是让coturn正确映射NAT后的公网地址，只填公网或内网IP都会导致客户端无法连接。
• listening-ip：设置为VM的内网IP，或者0.0.0.0监听所有网络接口。
• 认证相关：如果开启了用户认证，要确保user参数格式正确：user=your_username:your_password，测试时必须携带正确的凭证。
• 强制开启两个关键参数：在配置文件中添加：

  fingerprint
  lt-cred-mech
  

  这两个是WebRTC场景下必须的配置，缺失会导致客户端无法建立连接。

3. 通过日志快速定位问题 #

启动coturn后，一定要查看日志来排查错误：

• 实时启动日志：执行turnserver -v启动，在终端查看实时输出，比如出现Failed to bind to address说明端口被占用或没放行；出现No external IP address configured说明external-ip参数配置错误。
• 系统日志：默认日志文件在/var/log/turnserver.log，里面会记录详细的连接请求、错误信息，能帮你快速定位根因。

4. 验证公网IP映射正确性 #

Azure VM的公网IP是通过NAT映射的，要确保coturn能正确识别：

• 在VM内执行curl ifconfig.me获取当前公网IP，确认和Azure门户显示的公共IP一致。
• 把这个公网IP准确填入external-ip参数中，不要写错或遗漏内网IP部分。

5. 用测试工具验证功能 #

用WebRTC的trickle ice测试工具（浏览器搜索即可找到在线版本），输入你的服务器地址：

• STUN测试：stun:你的公网IP:3478
• TURN测试：turn:你的公网IP:3478?transport=udp，并填入配置的用户名和密码
  如果测试能成功获取到relay类型的候选地址，说明服务器部署成功；如果失败，根据工具提示排查（比如Timeout对应端口问题，Invalid credentials对应认证问题）。

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