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,再查找并解码映射属性。
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()运行命令:
python stun_binding.py预期输出示例(IP、端口和服务端地址会因运行环境而变化):
收到 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 打洞时,应将映射端点与后续的双向探测、入站过滤测试结合分析。