instrumentisto/coturn

Coturn TURN服务器Docker镜像

状态

项目已关闭并归档，不再维护。
建议使用官方镜像 https://hub.docker.com/r/coturn/coturn%EF%BC%88https://github.com/coturn/coturn/tree/master/docker/coturn%EF%BC%89%E3%80%82

支持的标签及对应Dockerfile链接

• https://github.com/instrumentisto/coturn-docker-image/blob/master/Dockerfile

什么是Coturn TURN服务器？

TURN服务器是VoIP媒体流量NAT穿透服务器和网关，也可作为通用网络流量的TURN服务器和网关。

https://github.com/coturn/coturn

如何使用该镜像

基本运行

启动Coturn TURN服务器容器：

bash
docker run -d -p 3478:3478 -p 49152-65535:49152-65535/udp instrumentisto/coturn

为什么需要开放这么多端口？

根据RFC 5766 Section 6.2，这些端口是TURN服务器用于交换媒体的端口。
可通过min-port和max-port配置选项修改：

bash
docker run -d -p 3478:3478 -p 49160-49200:49160-49200/udp \
       instrumentisto/coturn -n --log-file=stdout \
                             --external-ip='$(detect-external-ip)' \
                             --min-port=49160 --max-port=49200

或直接使用主机网络（推荐，因为Docker处理大端口范围性能较差https://github.com/instrumentisto/coturn-docker-image/issues/3）：

bash
docker run -d --network=host instrumentisto/coturn

配置方式

默认使用Coturn的默认配置及CMD指令中的CLI选项，支持以下配置方式：

1. 使用自定义配置文件：

   bash
   docker run -d --network=host \
               -v $(pwd)/my.conf:/etc/coturn/turnserver.conf \
           instrumentisto/coturn
   

2. 直接指定命令行参数：

   bash
   docker run -d --network=host instrumentisto/coturn \
               -n --log-file=stdout \
               --min-port=49160 --max-port=49200 \
               --lt-cred-mech --fingerprint \
               --no-multicast-peers --no-cli \
               --no-tlsv1 --no-tlsv1_1 \
               --realm=my.realm.org  
   

3. 使用其他路径的配置文件：

   bash
   docker run -d --network=host  \
               -v $(pwd)/my.conf:/my/coturn.conf \
           instrumentisto/coturn -c /my/coturn.conf
   

外部IP自动检测

可使用detect-external-ip工具在运行时自动检测TURN服务器的外部IP：

bash
docker run -d --network=host instrumentisto/coturn \
           -n --log-file=stdout \
           --external-ip='$(detect-external-ip)' \
           --relay-ip='$(detect-external-ip)'

持久化

默认情况下，Coturn镜像将数据持久化在/var/lib/coturn目录。可使用tmpfs加速：

bash
docker run -d --network=host --mount type=tmpfs,destination=/var/lib/coturn \
       instrumentisto/coturn

镜像版本

该镜像基于Alpine Linux（约5MB，体积小巧），使用musl libc。版本规则：

• X：Coturn主版本的最新版
• X.Y：Coturn次版本的最新版
• X.Y.Z或X.Y.Z.W：Coturn具体版本

许可证

Coturn遵循https://github.com/coturn/coturn/blob/master/LICENSE。
镜像包含的其他软件（如基础镜像中的Bash等）可能遵循不同许可证，用户需确保使用符合相关许可。
本镜像源码遵循https://github.com/instrumentisto/coturn-docker-image/blob/master/LICENSE.md。

问题反馈

请勿在DockerHub评论区反馈问题，如有问题请通过https://github.com/instrumentisto/coturn-docker-image/issues联系。