一、我们实际观测到了什么
判定 NAT 类型不需要“猜”,需要的是四组观测。这些观测由
internal/api/clienttest.go 的 runClientTest 编排,
浏览器通过 WebRTC 建立两条相互独立的连接(internal/ice/peer.go),
服务端在两条不同的公网地址上等待它们的包:
| 探针 | 做什么 | 回答的问题 |
|---|---|---|
| 测试 I | 主地址收到第一条连接的包 | 你在公网上的映射端点 M(s,d₁) 是什么(这是后面所有比对的原点) |
| 测试 II | 换 IP + 端口 主动回包 | 入向过滤是否“端点无关”(别人能不能主动打进来) |
| 测试 IV | 只换 端口 主动回包 | 过滤是否依赖 IP(区分 Restricted 与 Port Restricted) |
| 测试 III | 第二条连接向备用地址发包,比对两次映射 | 映射是否随目的地址漂移,即 M(s,d₁) = M(s,d₂) 是否成立 |
四个探针的名字与判定树里的 p1 / p2 / p3 / p4 一一对应,代码里就是这个顺序。
二、三条不变量(判定树的骨架)
所有结论都建立在这三条不变量上,它们分别对应 judge 里的三处硬条件:
I1 在代码里是 p3.Comparable = comparableMapping(okMap1, okMap2, mapping):
要求两次观测来自同一条 mapping 连接,且两个目的地址各自只看到唯一一个公网端点。
少任何一个前提,p1.Mapped 与 p3.Mapped 相减得到的就不是 NAT 行为,
而是两条 socket 各自的端口号。
I3 是这段代码里最容易被忽视、但最容易造成“假全锥形”的一处:测试 III 会让浏览器向备用地址发包,
NAT 因此为那个地址放行。如果 III 先跑,后面 II / IV 的主动探测就会顺着这份已经打开的权限回来,
于是所有受限型都会被判成 Full Cone。所以代码里 III 明确排在最后,
连注释都写明了原因(internal/api/clienttest.go 测试 III 段落)。
三、三条定理
定理 1(对称型不会漏判)
若 p3 可比且 p3.Mapped ≠ p1.Mapped, 则本站判定为 NAT4,且该结论与 p2 / p4 的观测无关。
证明. 锥形 NAT 的定义是映射与目的端点无关,即对任意目的地址
d₁, d₂ 有 M(s,d₁) = M(s,d₂)。
I1 保证了两个观测确实来自同一 socket,因此两者不等只能由「映射依赖目的地址」解释,
这与锥形定义矛盾,故网络必然是对称型。判定树把这一条放在最前面
(judge 的第 1 个分支),所以它不会被后面的过滤结论覆盖。∎
定理 2(映射稳定时,三种锥形互不混淆)
若映射已证明稳定(可比且无漂移),则: 测试 II 通 ⇒ NAT1;II 不通而 IV 通 ⇒ NAT2;II / IV 都不通 ⇒ NAT3。
证明. 映射稳定意味着公网端点固定,于是类型只由入向过滤决定。 II 同时换 IP 与端口仍能收到回包,说明过滤不依赖源地址与源端口,即端点无关 —— Full Cone。 II 不通说明过滤依赖源地址;此时 IV(只换端口)通,说明过滤只依赖地址不依赖端口 —— Restricted Cone。 IV 也不通说明过滤同时依赖地址与端口 —— Port Restricted Cone。三种情况互斥且穷尽。∎
定理 3(信息不足时不冒充结论)
若映射未取得可比见证,则判定结果必为「无法判定」,不会是 NAT2 / NAT3,也不会是 NAT1。
证明. 没有见证时,「对称映射 + 端口受限过滤」与「映射稳定 + 端口受限过滤」
在观测上完全同形(两者都表现为 II / IV 不通)。任何确定的类型判定都会在这两种可能中猜一个,
而猜错的代价是把打不了洞的网络说成能打洞。代码在此处返回
TypeUnknown,同时把 Degraded 置为真,并把原因分成
no_witness(没拿到见证)与 drift_no_alt(观测到漂移但没有备用地址可测过滤)两种,
后台据此区分「链路问题」和「部署少配了一个 IP」。∎
四、逐条对应的代码
| 环节 | 位置 |
|---|---|
| 四个探针的编排、时序隔离 | internal/api/clienttest.go · runClientTest |
| 可比性见证(同一 socket + 唯一端点) | internal/api/clienttest.go · comparableMapping |
| 第二条连接的端点观测 | internal/ice/peer.go · WaitEndpoint |
| 判定树(漂移优先 → 过滤三分 → 否则不判定) | internal/nat/tester.go · judge |
| 对外唯一入口(两套探测共用) | internal/nat/export.go · Judge |
| 同事务 ID 重传、换地址请求 | internal/nat/client.go |
判定逻辑只有 judge 一处实现:服务端离线诊断与浏览器实测都调它,
所以同一个网络不会因为“走哪条路径”给出两种答案。
五、我们和其他站点的区别
| 常见做法 | 后果 | 本站的处理 |
|---|---|---|
| 只做换 IP / 换端口两个探测,不比对映射 | 对称 NAT 的过滤通常也是端口受限的,两者观测同形 → 把 NAT4 判成 NAT3(或反过来) | 增加测试 III,并要求同一 socket 的可比见证 |
| 先判过滤,再“顺带”看映射 | III 打开的通路被 II / IV 借走 → 受限型被判成全锥形 | III 固定放在最后,隔离时序 |
| 测不到就给一个默认类型 | “能打洞”的结论可能是猜的,用户拿它去改光猫只会白忙 | 输出「无法判定」,并给出结构化失败原因 |
六、这个证明的边界
诚实地说清楚适用范围,比多写十条结论更有用:
- 依赖双公网地址。测试 III 需要第二个公网地址(
ICE_PRIMARY_ADDR/ICE_ALTERNATE_ADDR)。 只配一个地址时,II 不通的情况会落到「无法判定」,而不是硬给一个 NAT2 / NAT3。 - 依赖浏览器支持 WebRTC。拿不到 ICE 通道时返回
no_ice,不会退回一个“看起来像”的类型。 - 假设 NAT 行为在秒级内稳定。四个探针在数百毫秒内完成;如果设备恰好在切换策略, 结论可能只代表那一刻的行为 —— 这也正是“改完光猫再测一次”有意义的原因。
这些不是宣传语:判定树的每个分支都能在 internal/nat/tester.go 里找到,
探针顺序能在 clienttest.go 里找到,失败原因码也都有对应的中文标签。
你也可以自己验一遍 —— 用两条不同网络各测一次,再对照我们给出的探针明细。