P2P 与分布式存储 / 系统课时
控制端如何提名最终连接路径
控制端如何提名最终连接路径
ICE 会为双方收集到的候选地址组成候选对,并通过连通性检查找出可用路径。本文说明 Controlling 与 Controlled 两种角色怎样协作完成提名,以及候选对被提名后如何成为实际传输路径,避免把“检查成功”误认为“已经选定”。
学习目标
- 区分 Controlling 和 Controlled 角色的职责。
- 理解候选对从连通性检查到提名成功的关键步骤。
- 判断 ICE 成功状态与实际数据传输之间的关系。
为什么连通性检查成功还不够
ICE(Interactive Connectivity Establishment)会把本地候选地址与远端候选地址组合成候选对,例如本地 UDP 主机候选与远端服务器反射候选。每个候选对都可以单独执行连通性检查,以确认数据报能否经过这条路径往返。
检查成功只说明候选对已通过相应的连通性验证,并不必然说明它已被正式提名为所选路径。常见的下一步是由 Controlling 端在合适的候选对上执行提名,Controlled 端配合确认。
| 术语 | 含义 |
|---|---|
| 候选对(Candidate Pair) | 本地候选与远端候选形成的一条潜在通信路径 |
| 连通性检查(Connectivity Check) | 通过 STUN Binding 请求与响应验证候选对的可达性 |
| 提名(Nomination) | Controlling 端指示某个已验证的候选对作为选定路径 |
| 已提名候选对(Nominated Pair) | 完成提名并被 ICE 选定用于该组件通信的候选对 |
Controlling 与 Controlled 如何协作
Controlling 端负责决定提名哪个候选对;Controlled 端响应检查并遵循 ICE 协议确认提名结果。它们是 ICE 代理在连接协商中的角色,不等同于应用程序里的客户端和服务端,也不表示哪一端必然主动发送业务数据。

在常见的 ICE 提名流程中,控制端会对已通过检查的候选对发起带有 USE-CANDIDATE 属性的 STUN Binding 请求。受控端成功处理该请求并返回成功响应后,该候选对才能完成提名。实际协议还包含角色冲突处理、检查优先级和失败处理等规则。
若双方最初对角色的理解冲突,ICE 可以通过 STUN 请求中的 ICE-CONTROLLING、ICE-CONTROLLED 属性及 tie-breaker 值解决角色冲突。不能把“本地发起了连接”直接当成 Controlling 角色的判定依据;角色应以 ICE 协商实际确定的结果为准。
用一个可运行模型观察提名过程
下面的 Python 示例模拟候选对经过检查、被控制端确认提名并成为选定路径的过程。它用于理解状态关系,不会发送真实 STUN 数据报,也不是完整的 ICE 实现。
# 用简化模型区分“检查成功”和“提名成功”。
candidate_pairs = [
{"name": "host-host", "check_succeeded": False, "nominated": False},
{"name": "srflx-srflx", "check_succeeded": True, "nominated": False},
]
role = "controlling"
selected_pair = None
for pair in candidate_pairs:
if not pair["check_succeeded"]:
continue
# 只有控制端执行提名;模型将受控端的成功确认作为完成条件。
if role == "controlling":
controlled_acknowledged = True
if controlled_acknowledged:
pair["nominated"] = True
selected_pair = pair["name"]
break
print("selected_pair:", selected_pair)
print("nominated:", next(p["nominated"] for p in candidate_pairs if p["name"] == selected_pair))预期输出
selected_pair: srflx-srflx
nominated: True模型里,host-host 检查未成功,因此不会进入提名步骤;srflx-srflx 检查成功后由控制端提名,并在模拟确认后被标记为选定路径。真实 ICE 的检查和提名由协议栈通过 STUN 消息处理,不能用这段模拟逻辑代替。
怎样判断选定路径已经生效
排查 WebRTC 应用时,需要区分 ICE 连接状态、选定候选对以及应用数据是否真正可用。浏览器可以通过 RTCPeerConnection 的状态事件观察 ICE 进度;候选对统计信息则可用于查看实际选中的本地和远端候选。
以下是适用于支持 WebRTC 的现代浏览器的控制台检查片段。变量 pc 必须是已经建立协商上下文的 RTCPeerConnection 实例;它不负责创建连接或交换 SDP。
// 片段示例:在已有 RTCPeerConnection 实例上检查 ICE 状态。
console.log("iceConnectionState:", pc.iceConnectionState);
console.log("connectionState:", pc.connectionState);
const stats = await pc.getStats();
for (const report of stats.values()) {
if (report.type === "candidate-pair" && report.state === "succeeded") {
console.log("candidate-pair:", report.id);
console.log("nominated:", report.nominated);
console.log("selected:", report.selected);
}
}预期结果
浏览器会输出当前 ICE 与整体连接状态;若统计报告包含成功的候选对,还会列出其 ID 及浏览器提供的提名或选中信息。不同浏览器与实现的统计字段可能略有差异,因此不能仅依赖某个可选字段判断业务链路已可用。
从提名成功到实际传输
候选对完成提名后,ICE 代理会据此确定选定路径,并在连接维护过程中继续处理连通性、网络变化和必要的切换。WebRTC 中,应用数据通过相应的数据通道或媒体传输机制发送;ICE 负责提供底层可用的传输路径,而不是负责解释业务消息内容。
验收时至少核对三项:候选对连通性检查成功、选定候选对与预期网络路径一致、应用层数据能够双向传输。若检查成功但没有候选对完成提名,应继续检查角色和提名流程;若已选定候选对但业务数据仍不通,则转查 DTLS、数据通道状态、媒体协商或应用层逻辑,避免将所有故障都归因于 NAT 穿透。