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

从 Allocate 响应取得中继地址

从 Allocate 响应取得中继地址

TURN 客户端不能直接把 STUN 探测得到的公网映射地址当作中继地址。本课通过一次完整的 Allocate 交互,识别响应中的 XOR-RELAYED-ADDRESS、XOR-MAPPED-ADDRESS 和 LIFETIME,使用 coturn 日志与抓包验证 Allocation 已创建,并掌握刷新与释放方法。

学习目标

  • 解释 Allocate 请求、401 认证挑战和成功响应的交互过程。
  • 正确解析中继传输地址、客户端映射地址和 Allocation 生命周期。
  • 使用 coturn 与抓包工具验证中继地址分配、刷新和释放。

Allocate 如何创建中继分配

TURN(Traversal Using Relays around NAT)允许客户端向 TURN 服务器申请一个中继传输地址。服务器为客户端建立 Allocation,并将收到的对端数据经中继路径转发。Allocate 是 TURN 方法,属于基于 STUN 消息格式的请求与响应交互。

客户端通常从本地 UDP Socket 向 TURN 服务器发送 Allocate Request,并携带 REQUESTED-TRANSPORT 属性。对于 UDP 中继,属性的协议编号为 17,即 UDP 的 IANA 协议号。这里指定的是服务器中继端使用的传输协议,并不表示客户端到服务器之间必须使用 UDP;客户端也可以通过 TCP 或 TLS 连接 TURN 服务器。

启用长期凭据认证时,典型交互为:

  1. 客户端发送 Allocate Request,包含 REQUESTED-TRANSPORT=17。
  2. 服务器返回 401 Unauthorized,并提供 REALM 和 NONCE。
  3. 客户端使用用户名、密码、REALM 和 NONCE 构造认证信息,重新发送 Allocate Request。
  4. 服务器验证请求,创建 Allocation,并返回成功响应及分配属性。
  5. 客户端保存中继地址与有效期,随后使用 CreatePermission 或 ChannelBind 配置允许通信的对端。

TURN Allocate 认证与中继地址分配时序

从成功响应区分两种地址

Allocate Success Response 中最容易混淆的是 XOR-RELAYED-ADDRESS 与 XOR-MAPPED-ADDRESS。二者都可能是公网地址,但承担完全不同的职责。

假设实验环境使用以下地址,均为文档示例地址,不代表实际部署结果:

属性或端点 示例值 含义
客户端本地 Socket 192.168.1.20:50000 客户端实际绑定的本地端点
TURN 服务器监听地址 203.0.113.10:3478 客户端发送 Allocate 的服务器端点
XOR-MAPPED-ADDRESS 198.51.100.25:62000 TURN 服务器观察到的客户端源地址
XOR-RELAYED-ADDRESS 203.0.113.10:49160 服务器分配给客户端的中继传输地址
LIFETIME 600 秒 本次 Allocation 的剩余有效期

XOR-MAPPED-ADDRESS 描述客户端到达 TURN 服务器时呈现的地址。在 NAT 场景中,它通常是 NAT 转换后的公网 IP 与端口,但在没有 NAT 时也可能是客户端自身的地址。它用于观察映射,并不是 TURN 中继地址。

XOR-RELAYED-ADDRESS 是 TURN 服务器分配的传输端点。客户端需要将该地址作为 ICE 的 relay 候选交给远端。远端向该地址发送数据后,TURN 服务器才有机会按 Allocation 和权限规则将数据转发给客户端。

TURN 客户端映射地址与中继地址的网络关系

这两个属性采用 XOR 编码,不是直接存储明文 IP 和端口。按照 RFC 5389,端口与 STUN Magic Cookie 的高 16 位异或;IPv4 地址与 32 位 Magic Cookie 异或。IPv6 地址则使用 Magic Cookie 和 96 位 Transaction ID 组成的 128 位掩码。

以下 Python 3 示例使用标准库还原一个 IPv4 XOR-ADDRESS 属性值中的地址和端口。输入为已提取的属性值字节,而非完整 STUN 报文。

python
import ipaddress
import struct

MAGIC_COOKIE = 0x2112A442


def decode_xor_ipv4(value: bytes):
    # 属性值为保留字节、地址族、X-Port和X-Address,共8字节
    if len(value) != 8 or value[0] != 0 or value[1] != 0x01:
        raise ValueError("需要合法的IPv4 XOR-ADDRESS属性值")
    encoded_port = struct.unpack("!H", value[2:4])[0]
    encoded_ip = struct.unpack("!I", value[4:8])[0]
    port = encoded_port ^ (MAGIC_COOKIE >> 16)
    ip = ipaddress.IPv4Address(encoded_ip ^ MAGIC_COOKIE)
    return str(ip), port


# 构造示例属性值,再验证解码结果
original_ip = int(ipaddress.IPv4Address("203.0.113.10"))
original_port = 49160
value = bytes([0, 1]) + struct.pack(
    "!HI", original_port ^ (MAGIC_COOKIE >> 16), original_ip ^ MAGIC_COOKIE
)
print(decode_xor_ipv4(value))

预期输出:

text
('203.0.113.10', 49160)

实际解析完整 STUN 响应时,还需要检查消息类型、Transaction ID、属性类型与长度,并验证适用的消息完整性。不能只在 UDP 字节流中搜索某个 IP 字节序列就认定取得了中继地址。

用 coturn 验证 Allocate 响应

可以在隔离测试环境中运行 coturn,并使用其附带的 turnutils_uclient 发起分配测试。以下示例适用于提供 turnserver 和 turnutils_uclient 命令的 coturn 4.6.x;不同发行版的安装路径与日志细节可能不同。

先确保测试主机的 UDP 3478 端口可用,并允许 UDP 中继端口范围 49160~49200 通过防火墙。在一台具有可用测试地址的服务器上执行:

bash
turnserver --no-cli --no-tls --no-dtls --lt-cred-mech --realm=lab.example --user=demo:demo-pass --listening-port=3478 --min-port=49160 --max-port=49200 --verbose

这里使用长期凭据认证,用户名为 demo,密码为 demo-pass。示例未配置 --listening-ip 和 --external-ip,适用于服务器网络接口地址可直接供客户端访问的实验环境。若服务器位于云 NAT 后方,必须根据实际内外网地址配置 external-ip 映射,否则返回的 relay 地址可能无法从公网到达。

在另一台可以访问该服务器的测试机上执行以下命令,把 <TURN_SERVER_IP> 替换成服务器真实可达地址:

bash
turnutils_uclient -u demo -w demo-pass -p 3478 -n 1 -m 1 <TURN_SERVER_IP>

-u 和 -w 分别指定用户名与密码,-p 指定服务器端口,-n 1 将测试消息数设为 1,-m 1 将客户端数量设为 1。turnutils_uclient 是测试工具,不是通用 TURN 报文解码器;它可能继续创建权限并进行传输测试,而非仅执行 Allocate。

预期结果:客户端能够完成认证和分配,服务器日志中出现成功的 Allocate 或新建 Allocation 相关记录,随后可能出现权限创建、数据传输与会话结束记录。具体日志措辞、会话 ID、地址和端口随 coturn 版本及运行环境变化,不能将示例地址当成固定输出。

为直接查看响应属性,可以在服务器端抓取 UDP 3478 及中继端口范围内的报文:

bash
sudo tcpdump -ni any -s 0 -w /tmp/turn-allocate.pcap 'udp port 3478 or udp portrange 49160-49200'

预期结果:命令开始捕获报文,测试客户端执行后生成 /tmp/turn-allocate.pcap。使用 Ctrl+C 停止抓包,再用 Wireshark 打开文件,过滤表达式填写 stun,定位与 Allocate Request 具有相同 Transaction ID 的成功响应,并展开 TURN/STUN 属性。

检查结果应包含:

  • 响应消息类型为 Allocate Success Response,对应 STUN 类型编码 0x0103。
  • 存在 XOR-RELAYED-ADDRESS,地址与服务器分配的中继端点一致。
  • 存在 XOR-MAPPED-ADDRESS,地址反映服务器观察到的客户端源端点。
  • 存在 LIFETIME,其单位为秒;实验服务器实际返回值不必等于请求值。

Allocation 的刷新与过期

Allocation 不是永久资源。RFC 8656 规定,Allocation 通过客户端到服务器的传输五元组进行标识,包含客户端与服务器的 IP、端口及传输协议。即使认证用户名相同,客户端更换本地 Socket 或经过 NAT 后源端口变化,也不能直接假设原 Allocation 仍可复用。

客户端可在 Allocate Request 中携带 LIFETIME 请求特定有效期。服务器根据协议约束与本地策略决定实际值,并在成功响应中返回最终 LIFETIME。通常默认 Allocation 生命周期为 600 秒;不能只依赖客户端请求的时长安排刷新。

成功创建 Allocation 后,客户端通过 Refresh Request 延长或终止它:

操作 请求内容 预期行为
创建 Allocate,REQUESTED-TRANSPORT=17 创建 Allocation 并返回中继地址
刷新 Refresh,LIFETIME=600 请求延长生命周期,以成功响应实际值为准
删除 Refresh,LIFETIME=0 请求立即删除 Allocation,成功后释放中继资源
超时 不再发送有效 Refresh Allocation 到期后由服务器清理

例如,服务器返回 LIFETIME=600 秒时,客户端可以在创建成功后约 300 秒发送 Refresh,留出网络抖动与重试空间。收到成功响应后,应根据新返回的 LIFETIME 重新安排下一次刷新,而不是沿用最初的固定截止时间。

TURN Allocation 创建刷新与过期状态图

Refresh 失败不能视为已续期。若收到 437 Allocation Mismatch,应重点检查 Allocation 是否已经过期、是否使用了错误的传输五元组,或是否错误地复用了原会话。重新 Allocate 可能得到不同的 relay 地址,因此还需要更新远端使用的候选信息。

另外,Allocation 生命周期与权限、ChannelBind 生命周期并不相同。Permission 通常有独立的 300 秒有效期;ChannelBind 通常有独立的 600 秒有效期。刷新 Allocation 不会自动延长所有 Permission 和 ChannelBind 的有效期,实际通信程序需要分别管理。

判断中继地址是否真正可用

一次成功的 Allocate 只能证明 TURN 服务器接受了分配请求。最终验收还应覆盖以下四项:

  1. 地址正确:从成功响应解析出的 XOR-RELAYED-ADDRESS 是服务器分配的可达中继端点,而不是 XOR-MAPPED-ADDRESS。
  2. 权限正确:针对远端 Peer 的 IP 建立 Permission,或建立有效 ChannelBind;不应把 Allocation 创建成功误认为权限已自动建立。
  3. 数据可达:远端向 relay 地址发送测试 UDP 数据,客户端通过 TURN 接收并验证内容;反向通过 Send Indication 或 ChannelData 发送数据也应成功。
  4. 生命周期正确:观察 Refresh 成功后有效期延长,停止刷新后资源最终过期,或发送 LIFETIME=0 后确认释放。

排查时按层次判断:401 持续出现先查认证;437 先查五元组与 Allocation 状态;Allocate 成功但 Peer 数据无法到达,先查 Permission、ChannelBind、服务器中继端口防火墙及公网地址映射。对于云 NAT 部署,还要确认服务器返回的中继公网地址与外部实际可达地址一致。

验收通过后,ICE 应把 XOR-RELAYED-ADDRESS 作为 relay 类型候选参与连通性检查,而把 XOR-MAPPED-ADDRESS 仅用于识别客户端对服务器呈现的映射端点。这样才能避免把 NAT 映射地址误当成 TURN 中继入口。

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

目录与阅读设置

阅读设置

17

记录一个想法

从 Allocate 响应取得中继地址

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

登录哪都通