killua99/coturn

镜像概述

Coturn TURN服务器是一款VoIP媒体流量NAT穿越服务器和网关，同时可作为通用网络流量的TURN服务器与网关，解决网络通信中的NAT（网络地址转换）障碍，保障跨网络设备的正常通信。

核心功能

• 支持VoIP媒体流量的NAT穿越，确保实时音视频通信稳定
• 适配通用网络流量转发场景，满足多种通信需求
• 提供灵活的端口范围调整、外部IP自动检测等配置能力
• 基于Alpine Linux构建，镜像体积小、运行高效

使用场景

• WebRTC实时音视频通话应用
• 在线会议与协作系统
• P2P通信类应用
• 跨NAT网络的实时数据传输场景

配置说明

基本运行

启动Coturn容器：

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

端口优化

TURN服务器需大量端口交换媒体，可调整端口范围或使用主机网络（推荐）：

bash
# 调整端口范围
docker run -d -p 3478:3478 -p 49160-49200:49160-49200/udp \
       killua99/coturn -n --log-file=stdout \
                             --external-ip='$(detect-external-ip)' \
                             --min-port=49160 --max-port=49200

# 主机网络模式
docker run -d --network=host killua99/coturn

配置方式

1. 自定义配置文件：

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

2. 命令行参数配置：

bash
docker run -d --network=host killua99/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 \
           killua99/coturn -c /my/coturn.conf

外部IP自动检测

使用工具自动获取外部IP：

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

持久化优化

用tmpfs提升数据存储性能：

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

镜像版本

基于Alpine Linux，提供多版本标签：

• X：主版本最新版
• X.Y：次版本最新版
• X.Y.Z：具体版本最新版
• X.Y.Z.W：固定具体版本

许可证

Coturn遵循https://github.com/coturn/coturn/blob/master/LICENSE%EF%BC%8C%E9%95%9C%E5%83%8F%E9%81%B5%E5%BE%AAhttps://github.com/instrumentisto/coturn-docker-image/blob/master/LICENSE.md%E3%80%82

问题反馈

若有问题，请通过https://github.com/instrumentisto/coturn-docker-image/issues%E5%8F%8D%E9%A6%88%EF%BC%8CDockerHub%E8%AF%84%E8%AE%BA%E5%8C%BA%E6%97%A0%E6%B3%95%E5%8F%8A%E6%97%B6%E5%A4%84%E7%90%86%E3%80%82