weiyu/deploy/coturn

sidebar_label, sidebar_position

sidebar_label	sidebar_position
Coturn	15

Coturn

STUN/TURN 服务安装

# https://github.com/coturn/coturn
apt install coturn
# 查看日志
turnserver --log-file stdout
# 启动运行
sudo systemctl start coturn
# 或
turnserver
# turnserver -c /etc/turnserver.conf
# 查看运行状态
sudo systemctl status coturn
# 停止运行
sudo systemctl stop coturn
# 重启运行
sudo systemctl restart coturn
# 
netstat -anp|grep turnserver

防火墙开放端口号

ufw allow 3478
# ufw status
# ufw disable
# 3478 TCP

修改 /etc/turnserver.conf 配置文件

# 备份配置文件
cp /etc/turnserver.conf /etc/turnserver.conf.original
# 下面的四行原本都是注释掉的，去掉前面的 #， 添加参数：
# 这个端口号是默认的
listening-port=3478    
# 此ip为服务器公网ip，替换为自己的  
external-ip=47.**.**.81
# 这个是用户名:密码，替换为自己的用户名和密码
user=username1:password1
user=username2:password2
# 这里填写域名，替换为自己的
realm=coturn.weiyuai.cn

修改 /etc/default/coturn 配置文件

# 去掉前面的注释 #
TURNSERVER_ENABLED=1

重启 turnserver

sudo systemctl restart coturn

测试

重要说明

⚠️ Coturn 是 STUN/TURN 服务器，使用 UDP/TCP 协议，不是 HTTP 服务器！

• ❌ 不能通过浏览器直接访问 http://14.103.165.199:3478
• ❌ Nginx 无法直接代理 STUN/TURN 协议到 HTTPS
• ✅ 需要使用专门的 WebRTC 测试工具

测试方法

方法 1: 使用在线 WebRTC 测试工具（推荐）

访问：WebRTC Trickle ICE 测试

填写信息：

STUN URI: stun:14.103.165.199:3478
或
TURN URI: turn:14.103.165.199:3478
Username: username1
Password: password1

点击 "Gather candidates" 按钮，成功会显示 srflx 或 relay 类型的候选地址。

方法 2: 使用本地测试页面

在浏览器中打开：file:///path/to/test_coturn.html

或者将 test_coturn.html 部署到 Web 服务器，通过 HTTPS 访问。

方法 3: 启用 Prometheus 监控

编辑 /etc/turnserver.conf，添加：

prometheus

重启服务：

sudo systemctl restart coturn

开放端口：

sudo ufw allow 9641

访问监控数据：http://14.103.165.199:9641/metrics

方法 4: 使用命令行工具

# 测试 STUN
turnutils_stunclient 14.103.165.199

# 测试 TURN
turnutils_uclient -v -u username1 -w password1 14.103.165.199

# 测试端口连通性
telnet 14.103.165.199 3478

查看运行状态

# 查看服务状态
sudo systemctl status coturn

# 实时日志
sudo journalctl -u coturn -f

# 查看端口监听
sudo netstat -tulnp | grep turnserver

详细测试指南

参见 test_coturn.md 获取完整测试说明。

Web Admin 管理界面

快速启用 Web Admin

使用自动化脚本（推荐）：

sudo bash setup_web_admin.sh

手动配置

编辑 /etc/turnserver.conf：

web-admin
web-admin-ip=0.0.0.0
web-admin-port=8080
web-admin-listen-on-workers

重启服务：

sudo systemctl restart coturn
sudo ufw allow 8080/tcp

访问 Web Admin

直接访问（HTTPS）：

https://14.103.165.199:8080

⚠️ 浏览器会显示 SSL 证书警告（自签名证书），点击"高级" → "继续访问"

通过 Nginx 代理（推荐）

https://coturn.weiyuai.cn/admin

详细配置参见 WEB_ADMIN_SETUP.md

参考资料

• Samples
• Github Samples
• WebRTC API
• Janus Gateway