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

读取 STUN Binding 返回的映射

读取 STUN Binding 返回的映射

通过发送 STUN Binding Request 并解析成功响应,可以获得 STUN 服务器观察到的公网映射 IP 和端口。本文使用 Python 标准库实现 UDP 请求、事务匹配和 XOR-MAPPED-ADDRESS 解码,帮助你判断 NAT 为本地套接字分配了哪个外部端点。

学习目标

  • 构造符合 RFC 5389 的 STUN Binding 请求,并理解事务 ID 的用途。
  • 正确解析 XOR-MAPPED-ADDRESS 属性,解码 IPv4 或 IPv6 映射地址。
  • 运行程序获取映射端点,并识别超时、响应不匹配等常见问题。

理解 Binding 请求和映射地址

STUN 客户端向 STUN 服务器发送 UDP Binding Request。服务器根据实际收到的数据报,识别其源 IP 和源端口,并在 Binding Success Response 中通过 XOR-MAPPED-ADDRESS 返回该端点。客户端读取的不是本机网卡上的私有地址,而是服务器观察到的外部映射。

STUN 消息头固定为 20 字节,包含消息类型、消息长度、魔术字和 96 位事务 ID。Binding Request 的消息类型为 0x0001,成功响应类型为 0x0101,魔术字为 0x2112A442。没有属性的请求长度为 0。

XOR-MAPPED-ADDRESS 的属性类型是 0x0020。其数据包含保留字段、地址族、经过异或处理的端口和地址。IPv4 地址与魔术字异或;IPv6 地址与魔术字和事务 ID 拼接形成的 128 位掩码异或。端口则与魔术字的高 16 位异或。因此,不能直接把属性中的字节当作明文 IP 和端口读取。

用 Python 发送请求并解析响应

以下程序只依赖 Python 标准库。示例使用 stun.l.google.com:19302 作为 UDP STUN 服务端;运行环境需要能够解析域名并访问该 UDP 端口。程序会校验响应类型、魔术字和事务 ID,再查找并解码映射属性。

python
import secrets
import socket
import struct
import ipaddress

MAGIC_COOKIE = 0x2112A442
STUN_SERVER = ("stun.l.google.com", 19302)


def parse_xor_mapped_address(packet, transaction_id):
    if len(packet) < 20:
        raise ValueError("STUN 响应头不完整")

    msg_type, msg_length, cookie, response_id = struct.unpack(
        "!HHI12s", packet[:20]
    )

    if msg_type != 0x0101:
        raise ValueError(f"不是 Binding Success Response: 0x{msg_type:04x}")
    if cookie != MAGIC_COOKIE:
        raise ValueError("STUN 魔术字不匹配")
    if response_id != transaction_id:
        raise ValueError("事务 ID 不匹配")
    if msg_length % 4 != 0 or len(packet) < 20 + msg_length:
        raise ValueError("STUN 属性区长度无效或数据不完整")

    end = 20 + msg_length
    offset = 20

    while offset + 4 <= end:
        attr_type, attr_length = struct.unpack(
            "!HH", packet[offset:offset + 4]
        )
        value_start = offset + 4
        value_end = value_start + attr_length
        if value_end > end:
            raise ValueError("STUN 属性长度越界")

        value = packet[value_start:value_end]
        if attr_type == 0x0020:
            if len(value) < 4:
                raise ValueError("XOR-MAPPED-ADDRESS 属性过短")

            family = value[1]
            xor_port = struct.unpack("!H", value[2:4])[0]
            port = xor_port ^ (MAGIC_COOKIE >> 16)

            if family == 0x01 and len(value) == 8:
                mask = struct.pack("!I", MAGIC_COOKIE)
                address_bytes = bytes(
                    a ^ b for a, b in zip(value[4:8], mask)
                )
            elif family == 0x02 and len(value) == 20:
                mask = struct.pack("!I", MAGIC_COOKIE) + transaction_id
                address_bytes = bytes(
                    a ^ b for a, b in zip(value[4:20], mask)
                )
            else:
                raise ValueError("地址族或属性长度无效")

            return str(ipaddress.ip_address(address_bytes)), port

        offset = value_start + ((attr_length + 3) // 4) * 4

    raise ValueError("响应中没有 XOR-MAPPED-ADDRESS 属性")


def main():
    transaction_id = secrets.token_bytes(12)
    request = struct.pack(
        "!HHI12s", 0x0001, 0, MAGIC_COOKIE, transaction_id
    )

    addresses = socket.getaddrinfo(
        STUN_SERVER[0], STUN_SERVER[1], type=socket.SOCK_DGRAM
    )
    last_error = None

    for family, socktype, proto, _, server_address in addresses:
        try:
            with socket.socket(family, socktype, proto) as sock:
                sock.settimeout(3.0)
                sock.sendto(request, server_address)
                packet, peer = sock.recvfrom(2048)

            # 本例检查事务关联与映射属性;只接受预期服务端返回的数据。
            print(f"收到 STUN 响应,来源:{peer[0]}:{peer[1]}")
            mapped_ip, mapped_port = parse_xor_mapped_address(
                packet, transaction_id
            )
            print(f"STUN 观察到的映射端点:{mapped_ip}:{mapped_port}")
            return
        except (OSError, ValueError) as exc:
            last_error = exc

    raise RuntimeError(f"STUN 探测失败:{last_error}")


if __name__ == "__main__":
    main()

运行命令:

bash
python stun_binding.py

预期输出示例(IP、端口和服务端地址会因运行环境而变化):

text
收到 STUN 响应,来源:<STUN服务器IP>:19302
STUN 观察到的映射端点:<公网映射IP>:<映射端口>

校验解码结果与协议边界

解析属性时要按网络字节序读取 16 位和 32 位整数,并根据属性长度跳过填充字节。STUN 属性长度不包含填充部分,属性在消息中按 4 字节边界对齐。示例同时支持 IPv4 的 8 字节属性值和 IPv6 的 20 字节属性值;遇到长度不符、事务 ID 不一致或属性缺失时会报错,而不是把错误数据当成公网地址。

排查时先确认 DNS 能解析 STUN 服务端,再检查本机或云网络是否允许 UDP 出站及返回流量。程序设置了 3 秒接收超时;超时只说明此次探测未收到可用响应,不能单独证明 NAT 不支持 UDP 打洞。必要时换用可信且可访问的 STUN 服务端重试,并确认服务端确实返回 Binding Success Response。

还要注意,STUN 结果只描述这次请求中服务器观察到的映射端点。不同 NAT、目标地址、网络接口或映射生命周期可能产生不同结果;单次 Binding 响应不能完整判定 NAT 的过滤行为,也不能保证另一对等节点一定能直接连通。进行 UDP 打洞时,应将映射端点与后续的双向探测、入站过滤测试结合分析。

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

目录与阅读设置

阅读设置

17

记录一个想法

读取 STUN Binding 返回的映射

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

登录哪都通