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 路径。

正常 ICE 与双端 relay-only 的候选路径对比

准备 TURN 服务与测试环境

准备一台公网可达的 coturn 服务器,以及两端支持 WebRTC 的 Chromium 系浏览器。建议使用独立测试凭据,不要在正式课程页面或公开仓库中暴露生产环境 TURN 密码。

以下采用 coturn 长期凭据认证作为实验配置,假设服务器直接拥有公网地址,使用 UDP 3478 提供 TURN 服务。将配置中的地址、用户名、密码替换为实际测试值;如果服务器位于云 NAT 后方,还需要正确设置 external-ip 并开放中继端口范围。

ini
# 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,可以在配置文件写入后执行:

bash
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 的中继功能,不能替代跨网络验收。

js
(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 均建立成功时):

text
Relay test started
B received: relay-ping-001
A received: ACK:relay-ping-001

消息顺序中,启动日志先于 DataChannel 收发日志;网络建立时间随环境变化。若只出现启动日志,不能判定测试通过,需要继续检查 ICE 状态与 TURN 配置。

检查选中的候选对与真实流量

DataChannel 收到 ACK 只能证明应用层数据往返成功。还必须检查 ICE 实际选择的候选对,确认测试没有意外走直连路径。

在前一个示例完成后,继续执行以下代码。它读取 A 端 getStats() 的 ICE 候选对统计,查找被传输对象引用的选中候选对;若浏览器未暴露该引用,则尝试使用候选对的 selected 标记。

js
(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);

预期输出示例(字节数随实际传输和浏览器统计口径变化):

text
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 服务器上运行:

bash
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 测试的通过标准:

  1. A、B 均能成功收集 relay 候选,且最终选中候选对的本地和远端类型均为 relay。
  2. 双方 DataChannel 进入 open,A 发送带唯一序号的测试消息,B 收到后返回相同序号的 ACK。
  3. 双端应用日志能匹配同一个测试序号,且候选对的发送、接收字节统计在重复传输后增长。
  4. TURN 服务端在测试窗口内观察到对应分配或中继会话的流量;关闭连接后流量停止,资源最终按协议或服务端策略释放。

测试结束后,在浏览器 Console 执行:

js
window.relayTest.channel.close();
window.relayTest.a.close();
window.relayTest.b.close();
console.log('Relay test closed');

预期输出:

text
Relay test closed

这表示客户端已执行关闭操作,不表示 TURN Allocation 必然立即消失;服务端资源释放可能受刷新和超时机制影响。

最终还应恢复 iceTransportPolicy: 'all',在真实直连受限的网络条件下再次检查选中候选对。只有观察到正常策略下 ICE 实际选择 relay 路径并完成双向业务传输,才能进一步认定自动回退场景通过验收。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

强制 relay 候选验证回退链路

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通