流媒体与实时通信 / 系统课时
ICE 和 TURN 如何建立可达连接
ICE 和 TURN 如何建立可达连接
当浏览器需要通过公网建立实时媒体连接时,真正困难的不是“发起连接”,而是找到两端都能到达的传输路径。本篇用一个可运行的 WebRTC 示例拆解候选收集、连通性检查和候选对选择,并明确 STUN 负责发现公网映射、TURN 负责在直连失败时中继。
学习目标
- 能区分 host、srflx、relay 三类 ICE 候选及其来源。
- 能按“收集候选 → 检查候选对 → 选择可用路径”的顺序定位连接问题。
- 能根据 NAT、企业防火墙和中继成本判断何时必须部署 TURN。
先看 ICE 到底在寻找什么
ICE(Interactive Connectivity Establishment)不会直接假设“客户端之间能互通”,而是为每个端点准备多个候选地址,再测试候选对是否真的可达。常见候选可以这样理解:
| 候选类型 | 典型来源 | 示例形态 | 主要用途 |
|---|---|---|---|
| host | 本机网卡 | 192.168.1.20:54321 |
同网或可直达网络 |
| srflx | STUN 服务器 | 203.0.113.20:41000 |
发现 NAT 映射后的公网地址 |
| relay | TURN 服务器 | 198.51.100.10:53000 |
由服务器中继媒体 |
同一端可以同时产生多种候选。ICE agent 会把本地候选与远端候选组成候选对,然后进行连通性检查;只有真正收到对端响应的路径,才有资格进入可用路径竞争。

STUN 解决什么,TURN 又解决什么
STUN 本身不是“代理服务器”。浏览器向 STUN 服务发送请求后,可以得到服务器观察到的源公网地址和端口,从而形成 srflx 候选。它适合 NAT 映射允许两端形成直接路径的网络。
TURN 则把服务器本身放进媒体通路。客户端先与 TURN 建立连接并获得 relay 候选,真正的 RTP/RTCP 或数据流量再经 TURN 转发。这样即使对端之间无法直接打通,只要双方都能访问 TURN,就仍然可以建立媒体路径。
一个实用判断是:家庭网络中,STUN 常常足够;企业代理、严格防火墙、对称 NAT 或 UDP 受限网络中,TURN 的价值会明显上升。生产环境通常同时配置 STUN 与 TURN,而不是二选一。
用浏览器观察候选收集
下面的完整示例可以直接保存为 HTML 文件后在现代浏览器中打开。它创建一个数据通道来触发 ICE,并打印收集到的候选类型。示例使用公开 STUN 服务;没有你自己的 TURN 凭据时,不会凭空生成可用的 relay 候选。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<title>ICE Candidate Demo</title>
</head>
<body>
<pre id="log"></pre>
<script>
const log = document.querySelector("#log");
const pc = new RTCPeerConnection({
iceServers: [{ urls: "stun:stun.l.google.com:19302" }]
});
pc.createDataChannel("probe");
pc.onicecandidate = ({ candidate }) => {
if (!candidate) {
log.textContent += "ICE gathering complete\\n";
return;
}
const type = candidate.candidate.match(/ typ (host|srflx|relay) /)?.[1] ?? "unknown";
log.textContent += `${type}: ${candidate.candidate}\\n`;
};
pc.onicegatheringstatechange = () => {
log.textContent += `gatheringState=${pc.iceGatheringState}\\n`;
};
(async () => {
const offer = await pc.createOffer();
await pc.setLocalDescription(offer);
log.textContent += "Local description created\\n";
})().catch(err => {
log.textContent += `error=${err.message}\\n`;
});
</script>
</body>
</html>预期结果:
Local description created
gatheringState=gathering
host: candidate:... typ host ...
srflx: candidate:... typ srflx ...
ICE gathering complete
gatheringState=complete候选内容中的 IP、端口和数量会随本机网络变化。看到 host 说明本地候选已产生;看到 srflx 说明 STUN 成功观察到 NAT 映射。没有 TURN 配置时,不应把“没有 relay”误判成 ICE 失败。
连接检查为什么还要再跑一遍
候选收集成功只证明“地址被发现”,不证明“两个地址真的能互通”。拿到双方候选后,ICE 会对候选对执行连通性检查。检查成功的候选对会进入 Succeeded,最终代理会选择一条可用路径;因此排障时要区分“没有候选”和“候选存在但检查失败”。
假设浏览器 A 有 3 个候选,浏览器 B 有 3 个候选,理论上会形成最多 个候选对。实际实现会按优先级和检查状态调度,不需要人工逐对测试。
| 现象 | 更可能的位置 | 先查什么 |
|---|---|---|
| 只有 host 候选 | 候选收集或 STUN 配置 | iceServers、网络访问、浏览器日志 |
| 有 host/srflx,但全部检查失败 | NAT/防火墙路径 | UDP 入站、NAT 类型、端口策略 |
| 能拿到 relay 且 relay 检查成功 | 直连失败但中继可用 | TURN 健康度与带宽 |
| ICE connected 后很快断开 | 选中路径不稳定 | iceConnectionState、网络切换、TURN 超时 |
企业网络里什么时候必须上 TURN
可以用“直连成功率”和“可控性”两个指标做决定。若产品要求视频通话在受限办公网中仍保持可用,就不要把 TURN 当成最后才开启的应急服务,而应在连接失败时可立即提供 relay 候选。
部署时至少准备 UDP TURN;对严格网络,再准备 TCP/TLS 传输。浏览器端配置形式如下,地址与凭据替换成你自己的 TURN 服务:
const peerConnection = new RTCPeerConnection({
iceServers: [
{ urls: ["stun:stun.example.com:3478"] },
{
urls: [
"turn:turn.example.com:3478?transport=udp",
"turns:turn.example.com:5349"
],
username: "<ID>",
credential: "<TOKEN>"
}
]
});
console.log("ICE servers configured:", peerConnection.getConfiguration().iceServers.length);预期结果:
ICE servers configured: 2这里的 <ID> 和 <TOKEN> 是运行时凭据,不应硬编码进前端永久文件。生产系统通常通过短时有效的 TURN 凭据服务生成认证信息;同时监控 relay 使用率、峰值并发和出站带宽。一个 720p 实时视频若约为 2 Mbps,若有 500 路连接长期走 TURN,仅媒体发送方向的理论吞吐就可能接近 ,还没有计入协议开销和双向流量。
排障时最容易混淆的一点,是把 STUN 和 TURN 当成“两个同类服务器”。STUN 主要提供公网映射发现,TURN 则提供可实际承载媒体的中继路径;ICE 把两者产生的候选放进同一套候选对检查机制中,最后选择真正可达且优先级合适的路径。