passerma/turnserver 基于 coturn，配置 listening-port 与 relay-ip 为客户端分配中继地址。WebRTC 场景下浏览器需同时可达 STUN 3478 与动态 relay UDP 端口段。容器通常 --network host 或 -p 映射大段 UDP，Kubernetes 中 hostNetwork 与 privileged 带来安全风险；云环境更推荐托管 TURN 或专用 VM 部署。

快速启动

docker run -d --name turnserver \
  --network host \
  -e TURN_USERNAME=user \
  -e TURN_PASSWORD=secret \
  docker.io/passerma/turnserver:latest

推荐实践

docker run -d --name turnserver \
  --restart unless-stopped \
  --network host \
  -v /etc/turnserver.conf:/etc/coturn/turnserver.conf:ro \
  -e DETECT_EXTERNAL_IP=yes \
  docker.io/passerma/turnserver:4.6.2

核心参数说明

• --network host — UDP 中继需主机网络栈
• -v .../turnserver.conf:ro — realm、用户与端口段配置
• -e DETECT_EXTERNAL_IP — 自动写入公网 relay 地址
• UDP 端口段 — 防火墙需放行 min-port~max-port
• --restart unless-stopped — 中继服务持续在线
• K8s 不推荐 — hostNetwork + 大 UDP 范围运维复杂