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 服务器。
启用长期凭据认证时,典型交互为:
- 客户端发送 Allocate Request,包含 REQUESTED-TRANSPORT=17。
- 服务器返回 401 Unauthorized,并提供 REALM 和 NONCE。
- 客户端使用用户名、密码、REALM 和 NONCE 构造认证信息,重新发送 Allocate Request。
- 服务器验证请求,创建 Allocation,并返回成功响应及分配属性。
- 客户端保存中继地址与有效期,随后使用 CreatePermission 或 ChannelBind 配置允许通信的对端。

从成功响应区分两种地址
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 和权限规则将数据转发给客户端。

这两个属性采用 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 报文。
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))预期输出:
('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 通过防火墙。在一台具有可用测试地址的服务器上执行:
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> 替换成服务器真实可达地址:
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 及中继端口范围内的报文:
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 重新安排下一次刷新,而不是沿用最初的固定截止时间。

Refresh 失败不能视为已续期。若收到 437 Allocation Mismatch,应重点检查 Allocation 是否已经过期、是否使用了错误的传输五元组,或是否错误地复用了原会话。重新 Allocate 可能得到不同的 relay 地址,因此还需要更新远端使用的候选信息。
另外,Allocation 生命周期与权限、ChannelBind 生命周期并不相同。Permission 通常有独立的 300 秒有效期;ChannelBind 通常有独立的 600 秒有效期。刷新 Allocation 不会自动延长所有 Permission 和 ChannelBind 的有效期,实际通信程序需要分别管理。
判断中继地址是否真正可用
一次成功的 Allocate 只能证明 TURN 服务器接受了分配请求。最终验收还应覆盖以下四项:
- 地址正确:从成功响应解析出的 XOR-RELAYED-ADDRESS 是服务器分配的可达中继端点,而不是 XOR-MAPPED-ADDRESS。
- 权限正确:针对远端 Peer 的 IP 建立 Permission,或建立有效 ChannelBind;不应把 Allocation 创建成功误认为权限已自动建立。
- 数据可达:远端向 relay 地址发送测试 UDP 数据,客户端通过 TURN 接收并验证内容;反向通过 Send Indication 或 ChannelData 发送数据也应成功。
- 生命周期正确:观察 Refresh 成功后有效期延长,停止刷新后资源最终过期,或发送 LIFETIME=0 后确认释放。
排查时按层次判断:401 持续出现先查认证;437 先查五元组与 Allocation 状态;Allocate 成功但 Peer 数据无法到达,先查 Permission、ChannelBind、服务器中继端口防火墙及公网地址映射。对于云 NAT 部署,还要确认服务器返回的中继公网地址与外部实际可达地址一致。
验收通过后,ICE 应把 XOR-RELAYED-ADDRESS 作为 relay 类型候选参与连通性检查,而把 XOR-MAPPED-ADDRESS 仅用于识别客户端对服务器呈现的映射端点。这样才能避免把 NAT 映射地址误当成 TURN 中继入口。