一、我们实际观测到了什么

判定 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 可比性:同一 socket ∧ 每个目的地址只观测到一个端点 只有满足它,两次映射之差才是「NAT 行为差」,而不是「两条连接的身份差」
I2 漂移优先:映射漂移 ⇒ 端点相关 ⇒ 非锥形 判定树的第一条分支,先于任何过滤结论
I3 时序隔离:测试 III 必须在 II / IV 之后跑 否则 III 打开的通路会被 II / IV“借”到,把受限型误判成全锥形

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 固定放在最后,隔离时序
测不到就给一个默认类型“能打洞”的结论可能是猜的,用户拿它去改光猫只会白忙输出「无法判定」,并给出结构化失败原因

六、这个证明的边界

诚实地说清楚适用范围,比多写十条结论更有用:

一句话概括:我们把「没测到」当成「不知道」,把「测到了」写成可以逐行核对的判定分支。 所以本站给出的类型不是一次测量的印象,而是一个在明确前提下的结论。

这些不是宣传语:判定树的每个分支都能在 internal/nat/tester.go 里找到, 探针顺序能在 clienttest.go 里找到,失败原因码也都有对应的中文标签。 你也可以自己验一遍 —— 用两条不同网络各测一次,再对照我们给出的探针明细。