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 在1600毫秒得到可用候选对,Trickle ICE 在750毫秒得到可用候选对,差值为850毫秒。真实收益取决于网络、信令延迟、候选优先级以及对端支持情况。
增量信令如何驱动连接检查
Trickle ICE 并非跳过 ICE 检查,而是让候选发现与检查并行。RFC 8838 定义了 Trickle ICE 的工作方式,并区分支持增量交换的完整 Trickle 模式与需要兼容普通 ICE 的半 Trickle 模式。
以节点 A 主动建立连接为例,实际流程如下:
- A 创建 ICE Agent 和本地会话描述,向 B 发送初始 offer。完整 Trickle 模式允许初始描述尚未包含全部候选。
- B 接收 offer,创建 answer 并返回;双方获得对端 ICE 用户名片段和密码等检查所需信息。
- A 或 B 发现新的 host、srflx、relay 候选后,立即通过可靠且保持消息顺序的信令通道发送。
- 接收方将候选加入对应的 ICE transport 和媒体段,ICE Agent 根据候选配对规则形成检查列表并调度检查。
- 检查成功后,ICE 继续按照角色和提名规则选择候选对;应用根据连接状态确认链路可用。
- 候选收集结束时发送 end-of-candidates,表示本轮对应 ICE generation 不再提供新候选。

需要注意,信令服务器只负责转发描述和候选,真正的 ICE Binding 检查通常在候选网络路径上进行。发现可用候选对不等于最终提名完成;对于持续运行的 ICE Agent,还可能发生候选对切换。
使用浏览器 API 实现候选增量交换
浏览器 WebRTC 的 RTCPeerConnection 提供了 Trickle ICE 所需的事件和方法。icecandidate 事件报告新候选,addIceCandidate() 将远端候选交给 ICE Agent,iceGatheringState 反映本地收集进度。
下面是可在浏览器开发者工具 Console 中运行的单页面双 PeerConnection 演示。它用本地函数模拟信令通道,不依赖真实信令服务器;为避免外部服务依赖,配置 iceServers: [],因此主要演示本机 host 候选。跨 NAT 实验需要配置实际可访问的 STUN/TURN 服务,并将本地转发函数替换为 WebSocket 等信令通道。
(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 };
})();预期结果(示意,事件顺序和耗时因浏览器及网络环境而异):
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。
运行后可执行以下清理命令,关闭示例创建的连接:
trickleDemo.a.close();
trickleDemo.b.close();
console.log('连接已关闭');预期输出:
连接已关闭生产环境不能仅用 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 连通性检查、候选对提名或应用层握手。
实际接入时应检查以下边界:
- 能力协商:通过远端会话描述中的
a=ice-options:trickle等信息判断对端是否声明支持 Trickle ICE;在浏览器中也可在设置远端描述后查看canTrickleIceCandidates。值为null表示尚无法确定,不应直接当成支持。 - 不支持增量候选:采用半 Trickle 或完整收集后发送描述的兼容路径,避免只发送不完整候选列表。
- 重复与过期消息:使用会话 ID、ICE ufrag 和媒体段标识校验候选所属范围;ICE restart 后拒绝旧 generation 的候选。
- 结束与超时:分别记录候选收集完成、检查失败和业务建连超时。即使本地收集完成,也可能仍在检查已发现的候选对。
- 信令可靠性:保证同一会话的描述、候选和结束消息可正确关联;使用有序信令传输或实现消息序号与缓冲处理。
验收时至少测试三种情况:正常增量到达、候选先于远端描述到达,以及候选收集结束但检查失败。前两种应能正确缓存并继续检查;最后一种应报告连接失败或按既定策略使用 TURN,而不是无限等待新候选。
Trickle ICE 的收益来自把原本串行的候选收集、信令交换和连通性检查重叠起来。实际落地时,优先保证候选归属正确、结束语义清晰和失败可观测,再根据真实网络中的建连中位数、尾延迟与成功率评估优化效果。