P2P 与分布式存储 / 系统课时

验证同一 NAT 下的 Hairpin

验证同一 NAT 下的 Hairpin

本课通过两个位于同一网关后的节点,验证它们能否使用网关的公网映射地址完成 UDP 通信。你将搭建端口转发、运行收发程序,并根据内网直连、公网映射访问和外网访问三组结果,判断网关是否支持 NAT Hairpinning。

学习目标

  • 理解 NAT Hairpinning 的工作方式,以及它与普通端口转发的区别。
  • 使用两个内网节点和 UDP 测试程序验证公网映射地址的回环访问能力。
  • 根据对照测试区分 Hairpin 不支持、端口映射错误及网络环境限制。

测试拓扑与前置条件

准备同一局域网内的节点 A、节点 B 和支持配置 UDP 端口转发的网关。假设 A 的内网地址为 192.168.1.10,B 的地址为 192.168.1.20,网关公网地址为实际可用的 PUBLIC_IP。

在网关中添加一条 UDP 转发规则:公网 UDP 端口 19000 转发到 192.168.1.10:9000。A 上的测试程序监听 9000/UDP,B 分别访问 A 的内网地址和网关公网地址。端口号仅为本例的测试值,应根据实际环境调整。

同一 NAT 下的 Hairpin UDP 测试拓扑

测试前先检查以下条件:

  • A 和 B 确实位于同一台 NAT 网关之后,且两者能正常互相访问。
  • A 的防火墙允许 UDP 9000 入站;B 的出站策略允许 UDP 测试流量。
  • 网关的 UDP 19000 端口转发指向正确的内网地址与端口。
  • 网关拿到的是可用于外部访问的公网地址。如果运营商使用 CGNAT 或上游还存在无法配置的 NAT,外网访问失败不能直接证明 Hairpin 不受支持。

编写 UDP 回显测试程序

使用 Python 3 标准库编写一个同时支持服务端和客户端模式的测试程序。服务端运行在 A 上,客户端运行在 B 上。客户端发送固定探测消息,服务端收到后回复固定响应,避免仅凭客户端发送成功就误判链路正常。

将以下内容保存为 hairpin_test.py:

python
import argparse
import socket

SERVER_PORT = 9000
PUBLIC_PORT = 19000
TIMEOUT_SECONDS = 5


def run_server():
    # 绑定所有本地 IPv4 接口,以便接收网关转发的流量。
    with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as sock:
        sock.bind(("0.0.0.0", SERVER_PORT))
        print(f"listening UDP :{SERVER_PORT}", flush=True)
        data, peer = sock.recvfrom(2048)
        print(f"received: {data.decode(errors='replace')}", flush=True)
        sock.sendto(b"hairpin-ok", peer)
        print("reply sent", flush=True)


def run_client(host, port):
    with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as sock:
        sock.settimeout(TIMEOUT_SECONDS)
        sock.sendto(b"hairpin-probe", (host, port))
        print(f"sent probe to {host}:{port}")
        try:
            data, peer = sock.recvfrom(2048)
            print(f"response from {peer[0]}:{peer[1]}: {data.decode(errors='replace')}")
        except socket.timeout:
            print(f"timeout: no response within {TIMEOUT_SECONDS} seconds")


parser = argparse.ArgumentParser(description="UDP NAT Hairpin test")
subparsers = parser.add_subparsers(dest="mode", required=True)
subparsers.add_parser("server", help="run on node A")
client_parser = subparsers.add_parser("client", help="run on node B")
client_parser.add_argument("host", help="gateway public IPv4 address")
client_parser.add_argument("--port", type=int, default=PUBLIC_PORT)
args = parser.parse_args()

if args.mode == "server":
    run_server()
else:
    run_client(args.host, args.port)

在节点 A 上启动服务端:

bash
python hairpin_test.py server

预期输出:

text
listening UDP :9000

保持服务端进程运行。若系统中 python 指向的不是 Python 3,请改用 python3;Windows 上也可使用 py -3。

执行三组对照测试

先在 B 上访问 A 的内网地址,确认应用本身能够正常收发。该操作使用同一个客户端程序,只把目的地址设为 192.168.1.10:9000。

bash
python hairpin_test.py client 192.168.1.10 --port 9000

预期结果:

text
sent probe to 192.168.1.10:9000
response from 192.168.1.10:9000: hairpin-ok

然后在 B 上访问网关的公网映射地址。将命令中的 PUBLIC_IP 替换为网关实际的公网 IPv4 地址,不要输入尖括号。

bash
python hairpin_test.py client PUBLIC_IP --port 19000

预期结果(支持 Hairpin 且规则正确时):

text
sent probe to PUBLIC_IP:19000
response from PUBLIC_IP:19000: hairpin-ok

客户端显示的响应来源地址取决于网关执行的地址转换方式;具体端口和地址可能不同。关键验收条件是客户端收到内容为 hairpin-ok 的响应,而不是来源地址必须与公网映射完全相同。

最后使用真正位于网关外部的设备执行相同的公网地址测试。外部设备可使用另一条网络连接,例如移动数据网络。如果外部测试成功而内网客户端访问公网地址失败,则 Hairpin 支持缺失或相关回环策略是重点排查方向,但仍需排除网关访问控制和内网客户端配置差异。

根据测试结果定位故障

内网直连 同 NAT 访问公网映射 外网访问公网映射 判断与下一步
成功 成功 成功 UDP 服务和映射基本正常,网关支持当前测试路径的 Hairpin。
成功 失败 成功 优先检查 NAT 回环支持、Hairpin 策略和内外部访问规则。
成功 失败 失败 先检查公网地址、UDP 转发、运营商 CGNAT、网关防火墙及上游网络。
失败 失败 任意 先排查服务端是否运行、内网地址是否正确及主机防火墙;暂不能据此判定 Hairpin。

服务端在收到探测消息后会记录 received: hairpin-probe。如果 B 显示超时,应检查 A 是否收到了该记录:收到但客户端无响应,说明请求到达服务端,需继续检查回复路径与防火墙;完全没有收到,则优先检查请求转发路径和网关策略。必要时可在 A 上抓取 UDP 9000 端口流量,确认探测包是否进入内网。

Hairpin 成功与失败的机制区别

普通端口转发处理的是外部主机发往公网映射地址的数据包;Hairpin 则要求网关处理来自内部节点、目的地却是自身公网映射地址的数据包,并将其转回对应的内部节点。网关通常需要对目的地址进行转换,有时还要转换源地址,避免响应沿错误路径返回。

某些网关不支持 NAT 回环,或默认关闭相关功能。此时内网节点可以直接使用 192.168.1.10:9000 通信,却无法经 PUBLIC_IP:19000 访问同一服务。这并不代表 UDP 本身不可用,也不能据此推断所有 NAT 穿透方式都会失败。

若业务必须支持同一局域网和公网客户端使用同一个服务地址,可启用设备明确提供的 NAT Loopback、NAT Reflection 或 Hairpin NAT 功能;具体菜单名称依厂商而异。另一种方案是在客户端配置内外网地址解析策略,让局域网客户端解析到服务的内网地址。两种方案都应重新执行三组测试,并在网关重启或地址变化后再次验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

验证同一 NAT 下的 Hairpin

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通