nazarpc/coturn

Coturn镜像

https://github.com/coturn/coturn TURN服务器的Docker镜像，用于解决网络通信中的NAT穿透问题，常见于WebRTC等实时音视频应用场景。

核心功能

• 支持***访问模式（通过环境变量开启）
• 可自定义账号密码、Realm标识
• 灵活配置监听端口、TLS端口及端口范围
• 支持挂载TLS证书实现加密通信

使用场景

适用于需要NAT穿透的实时音视频通信场景，如WebRTC应用、在线会议系统、实时直播平台等。

配置说明

环境变量

镜像支持以下环境变量：

• ANONYMOUS: 设置为1时启用***访问，无需账号密码
• USERNAME: 访问TURN服务器的用户名，默认值为username
• PASSWORD: 访问TURN服务器的密码，默认值为password
• REALM: TURN服务器的Realm标识，默认值为realm
• LISTEN_PORT: 监听端口，默认值为3478
• TLS_LISTEN_PORT: TLS监听端口，默认值为5349
• MIN_PORT: 端口范围最小值，默认值为65435
• MAX_PORT: 端口范围最大值，默认值为65535

部署示例

基础部署

bash
sudo docker run \
  -d \
  -p 3478:3478 \
  -p 3478:3478/udp \
  -p 65435-65535:65435-65535/udp \
  --restart=always \
  --name coturn \
  nazarpc/coturn

自定义账号密码及端口范围

bash
# 定义端口范围
export MIN_PORT=50000
export MAX_PORT=50010
docker run \
  -d \
  -p 3478:3478 \
  -p 3478:3478/udp \
  -p ${MIN_PORT}-${MAX_PORT}:${MIN_PORT}-${MAX_PORT}/udp \
  -e USERNAME=another_user \
  -e PASSWORD=another_password \
  -e REALM=another_realm \
  -e MIN_PORT=${MIN_PORT} \
  -e MAX_PORT=${MAX_PORT} \
  --restart=always \
  --name coturn \
  nazarpc/coturn

挂载TLS证书

将证书文件cert.pem和密钥文件pkey.pem存放在/opt目录下，然后挂载到容器内：

bash
sudo docker run \
  -d \
  -p 3478:3478 \
  -p 3478:3478/udp \
  -p 65435-65535:65435-65535/udp \
  -v /opt/cert.pem:/etc/ssl/turn_server_cert.pem \
  -v /opt/pkey.pem:/etc/ssl/turn_server_pkey.pem \
  --restart=always \
  --name coturn \
  nazarpc/coturn

致谢

初始镜像由Anastasia Zolochevska创建：https://github.com/anastasiia-zolochevska/turn-server-docker-image
后续由Dennis Boldt改进：https://github.com/boldt/turn-server-docker-image

贡献

欢迎创建问题和提交拉取请求（重大变更请先创建问题并关联PR）！

许可证

Free Public License 1.0.0 / Zero Clause BSD License
[]
[]