编码与格式 / 系统课时
ICE 与网络穿透
ICE 与网络穿透
WebRTC 两端常位于 NAT、防火墙或企业代理之后,知道对方的 SDP 并不代表网络可达。ICE 会收集多类候选地址、组合候选对并执行连通性检测,最终选择一条可工作的路径;必要时由 TURN 中继流量。
学习目标
- 区分 host、srflx 和 relay 三类候选
- 说明 STUN、TURN 与 ICE 各自承担的职责
- 使用浏览器观察候选收集结果并定位常见失败
候选类型与服务器职责
设备通常只有局域网地址,外部主机无法直接访问;NAT 还会为出站连接分配临时公网映射。ICE 的目标不是只获取一个公网 IP,而是收集所有可能路径,再通过探测选出真正可达的候选对。
host 候选来自本机网卡,例如局域网地址或浏览器生成的 mDNS 主机名。srflx 候选由 STUN 帮助发现,表示 NAT 为本机映射出的公网地址和端口。relay 候选由 TURN 分配,双方无法直连时由服务器中继媒体和数据。
STUN 负责发现映射并参与连通性检测,不转发媒体;TURN 会实际转发流量,成功率更高但消耗服务器带宽,因此通常作为兜底路径。
ICE 连通性检测流程
使用 Trickle ICE 时,每发现一个候选就立即通过信令发送给对端,不必等待全部收集完成。两端收到候选后形成候选对,并发送 STUN Binding 请求检查双向可达性。

成功的候选对进入可用列表,控制方再提名最终路径。建立连接后 WebRTC 仍会维护状态;网络切换或路径失效时,应用可以触发 ICE Restart,重新收集候选并执行检测。
观察候选并排查失败
下面的代码可直接粘贴到浏览器控制台。它创建数据通道以触发候选收集,并打印候选类型、协议、地址和端口。
(async () => {
const pc = new RTCPeerConnection();
pc.createDataChannel('probe');
pc.onicecandidate = (event) => {
if (!event.candidate) {
console.log('ICE_GATHERING_COMPLETE');
pc.close();
return;
}
const candidate = event.candidate;
console.log(
candidate.type,
candidate.protocol,
candidate.address || '<MASKED>',
candidate.port || '<PORT>'
);
};
const offer = await pc.createOffer();
await pc.setLocalDescription(offer);
})();预期输出
host udp <LOCAL_OR_MDNS_ADDRESS> <PORT>
ICE_GATHERING_COMPLETE地址、端口和候选数量会因设备、浏览器及网络策略而变化,部分环境可能只输出收集完成标记。未配置 ICE 服务器时通常只能观察 host;配置可用 STUN 后可能出现 srflx,配置有效 TURN 地址和凭据后才可能出现 relay。
排查时先确认双方完整交换了 Offer、Answer 和 Candidate,再观察 iceGatheringState 是否到达 complete。如果只有 host,检查 STUN 配置和可访问性;如果已有 srflx 仍无法连通,验证 TURN 的 UDP、TCP、TLS 入口、凭据和域名解析。TURN 可用不代表一定被选择,只有更高优先级的直连路径不可用时才会使用中继。