P2P 与分布式存储 / 系统课时
强制 relay 候选验证回退链路
强制 relay 候选验证回退链路
TURN 服务部署完成后,仅看到 Allocation 成功或 ICE 状态变为 connected,还不足以证明中继链路真正可用。本课通过限制 ICE 只使用 relay 候选,构造直连受限场景,验证双方能否经 TURN 完成双向数据传输,并用候选对、抓包和流量计数形成验收证据。
学习目标
- 配置 ICE relay-only 策略,明确它与普通自动回退的区别。
- 使用浏览器 WebRTC 和 coturn 完成可复现的双端中继测试。
- 根据选中候选对、双向消息和 TURN 流量判断回退链路是否真正可用。
强制中继究竟验证什么
ICE 通常收集三类候选:host 表示本地接口地址,srflx 表示经 STUN 发现的服务器反射地址,relay 表示 TURN 分配的中继地址。正常模式下,ICE 会检查多个候选对并选择可用路径;强制 relay 模式则限制本地候选使用 TURN 中继。
浏览器 WebRTC 可以通过 RTCPeerConnection 的 iceTransportPolicy: 'relay' 实现这一限制。需要注意,它限制的是本地候选类型,不代表远端候选也必然为 relay。如果希望验证双方都经过 TURN,应在两个对等端同时启用 relay-only。
| 验证模式 | 本地 ICE 策略 | 预期用途 |
|---|---|---|
| 正常连接 | all |
允许直连及 TURN 路径参与检查 |
| 单端强制中继 | A 为 relay,B 为 all |
检查 A 通过 TURN 的通信能力 |
| 双端强制中继 | A、B 均为 relay |
验证双方中继候选及端到端传输 |
双端 relay-only 是功能验证手段,不等于真实网络已经发生自动回退。要证明自动回退,还需要单独在 all 模式下限制直连路径,观察 ICE 最终选择 relay 路径。

准备 TURN 服务与测试环境
准备一台公网可达的 coturn 服务器,以及两端支持 WebRTC 的 Chromium 系浏览器。建议使用独立测试凭据,不要在正式课程页面或公开仓库中暴露生产环境 TURN 密码。
以下采用 coturn 长期凭据认证作为实验配置,假设服务器直接拥有公网地址,使用 UDP 3478 提供 TURN 服务。将配置中的地址、用户名、密码替换为实际测试值;如果服务器位于云 NAT 后方,还需要正确设置 external-ip 并开放中继端口范围。
# turnserver.conf:实验环境配置片段
listening-port=3478
fingerprint
lt-cred-mech
realm=turn.lab.example
user=relaytest:replace-with-strong-secret
min-port=49160
max-port=49200
no-cli这是配置文件片段,依赖已安装的 coturn 和可达的公网监听地址。turn.lab.example 是示例域名,需要替换为实际域名或公网 IP;密码必须使用独立的高强度测试凭据。
对于 Linux 上采用 systemd 管理的 coturn,可以在配置文件写入后执行:
sudo systemctl restart coturn
sudo systemctl status coturn --no-pager预期结果:服务状态显示 active (running)。不同发行版的服务单元可能叫 coturn 或 turnserver,应以实际安装结果为准。服务启动成功只代表进程运行,并不证明公网中继可用。
服务器侧需要检查 UDP 3478,以及示例中 UDP 49160~49200 的入站和出站访问策略。若使用云防火墙、安全组或容器网络,还要检查对应的网络转发规则。此处仅测试 UDP TURN;TCP/TLS TURN 应另行验收。
使用 relay-only 建立双端连接
下面使用一个最小 WebRTC DataChannel 测试。为避免依赖额外信令服务器,示例在同一个浏览器页面内创建两个 RTCPeerConnection,分别模拟 A、B 两端,并通过 JavaScript 交换 SDP 和 ICE 候选。
在 Chromium 浏览器的空白测试页面打开开发者工具 Console,粘贴完整代码执行。正式跨设备验收时,应把 A、B 分别运行在不同设备或网络中,并通过信令服务交换 SDP 和候选;同页测试只能证明本机到 TURN 的中继功能,不能替代跨网络验收。
(async () => {
const config = {
iceTransportPolicy: 'relay',
iceServers: [{
urls: 'turn:turn.lab.example:3478?transport=udp',
username: 'relaytest',
credential: 'replace-with-strong-secret'
}]
};
const a = new RTCPeerConnection(config);
const b = new RTCPeerConnection(config);
const channel = a.createDataChannel('relay-check');
const received = [];
// 仅在对端设置远端描述后添加候选,避免候选到达过早。
const pendingA = [];
const pendingB = [];
async function forward(candidate, target, queue) {
if (!candidate) return;
if (target.remoteDescription) {
await target.addIceCandidate(candidate);
} else {
queue.push(candidate);
}
}
async function flush(target, queue) {
while (queue.length) {
await target.addIceCandidate(queue.shift());
}
}
a.onicecandidate = e => {
forward(e.candidate, b, pendingB).catch(console.error);
};
b.onicecandidate = e => {
forward(e.candidate, a, pendingA).catch(console.error);
};
b.ondatachannel = e => {
e.channel.onmessage = event => {
received.push('B:' + event.data);
console.log('B received:', event.data);
e.channel.send('ACK:' + event.data);
};
};
channel.onmessage = event => {
received.push('A:' + event.data);
console.log('A received:', event.data);
};
channel.onopen = () => channel.send('relay-ping-001');
// 先完成SDP协商,再处理排队的trickle候选。
await a.setLocalDescription(await a.createOffer());
await b.setRemoteDescription(a.localDescription);
await flush(b, pendingB);
await b.setLocalDescription(await b.createAnswer());
await a.setRemoteDescription(b.localDescription);
await flush(a, pendingA);
// 保存连接,供后续统计与清理使用。
window.relayTest = { a, b, channel, received };
console.log('Relay test started');
})().catch(console.error);预期输出(TURN 可达且 ICE、DTLS、SCTP 均建立成功时):
Relay test started
B received: relay-ping-001
A received: ACK:relay-ping-001消息顺序中,启动日志先于 DataChannel 收发日志;网络建立时间随环境变化。若只出现启动日志,不能判定测试通过,需要继续检查 ICE 状态与 TURN 配置。
检查选中的候选对与真实流量
DataChannel 收到 ACK 只能证明应用层数据往返成功。还必须检查 ICE 实际选择的候选对,确认测试没有意外走直连路径。
在前一个示例完成后,继续执行以下代码。它读取 A 端 getStats() 的 ICE 候选对统计,查找被传输对象引用的选中候选对;若浏览器未暴露该引用,则尝试使用候选对的 selected 标记。
(async () => {
const pc = window.relayTest.a;
const stats = await pc.getStats();
const transport = [...stats.values()].find(
s => s.type === 'transport' && s.selectedCandidatePairId
);
const pair = transport
? stats.get(transport.selectedCandidatePairId)
: [...stats.values()].find(
s => s.type === 'candidate-pair' && s.selected
);
if (!pair) {
console.log('Selected pair unavailable');
return;
}
const local = stats.get(pair.localCandidateId);
const remote = stats.get(pair.remoteCandidateId);
console.log('local:', local?.candidateType);
console.log('remote:', remote?.candidateType);
console.log('state:', pair.state);
console.log('bytesSent:', pair.bytesSent);
console.log('bytesReceived:', pair.bytesReceived);
})().catch(console.error);预期输出示例(字节数随实际传输和浏览器统计口径变化):
local: relay
remote: relay
state: succeeded
bytesSent: <BYTES_SENT>
bytesReceived: <BYTES_RECEIVED><BYTES_SENT> 与 <BYTES_RECEIVED> 表示运行时统计值,不是固定输出。应确认两者存在且在发送更多数据后增加;候选对 succeeded 表示连通性检查成功,最终选中关系还需要结合 transport 统计确认。
若浏览器没有提供对应字段,可使用 Chromium 的 chrome://webrtc-internals 检查 ICE candidate pair、local candidate、remote candidate 和 DataChannel 统计。不同 Chromium 版本的统计字段与界面展示可能不同,不应依赖固定页面布局。
服务端还应同步验证 TURN 中继流量。可在 Linux TURN 服务器上运行:
sudo tcpdump -ni any 'udp port 3478 or udp portrange 49160-49200'预期结果:执行测试时出现 TURN 客户端连接与中继端口相关的 UDP 报文,源、目的地址和端口取决于实际部署。tcpdump 只提供报文证据,不能单凭 UDP 3478 的流量证明应用数据已双向传输,因为它也可能包含 TURN 控制消息或保活流量。

故障定位与验收标准
排查时按 TURN 分配、ICE 连通性、DataChannel 建立、应用数据传输的顺序逐层缩小范围,避免看到连接失败就直接修改 ICE 策略。
| 现象 | 优先检查 | 修正方向 |
|---|---|---|
| 没有 relay 候选 | TURN 地址、认证、3478 可达性 | 修复凭据、DNS 和监听配置 |
| 有 relay 候选但 ICE 失败 | 中继端口范围、防火墙、远端可达性 | 开放必要 UDP 端口并检查云安全组 |
| ICE connected 但 DataChannel 未 open | DTLS/SCTP 协商与连接状态 | 检查 SDP、连接错误和浏览器日志 |
| 只有单向业务消息 | 消息处理器、通道状态和发送逻辑 | 检查双方 onmessage 与 send 调用 |
| 数据双向成功但流量不增长 | 统计对象、选中候选对和抓包接口 | 核对实际路径并重新采样统计 |
可以使用以下四项作为一次双端 relay-only 测试的通过标准:
- A、B 均能成功收集 relay 候选,且最终选中候选对的本地和远端类型均为
relay。 - 双方 DataChannel 进入
open,A 发送带唯一序号的测试消息,B 收到后返回相同序号的 ACK。 - 双端应用日志能匹配同一个测试序号,且候选对的发送、接收字节统计在重复传输后增长。
- TURN 服务端在测试窗口内观察到对应分配或中继会话的流量;关闭连接后流量停止,资源最终按协议或服务端策略释放。
测试结束后,在浏览器 Console 执行:
window.relayTest.channel.close();
window.relayTest.a.close();
window.relayTest.b.close();
console.log('Relay test closed');预期输出:
Relay test closed这表示客户端已执行关闭操作,不表示 TURN Allocation 必然立即消失;服务端资源释放可能受刷新和超时机制影响。
最终还应恢复 iceTransportPolicy: 'all',在真实直连受限的网络条件下再次检查选中候选对。只有观察到正常策略下 ICE 实际选择 relay 路径并完成双向业务传输,才能进一步认定自动回退场景通过验收。