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

部署 coturn 并检查端口可达

部署 coturn 并检查端口可达

本课在 Ubuntu 24.04 LTS 上部署 coturn,配置 TURN 监听端口、公网映射地址和中继端口范围,并从另一张网络验证服务是否真正可用。完成后,你将得到一个可供 P2P 客户端进行中继回退的 TURN 服务端点,同时能区分端口开放、认证成功和实际中继成功这三种不同结果。

学习目标

  • 安装 coturn,正确配置监听地址、外部地址、认证和中继端口范围。
  • 配置主机防火墙及云安全组,理解 TURN 控制连接与中继数据流的区别。
  • 从外部网络验证 TURN Allocate、Relay 数据传输,并定位常见失败原因。

检查部署环境与网络端口

本例使用 Ubuntu 24.04 LTS、coturn 发行版软件包和一台具有公网 IPv4 地址的 Linux 服务器。示例公网地址为 203.0.113.10,属于文档保留地址,实际操作时必须替换为自己服务器的真实公网 IP。

先检查操作系统、网卡地址和默认路由:

bash
cat /etc/os-release
ip -br -4 addr
ip -4 route show default

预期结果:系统信息包含 Ubuntu 24.04,能够看到服务器网卡 IPv4 地址及默认路由。网卡名称和实际地址因环境不同而变化。

TURN 部署至少涉及两类端口:

用途 本例端口 协议 说明
TURN/STUN 监听 3478 UDP UDP Allocate、Binding 及后续 TURN 消息
TURN 监听 3478 TCP TCP 传输的 TURN 控制连接及数据承载
TURN 中继地址 49160–49259 UDP 分配给客户端的 UDP Relay 端口
TURN over TLS 5349 TCP 可选,配置证书并启用 TLS 后使用

本课先部署 3478 的 UDP/TCP 服务和 UDP 中继,不启用 TLS。TCP 3478 可连接不代表 TCP 中继已经配置完成;本例中通过 TCP 连接 TURN 服务器的客户端仍然申请 UDP Relay 地址。

如果服务器直接绑定公网 IP,listening-ip 与 external-ip 可以使用该公网地址。如果服务器位于云厂商的一对一公网 NAT 后面,listening-ip 应使用网卡实际私网地址,external-ip 则使用公网地址,并确保云平台完成相应端口转发。

安装 coturn 并配置服务

使用 Ubuntu 官方软件仓库安装,不依赖第三方脚本。执行:

bash
sudo apt update
sudo apt install -y coturn
turnserver --version

预期结果:安装命令成功结束,最后一条命令显示本机安装的 coturn 版本。具体版本号以 Ubuntu 软件仓库为准。

编辑 /etc/turnserver.conf。以下是可独立使用的配置示例,假设服务器网卡直接拥有公网地址 203.0.113.10。部署前将地址、域名及密码替换为真实值。

ini
# TURN 控制端点:UDP/TCP 共用监听端口
listening-port=3478
listening-ip=203.0.113.10
relay-ip=203.0.113.10
external-ip=203.0.113.10

# 限定 UDP Relay 端口范围
min-port=49160
max-port=49259

# 长期凭据认证,realm 应在部署后保持稳定
lt-cred-mech
realm=turn.example.com
user=demo:ReplaceWithAStrongSecret
fingerprint

# 不开放匿名 TURN,禁止危险的回环中继目标
no-cli
no-loopback-peers

这里的 turn.example.com 是示例域名,不要求本课必须先完成 DNS 解析;客户端可直接连接公网 IP。realm 是 TURN 长期凭据认证的一部分,修改后可能影响现有客户端的认证配置。

如果服务器处于一对一 NAT 后面,例如网卡地址为 10.0.1.20、公网地址为 203.0.113.10,则将上例三个地址参数改为:

ini
# 片段示例:替换上一份配置中的三个地址字段
listening-ip=10.0.1.20
relay-ip=10.0.1.20
external-ip=203.0.113.10/10.0.1.20

这段是配置片段,依赖前面的完整配置及云平台的一对一 NAT 映射。external-ip 的斜杠形式用于声明公网地址与本地中继地址的对应关系。多网卡、多公网 IP 或非一对一映射环境必须单独核对,不能机械套用。

coturn监听地址与公网中继地址映射结构图

生产环境不建议长期使用配置文件中的固定演示账号。至少替换为强随机密码,并限制配置文件读取权限;对公开互联网提供服务时,通常进一步采用 TURN REST API 风格的临时凭据或其他适当的凭据管理方案。

设置权限并启动服务:

bash
sudo chown root:turnserver /etc/turnserver.conf
sudo chmod 640 /etc/turnserver.conf
sudo systemctl enable --now coturn
sudo systemctl restart coturn
sudo systemctl is-active coturn
sudo ss -lunpt | grep ':3478'

预期输出中,服务状态应为:

text
active

同时应能在 ss 输出中找到监听 3478 的 UDP 和 TCP Socket。进程名、PID 和地址格式依机器而异。部分 Ubuntu 安装环境还使用 /etc/default/coturn 中的 TURNSERVER_ENABLED 开关;如果服务没有按预期启动,应检查该文件及 systemctl cat coturn 显示的实际启动配置。

放通防火墙与公网映射

服务进程监听成功只证明本机 Socket 已建立,不能证明互联网客户端能访问。必须同时检查主机防火墙、云安全组和云 NAT 转发规则。

如果服务器使用 UFW,执行:

bash
sudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 49160:49259/udp
sudo ufw status verbose

预期结果:UFW 规则列表包含 3478/UDP、3478/TCP 和 49160:49259/UDP 的允许规则。如果 UFW 当前处于 inactive 状态,添加规则不会自动启用防火墙;不要在未确认 SSH 放行规则之前远程执行 ufw enable。

在云厂商安全组中同步添加对应的入站规则。若部署在公网 NAT 后面,还必须确认监听端口与中继端口范围均正确映射到 coturn 所在主机,而不是只映射 3478。

需要注意:中继端口并不一定在服务启动时全部处于监听状态。coturn 通常在客户端成功执行 Allocate 后才分配具体 Relay 端口,因此不能用启动时的 ss 列表判断整个中继端口范围是否配置成功。

100 个 UDP 端口只是本课的实验配置,不意味着一定能同时服务 100 个完整 P2P 会话。实际容量取决于 Allocate 数量、客户端传输方式、端口分配、带宽及服务端资源限制。不要直接将端口数量等同于并发用户数。

从外部网络验证 TURN 服务

验证应分三层进行:检查服务端口、完成带认证的 TURN Allocate、确认数据确实通过 Relay 转发。建议使用另一台云主机或手机热点下的 Linux 客户端,避免测试流量只在服务器本机回环。

先在外部 Linux 主机安装 coturn 工具:

bash
sudo apt update
sudo apt install -y coturn
command -v turnutils_uclient

预期结果:最后一条命令输出 turnutils_uclient 的可执行文件路径,具体路径随发行版而异。

从外部主机测试 TCP 控制端口:

bash
nc -vz -w 3 203.0.113.10 3478

预期结果:当 TCP 端口可达时,nc 报告连接成功;输出措辞因 netcat 实现不同而异。该结果不能证明 UDP 3478 或 UDP Relay 端口可用。

使用 coturn 自带的 TURN 测试工具进行带认证的 Allocate 与数据传输测试:

bash
turnutils_uclient -v -u demo -w 'ReplaceWithAStrongSecret' -p 3478 203.0.113.10

这条命令使用默认 UDP 传输方式连接 TURN 服务。它会尝试进行 TURN 认证、分配及测试数据传输;具体测试模式和输出格式取决于安装的 coturn 版本。执行前应确认密码与服务端一致,且服务端已经重启加载配置。

预期结果:测试工具能够完成认证与分配,显示成功的数据收发统计,并以成功状态退出。若出现认证失败、Allocate 失败或收发统计异常,不应判定通过。某些 coturn 版本的 turnutils_uclient 默认测试模式需要可用的对端或测试服务器配合,不能仅凭一条命令的退出状态断言双端中继已经验证。

为了观察实际 Relay 分配,在服务器上另开终端:

bash
sudo journalctl -u coturn -f

预期结果:当外部客户端发起 TURN 请求时,日志中出现对应会话、认证或分配活动。具体字段、时间、端口和会话 ID 会因版本及配置不同而变化。日志若没有请求记录,应优先检查公网地址、云安全组和 UDP 入站路径。

更完整的验收应使用两个位于不同网络的 WebRTC 或 ICE 测试客户端,将 ICE 服务器配置为 turn:真实公网IP:3478?transport=udp,填写与服务端匹配的用户名和密码,并强制使用 relay 候选进行一次实际数据传输。抓包或客户端 ICE 统计中应能观察到 relay 候选及实际收发字节增长,而不只是 STUN Binding 成功。

根据失败位置定位问题

观察现象 优先检查 修复方向
TCP 3478 不可连接 服务状态、监听地址、安全组 修正监听 IP 并开放 TCP 3478
UDP 请求无响应 UDP 3478、云 NAT、主机防火墙 检查 UDP 转发及入站规则
返回 401 Unauthorized 是否为认证挑战、凭据与 realm 初次 401 可能是正常挑战,检查后续认证是否成功
Allocate 成功但对端收不到数据 Relay 地址、UDP 端口范围、权限 检查 external-ip 与中继端口转发
部分网络始终无法使用 UDP 网络对 UDP 的限制 增加 TCP/TLS 接入方案并单独测试

TURN 长期凭据认证通常先由服务器返回 401 挑战,客户端获取 realm 与 nonce 后重新提交带认证信息的请求。因此日志中出现一次 401 不一定是故障;连续认证失败才需要检查账号、密码、realm 或客户端实现。

可在服务器上抓取 TURN 控制报文和指定中继端口范围内的 UDP 流量:

bash
sudo tcpdump -ni any 'udp port 3478 or tcp port 3478 or udp portrange 49160-49259'

预期结果:外部客户端测试时能够观察到相应的数据包,实际源地址、目的地址和端口因会话而变化。如果只看到 3478 上的请求,却没有中继数据,应结合 Allocate 响应、Permission、ChannelBind 或 Send Indication 的实际行为进一步排查。抓到 UDP 包也不等于 TURN 应用层已成功处理。

最终通过标准是:外部客户端能够访问 TURN 服务、凭据认证成功、获得预期公网 Relay 地址,并且两端在强制中继模式下可以实际交换数据。完成这四项检查后,才可以将该 coturn 实例作为 P2P 直连失败时的候选回退路径。

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

目录与阅读设置

阅读设置

17

记录一个想法

部署 coturn 并检查端口可达

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

登录哪都通