---
sidebar_label: Coturn
sidebar_position: 15
---

# Coturn

## STUN/TURN 服务安装

```bash
# 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
```

## 防火墙开放端口号

```bash
ufw allow 3478
# ufw status
# ufw disable
# 3478 TCP
```

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

```bash
# 备份配置文件
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 配置文件

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

## 重启 turnserver

```bash
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 测试](https://webrtc.github.io/samples/src/content/peerconnection/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` 类型的候选地址。

![WebRTC 测试](/img/deploy/webrtc/coturn_turn_stun_test.png)

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

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

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

#### 方法 3: 启用 Prometheus 监控

编辑 `/etc/turnserver.conf`，添加：
```bash
prometheus
```

重启服务：
```bash
sudo systemctl restart coturn
```

开放端口：
```bash
sudo ufw allow 9641
```

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

#### 方法 4: 使用命令行工具

```bash
# 测试 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
```

### 查看运行状态

```bash
# 查看服务状态
sudo systemctl status coturn

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

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

### 详细测试指南

参见 [test_coturn.md](./test_coturn.md) 获取完整测试说明。

## Web Admin 管理界面

### 快速启用 Web Admin

使用自动化脚本（推荐）：
```bash
sudo bash setup_web_admin.sh
```

### 手动配置

编辑 `/etc/turnserver.conf`：
```bash
web-admin
web-admin-ip=0.0.0.0
web-admin-port=8080
web-admin-listen-on-workers
```

重启服务：
```bash
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](./WEB_ADMIN_SETUP.md)

## 参考资料

- [Samples](https://webrtc.github.io/samples/)
- [Github Samples](https://github.com/webrtc/samples)
- [WebRTC API](https://developer.mozilla.org/en-US/docs/Web/API/WebRTC_API)
- [Janus Gateway](https://github.com/meetecho/janus-gateway)