P2P 与分布式存储 / 系统课时

用 Trickle ICE 边收集边检查

用 Trickle ICE 边收集边检查

普通 ICE 往往等待候选地址收集完成后才交换候选,导致连接检查启动较晚。Trickle ICE 允许节点逐个发送新发现的候选,让候选收集、信令传递和连通性检查重叠执行。本课通过时序对比、增量信令示例和耗时测量,完成一套可验证的 Trickle ICE 建连流程。

学习目标

  • 区分普通 ICE 与 Trickle ICE 的候选交换和检查时序。
  • 实现候选增量传递、远端候选添加及收集结束通知。
  • 使用实际时间戳测量首个可用候选对出现的时间,并识别常见竞态问题。

为什么等待全部候选会拖慢连接

ICE(Interactive Connectivity Establishment)通过收集本地候选、交换远端候选并执行 STUN 连通性检查,选出能够通信的候选对。候选通常包括 host(本地接口)、srflx(STUN 发现的服务器反射地址)和 relay(TURN 分配的中继地址)。

在普通 ICE 的完整收集模式中,应用通常等待本地候选收集结束,再将完整候选列表发送给对端。即使较早发现的 host 或 srflx 候选已经可以通信,也可能因等待 TURN 分配而推迟检查。

Trickle ICE 将候选交换改为增量过程:初始描述先到达,随后每发现一个候选就通过信令通道发送;接收方将候选加入 ICE Agent,使检查能够在收集尚未结束时启动。

普通 ICE 与 Trickle ICE 的候选收集及连通性检查时序对比

图中是用于理解并行效果的假设时间,不是协议规定的固定延迟。普通 ICE 在1600毫秒得到可用候选对,Trickle ICE 在750毫秒得到可用候选对,差值为850毫秒。真实收益取决于网络、信令延迟、候选优先级以及对端支持情况。

增量信令如何驱动连接检查

Trickle ICE 并非跳过 ICE 检查,而是让候选发现与检查并行。RFC 8838 定义了 Trickle ICE 的工作方式,并区分支持增量交换的完整 Trickle 模式与需要兼容普通 ICE 的半 Trickle 模式。

以节点 A 主动建立连接为例,实际流程如下:

  1. A 创建 ICE Agent 和本地会话描述,向 B 发送初始 offer。完整 Trickle 模式允许初始描述尚未包含全部候选。
  2. B 接收 offer,创建 answer 并返回;双方获得对端 ICE 用户名片段和密码等检查所需信息。
  3. A 或 B 发现新的 host、srflx、relay 候选后,立即通过可靠且保持消息顺序的信令通道发送。
  4. 接收方将候选加入对应的 ICE transport 和媒体段,ICE Agent 根据候选配对规则形成检查列表并调度检查。
  5. 检查成功后,ICE 继续按照角色和提名规则选择候选对;应用根据连接状态确认链路可用。
  6. 候选收集结束时发送 end-of-candidates,表示本轮对应 ICE generation 不再提供新候选。

Trickle ICE 双端增量候选交换与检查时序图

需要注意,信令服务器只负责转发描述和候选,真正的 ICE Binding 检查通常在候选网络路径上进行。发现可用候选对不等于最终提名完成;对于持续运行的 ICE Agent,还可能发生候选对切换。

使用浏览器 API 实现候选增量交换

浏览器 WebRTC 的 RTCPeerConnection 提供了 Trickle ICE 所需的事件和方法。icecandidate 事件报告新候选,addIceCandidate() 将远端候选交给 ICE Agent,iceGatheringState 反映本地收集进度。

下面是可在浏览器开发者工具 Console 中运行的单页面双 PeerConnection 演示。它用本地函数模拟信令通道,不依赖真实信令服务器;为避免外部服务依赖,配置 iceServers: [],因此主要演示本机 host 候选。跨 NAT 实验需要配置实际可访问的 STUN/TURN 服务,并将本地转发函数替换为 WebSocket 等信令通道。

js
(async () => {
  const config = { iceServers: [] };
  const a = new RTCPeerConnection(config);
  const b = new RTCPeerConnection(config);
  const pending = { a: [], b: [] };
  const start = performance.now();
  const log = (name, message) =>
    console.log(`${name} +${Math.round(performance.now() - start)}ms ${message}`);

  // 未设置远端描述时先缓存候选,避免信令到达顺序引发异常。
  async function deliver(target, name, candidate) {
    if (!target.remoteDescription) {
      pending[name].push(candidate);
      return;
    }
    await target.addIceCandidate(candidate);
    log(name, candidate ? '添加远端候选' : '收到候选结束标记');
  }

  async function flush(target, name) {
    for (const candidate of pending[name]) {
      await deliver(target, name, candidate);
    }
    pending[name] = [];
  }

  a.onicecandidate = (event) => {
    void deliver(b, 'B', event.candidate).catch(console.error);
  };
  b.onicecandidate = (event) => {
    void deliver(a, 'A', event.candidate).catch(console.error);
  };
  a.oniceconnectionstatechange = () => log('A', a.iceConnectionState);
  b.oniceconnectionstatechange = () => log('B', b.iceConnectionState);
  a.onicegatheringstatechange = () => log('A收集', a.iceGatheringState);
  b.onicegatheringstatechange = () => log('B收集', b.iceGatheringState);

  // 创建数据通道,确保协商产生实际需要检查的ICE传输。
  const channel = a.createDataChannel('demo');
  channel.onopen = () => log('A', '数据通道已打开');
  b.ondatachannel = (event) => {
    event.channel.onopen = () => log('B', '数据通道已打开');
  };

  await a.setLocalDescription(await a.createOffer());
  await b.setRemoteDescription(a.localDescription);
  await flush(b, 'B');
  await b.setLocalDescription(await b.createAnswer());
  await a.setRemoteDescription(b.localDescription);
  await flush(a, 'A');
  window.trickleDemo = { a, b };
})();

预期结果(示意,事件顺序和耗时因浏览器及网络环境而异):

text
A收集 +<TIME>ms gathering
B收集 +<TIME>ms gathering
B +<TIME>ms 添加远端候选
A +<TIME>ms 添加远端候选
A +<TIME>ms connected
B +<TIME>ms connected
A +<TIME>ms 数据通道已打开
B +<TIME>ms 数据通道已打开

其中 <TIME> 表示实际毫秒数。候选收集结束时,浏览器还可能触发 icecandidate 的 candidate === null 事件;示例会将该结束标记交给对端。部分浏览器或网络环境可能没有可用候选,因而不会出现 connected 和数据通道打开日志。iceServers: [] 不代表可以穿透互联网 NAT。

运行后可执行以下清理命令,关闭示例创建的连接:

js
trickleDemo.a.close();
trickleDemo.b.close();
console.log('连接已关闭');

预期输出:

text
连接已关闭

生产环境不能仅用 remoteDescription 是否存在判断全部信令顺序问题,还应为消息携带会话标识、ICE generation 和媒体段标识。ICE 重启时,新旧 generation 的候选不能混用。

对比普通 ICE 与 Trickle ICE 的建连耗时

要得到可信的耗时数据,必须先定义统一的起点和终点。建议以用户发起连接时刻为起点,以选定的 PeerConnection 首次进入 iceConnectionState === 'connected' 或 completed 为终点;如果业务要求数据通道可用,则另外记录 RTCDataChannel 的 open 时刻。

实验可使用相同两台设备、相同 STUN/TURN 配置和相同信令服务器,分别运行两种模式,每组至少重复20次。

观测项 普通 ICE 完整收集 Trickle ICE
初始描述发送 等待候选收集结束 描述可先发送
候选发送 一次性发送完整列表 发现后逐个发送
检查启动 完整列表交换后 收到可用候选后即可推进
候选收集与检查 通常顺序执行 可以重叠
典型代价 等待较长,但信令简单 信令事件更多,需要处理乱序与结束标记

例如,假设20次测量后,普通 ICE 的建连耗时中位数为1450毫秒,Trickle ICE 为680毫秒,则中位数差值为770毫秒,相对降低约53.1%。这只是算例,不能作为所有网络的性能承诺。

测量时记录 performance.now() 的相对时间,使用 RTCPeerConnection.getStats() 查看最终选定的候选对及其候选类型,并同时记录失败次数。不要把首次发现 host 候选的时间当成连接成功时间,也不要只挑成功且最快的样本。

在真实项目中还要分别统计直连成功、TURN 中继成功和连接失败的比例。Trickle ICE 主要减少等待与检查串行造成的延迟,并不会改变 NAT 的过滤规则,也不能保证原本无法直连的网络突然能够直连。

处理候选乱序、结束标记和兼容性

增量交换最容易出现的问题是候选比远端描述先到。直接调用 addIceCandidate() 可能因远端描述尚未设置而失败。正确做法是按 PeerConnection、媒体段和 ICE generation 缓存候选,待 setRemoteDescription() 成功后按顺序添加。

另一类错误是将收集结束当成连接成功。end-of-candidates 只声明该 ICE generation 不再继续提供候选,不能替代 STUN 连通性检查、候选对提名或应用层握手。

实际接入时应检查以下边界:

  1. 能力协商:通过远端会话描述中的 a=ice-options:trickle 等信息判断对端是否声明支持 Trickle ICE;在浏览器中也可在设置远端描述后查看 canTrickleIceCandidates。值为 null 表示尚无法确定,不应直接当成支持。
  2. 不支持增量候选:采用半 Trickle 或完整收集后发送描述的兼容路径,避免只发送不完整候选列表。
  3. 重复与过期消息:使用会话 ID、ICE ufrag 和媒体段标识校验候选所属范围;ICE restart 后拒绝旧 generation 的候选。
  4. 结束与超时:分别记录候选收集完成、检查失败和业务建连超时。即使本地收集完成,也可能仍在检查已发现的候选对。
  5. 信令可靠性:保证同一会话的描述、候选和结束消息可正确关联;使用有序信令传输或实现消息序号与缓冲处理。

验收时至少测试三种情况:正常增量到达、候选先于远端描述到达,以及候选收集结束但检查失败。前两种应能正确缓存并继续检查;最后一种应报告连接失败或按既定策略使用 TURN,而不是无限等待新候选。

Trickle ICE 的收益来自把原本串行的候选收集、信令交换和连通性检查重叠起来。实际落地时,优先保证候选归属正确、结束语义清晰和失败可观测,再根据真实网络中的建连中位数、尾延迟与成功率评估优化效果。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Trickle ICE 边收集边检查

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

登录哪都通