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

ICE 连通性检查怎样确认可达

ICE 连通性检查怎样确认可达

ICE 连通性检查通过 STUN Binding 请求与响应,验证两个候选地址之间是否真正可通信。本文以 UDP 候选对为例,说明检查请求、鉴权、成功响应及触发式检查的关系,并给出判断候选对是否有效的操作依据。

学习目标

  • 识别 ICE 连通性检查中的 STUN 请求、响应和事务 ID。
  • 理解短期凭据、MESSAGE-INTEGRITY 与候选对状态的作用。
  • 根据检查结果判断候选对是否成功,并理解触发式检查何时发生。

从候选对发起 Binding 检查

ICE Agent 从本地候选和远端候选组合出候选对,并根据优先级安排检查。对于 UDP 候选对,发起方会向远端候选地址发送 STUN Binding 请求;远端收到后验证请求,再返回 Binding 成功响应。请求超时或收到错误响应,不等于链路已成功。

一次检查通常包含以下关键字段:

  • USERNAME:短期凭据模式下,携带供接收方识别 ICE 会话的用户名组合,通常由双方 ICE username fragment 组成。
  • MESSAGE-INTEGRITY:根据 ICE 约定的短期密码和 STUN 消息内容计算的完整性校验值,用于验证消息完整性和凭据持有情况。
  • PRIORITY:指示发起方候选的优先级,帮助对端处理检查及可能的对端反射候选。
  • ICE-CONTROLLING 或 ICE-CONTROLLED:表明 ICE Agent 的角色,并携带 tie-breaker,用于处理角色冲突。
  • USE-CANDIDATE:由 controlling Agent 在适当的常规检查中请求提名该候选对;它不是所有检查请求都必须携带的字段。

检查响应中的 XOR-MAPPED-ADDRESS 表示接收方观察到的请求源地址映射信息。它可以帮助发起方发现服务器反射候选,但单独出现该字段并不能证明这条候选对已经被选为最终通信路径。

STUN 鉴权与成功判定

ICE 连通性检查并非仅发送一个普通 UDP 数据包。双方需要使用协商阶段得到的 ICE 凭据验证请求。接收方依据 USERNAME 确定对应的远端会话,再使用预期密码校验 MESSAGE-INTEGRITY;不能验证的请求不应被当成有效的 ICE 检查成功。

下面是一个用于理解字段的简化示意,并非可直接发送的完整 STUN 报文。真实报文还包括消息头、长度、事务 ID、属性编码及相应的完整性计算。

检查阶段 需要观察的内容 可以得出的结论
发送请求 目标候选地址、事务 ID、USERNAME、MESSAGE-INTEGRITY 检查已发起,尚不能判定可达
收到成功响应 响应类型与事务 ID 对应,响应通过必要的校验 此次检查成功,可将该候选对标记为可用
收到 STUN 错误响应 错误码及关联事务 ID 检查失败或需要按错误原因处理
等待超时 在配置的检查等待期限内没有匹配响应 本次检查未成功,需按 ICE 调度规则决定后续处理

只有与当前检查事务匹配、通过协议校验的成功响应才能作为检查成功的证据。不能把任意 UDP 数据、其他事务的 STUN 响应或仅仅收到对端数据包视为检查成功。

候选对状态如何变化

ICE Agent 通常将候选对维护在检查清单中。常见状态包括 Frozen、Waiting、In-Progress、Succeeded 和 Failed。这些状态描述的是检查调度与连通性检查结果,不应直接等同于应用数据已经畅通或媒体已经开始传输。

ICE 候选对连通性检查状态变化图

成功响应使本次连通性检查获得成功证据,候选对可以进入 Succeeded。若请求没有成功,则 Agent 会根据检查重传、计时器和协议规则继续等待或重试;达到最终失败条件后,该候选对才标记为 Failed。具体重传时机由 ICE 实现和协议参数决定,不应把某个固定等待秒数视为所有实现通用的规则。

即使候选对为 Succeeded,也仍要区分“检查成功”和“候选对已提名并用于后续通信”。常规检查中的成功结果会参与候选对选择;controlling Agent 通过提名机制表达使用意图,接收端完成相应处理后,双方才能依据 ICE 规则确定所选路径。

触发式检查解决什么问题

触发式检查(Triggered Check)用于响应对端已经发起的检查。当某个 Agent 收到来自对端、通过必要验证的连通性检查请求时,可以把对应的候选对加入或提升到检查调度队列,优先安排本地反向检查,而不必完全等待原先的常规检查顺序。

ICE 双向触发式检查时序图

例如,A 先对 B 发起检查,B 收到并验证请求后,不仅需要向 A 返回响应,还可能触发 B 到 A 的反向检查。反向检查使用自己的事务 ID 与消息认证信息,因此它不是重复发送 A 的原始请求。双向检查有助于双方验证相应方向的候选路径,并推动检查流程及时收敛。

触发式检查并不意味着绕过鉴权,也不意味着收到任何来自网络的 UDP 数据就立即建立连接。实现必须先按 ICE/STUN 规则识别请求、验证凭据和消息完整性,再根据候选对与检查清单状态安排后续任务。

实际检查时怎样定位问题

排查时应同时记录候选对、事务 ID、请求与响应类型、校验结果、重传次数和状态变化。以下是建议的日志字段格式示例;它是应用自行定义的诊断记录,不是 STUN 协议要求的标准日志格式。

json
{
  "event": "ice-check-result",
  "localCandidateId": "local-udp-1",
  "remoteCandidateId": "remote-udp-2",
  "transactionId": "<ID>",
  "requestType": "Binding Request",
  "responseType": "Binding Success Response",
  "integrityValid": true,
  "pairState": "Succeeded"
}

预期结果:在日志中看到与该检查对应的事务 ID、通过完整性校验的成功响应,以及候选对状态更新为 Succeeded。<ID> 只是占位符,实际事务 ID 由 STUN 事务生成机制提供。

如果状态一直停在 In-Progress,先检查目标地址与端口是否正确、两端是否使用匹配的 ICE 凭据、UDP 报文是否被 NAT 或防火墙过滤,以及返回包是否到达发起端。若收到 STUN 错误响应,则先根据错误码定位凭据、角色冲突或请求格式等问题;不要直接把所有失败归因于 NAT。

排查时尤其要避免三种误判:把发送成功当成对端可达,把任意 STUN 响应当成当前事务的成功,以及把 Succeeded 当成最终媒体路径已经提名。将事务匹配、消息鉴权、候选对状态和提名结果分别记录,才能明确故障发生在哪一个环节。

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

目录与阅读设置

阅读设置

17

记录一个想法

ICE 连通性检查怎样确认可达

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

登录哪都通