asanrom/turn-server

TURN服务器

这是一个适用于WebRTC应用的TURN服务器，基于https://github.com/pion/turn%E5%B7%A5%E5%85%B7%E5%8C%85%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%94%A8%E4%BA%8E%E8%A7%A3%E5%86%B3NAT%E7%A9%BF%E8%B6%8A%E9%97%AE%E9%A2%98%EF%BC%8C%E7%A1%AE%E4%BF%9D%E7%AB%AF%E5%88%B0%E7%AB%AF%E5%AE%9E%E6%97%B6%E9%80%9A%E4%BF%A1%E9%A1%BA%E7%95%85%E3%80%82

仓库地址：https://github.com/AgustinSRG/turn-server

镜像概述

本镜像提供轻量、可配置的TURN服务，支持UDP、TCP、TLS三种传输协议，具备静态用户列表、动态令牌、认证回调等多种认证方式，可满足WebRTC应用（如视频通话、实时协作）的NAT穿越需求。

核心功能

1. 支持UDP/TCP/TLS多传输协议
2. 灵活认证机制：静态用户、令牌认证、认证回调
3. 可配置RTP中继端口范围
4. 细粒度日志级别控制（ERROR/WARNING/INFO/DEBUG/TRACE）
5. TLS证书自动重载（基于时间间隔检测）

使用场景

• WebRTC视频会议/远程教学平台
• 实时音视频直播系统
• P2P文件传输工具
• 需要NAT穿越的实时通信应用

配置说明

通过环境变量配置服务器，关键配置项如下：

基础配置

RTP中继端口

注意：需开放该范围的UDP端口

认证配置

监听器配置

（UDP/TCP/TLS监听器均支持ENABLED/PORT/BIND_ADDRESS参数，示例以UDP为例）

日志配置

认证机制说明

认证令牌

• 用户名格式：turn/{时间戳}/{过期时间}/{用户ID}（时间戳为UNIX秒级）
• 密码生成：用户名+AUTH_SECRET拼接后计算SHA-256哈希，转小写十六进制

Go语言生成密码示例：

go
import (
  "crypto/sha256"
  "encoding/hex"
  "strings"
)

func GenerateAuthPassword(username string, secret string) string {
	h := sha256.New()
	h.Write([]byte(username))
	h.Write([]byte(secret))
	return strings.ToLower(hex.EncodeToString(h.Sum(nil)))
}

认证回调

• TURN服务器向AUTH_CALLBACK_URL发送GET请求，参数含uid（用户ID）和ip（客户端IP）
• 回调返回200则继续认证，否则拒绝访问

Docker部署示例

静态用户模式

bash
docker run -d \
  --name turn-server \
  -p 3478:3478/udp \
  -p 3478:3478/tcp \
  -e REALM=your-domain.com \
  -e USERS=user1:pass1,user2:pass2 \
  -e UDP_ENABLED=YES \
  -e TCP_ENABLED=YES \
  asanrom/turn-server

TLS模式（需挂载证书）

bash
docker run -d \
  --name turn-server-tls \
  -p 3478:3478/udp \
  -p 3478:3478/tcp \
  -p 5349:5349/tcp \
  -v /path/to/cert.pem:/cert.pem \
  -v /path/to/key.pem:/key.pem \
  -e REALM=your-domain.com \
  -e USERS=user1:pass1 \
  -e TLS_ENABLED=YES \
  -e TLS_CERTIFICATE=/cert.pem \
  -e TLS_PRIVATE_KEY=/key.pem \
  asanrom/turn-server