WebRTC API 实战：从核心机制到 Coturn 搭建与 ICE 调优

WebRTC 的核心 API，以及如何搭建一个简单的 TURN 服务器，并说明为何它对于应用稳定运行至关重要。

🔑 WebRTC 核心 API 简介

WebRTC 的核心功能通过三个紧密协作的 API 实现：

获取媒体设备：MediaDevices.getUserMedia() 负责获取摄像头、麦克风或屏幕的媒体流。它在连接建立前捕获本地音视频，并添加到 RTCPeerConnection 中进行传输。
建立 P2P 连接：RTCPeerConnection 是 WebRTC 的核心，负责管理端到端的连接。它会在背后处理复杂的 ICE 协议，包括利用 NAT 穿透技术（STUN/TURN）来找到双方的通信路径。
传输任意数据：RTCDataChannel 提供了一个双向的数据通道，用于传输非音视频的任意数据，非常适合实现实时聊天、文件共享或游戏状态同步等场景。

⚙️ 为什么要搭建自己的 TURN 服务器？

简单来说，STUN 服务器指路，TURN 服务器作为最后的通信路径，解决“路被堵上”的问题。

在复杂的网络环境中，特别是当双方都在严格的防火墙或对称型 NAT 之后时，建立直接的 P2P 连接可能会失败。这时，TURN (Traversal Using Relays around NAT) 服务器就作为数据的中继站，所有媒体流量都会通过这个可靠的服务器进行转发，有效解决无法直连的问题。

🚀 动手搭建 TURN 服务器 (以 Coturn 为例)

开源项目 coturn 是最流行的实现，它同时支持 STUN 和 TURN 协议。整个流程可分为安装、基本配置、启动服务和客户端测试等主要步骤。

前期准备

一台有公网 IP 的服务器 (Ubuntu 20.04 / CentOS 7)。
防火墙开放端口：
- 3478 (TCP & UDP)：TURN 服务主端口。
- 49152 - 65535 (UDP)：媒体数据中转端口。
一个已解析到服务器 IP 的域名(如 turn.yourdomain.com)。

步骤一：安装 Coturn

根据操作系统选择安装命令。

CentOS 7 系统：

sudo yum install epel-release -y
sudo yum install coturn -y   # 使用包管理器直接安装

步骤二：配置 Coturn

编辑 Coturn 的主配置文件 /etc/turnserver.conf（Ubuntu 上也需要创建或修改这个文件）。

1. 打开文件进行配置：

sudo nano /etc/turnserver.conf

2. 取消注释并修改以下核心配置项：

# 监听端口
listening-port=3478

# 公网 IP (替换为你服务器的公网IP)
external-ip=YOUR_SERVER_PUBLIC_IP

# 服务域名 (替换为你的域名)
realm=yourdomain.com

# 监听所有可用的网络接口
listening-ip=0.0.0.0

# 媒体端口范围
min-port=49152
max-port=65535

# 配置用户名和密码，用于WebRTC客户端连接时的认证
user=your_username:your_password

# (可选) HTTPS 安全相关配置
# cert=/etc/ssl/certs/your_certificate.pem
# pkey=/etc/ssl/private/your_private_key.pem

💡 重要提示：以上为基本配置，不添加证书时，客户端连接请使用 turn:域名:端口?transport=udp (不加 ?transport= 会默认走 TCP)。使用证书可以提供 TLS 加密的连接 (TURNS)，提高安全性。

3. 保存并退出文件。

步骤三：启动 Coturn 服务

CentOS 7 系统：

sudo systemctl enable coturn    # (可选，用于开机自启)
sudo systemctl start coturn

如果服务无法启动，可以尝试手动运行：

sudo turnserver -c /etc/turnserver.conf -o

步骤四：客户端连接与测试

访问在线测试工具 Trickle ICE。
在 "STUN or TURN URL" 处填上服务器地址（例如：turn:turn.yourdomain.com:3478），并填入设置的用户名和密码，点击 "Add Server"。
接着点击 "Gather candidates"。
在生成的候选地址列表中，如果能看到类型为 relay 的地址，就说明 TURN 服务器已经搭建成功并可以正常工作了。

✍️ 中高级：前端接管 ICE 候选

在实际开发中，RTCPeerConnection 会在与信令服务器交换 SDP 后，开始收集本地候选。

在 JavaScript 代码中，可以接管 pc.onicecandidate 事件。每当收集到新候选，就将其通过信令通道发送给通话的另一端。

// 假设已经创建了一个信令通道 (signalChannel)
pc.onicecandidate = (event) => {
  if (event.candidate) {
    // 将本地的ICE候选通过信令通道发送给对方
    signalChannel.send(JSON.stringify({
      type: 'candidate',
      candidate: event.candidate
    }));
  }
};

补充说明：在实际应用中，不需要显式地“选择”中继候选，RTCPeerConnection 的 ICE 层会自动按照主机候选 (host) → 反射候选 (srflx) → 中继候选 (relay) 的顺序进行连通性测试，选择最优的路径。

💎 总结与更多选择

Coturn 功能强大，但配置相对复杂。也可以考虑下面这些替代方案。

方案选项	方案说明
Docker 部署	使用 `coturn/coturn` 官方镜像，通过环境变量配置，实现一行命令部署，无需手动编辑配置文件。
使用云服务	直接使用云厂商提供的 TURN 服务，开箱即用，可作为临时调试备用方案。

💡 安全保障与注意事项

认证保护：务必为 TURN 服务器设置强密码，防止被滥用。
网络环境限制：云服务商安全组和系统防火墙需要开放 3478 (TCP/UDP) 和 49152-65535 (UDP) 等。注意，部分企业或校园网络可能会屏蔽 TURN 协议或特定端口，部署时需要了解目标网络环境。
性能与负载：TURN 服务器的带宽和 CPU 消耗取决于并发通话的数量和质量。高并发场景下，需要考虑横向扩展。