exoplatform/coturn

Coturn Docker镜像

镜像概述和主要用途

本镜像提供即开即用的https://github.com/coturn/coturn%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8CCoturn%E6%98%AF%E4%B8%80%E4%B8%AA%E7%AC%A6%E5%90%88RFC%E6%A0%87%E5%87%86%E7%9A%84STUN/TURN%E6%9C%8D%E5%8A%A1%E5%99%A8%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8EWebRTC%E7%AD%89%E5%AE%9E%E6%97%B6%E9%80%9A%E4%BF%A1%E5%9C%BA%E6%99%AF%EF%BC%8C%E8%A7%A3%E5%86%B3NAT%E7%A9%BF%E9%80%8F%E5%92%8C%E5%AA%92%E4%BD%93%E4%B8%AD%E7%BB%A7%E9%97%AE%E9%A2%98%E3%80%82

核心功能和特性

• 支持STUN（RFC 3489/5389）和TURN（RFC 5766/5780/6062/6156）协议
• 支持TLS、DTLS及DTLS 1.2加密
• 支持TURN/STUN ALPN协议扩展
• 支持第三方授权（oAuth）机制
• 支持GCM（AEAD）加密算法
• 多数据库支持：SQLite（默认路径/var/lib/turn/turndb）、Redis、PostgreSQL、MySQL（不支持MongoDB）
• 默认网络引擎版本3（每个CPU核心分配一个UDP线程）

使用场景和适用范围

• WebRTC实时音视频通信应用中的NAT穿透
• P2P通信中的媒体中继服务
• 跨不同网络环境的实时数据传输
• 需要STUN/TURN协议支持的VoIP或实时协作系统

前提条件

• Docker守护进程

使用方法和配置说明

基本运行命令

bash
$ docker run --rm -p 3478:3478 exoplatform/coturn -v --log-file stdout -X xxx.xxx.xxx.xxx

NAT环境下运行

若Coturn服务器部署在NAT之后，必须通过-X参数指定公网IP：

bash
$ docker run --rm -p 3478:3478 exoplatform/coturn -v --log-file stdout -X xxx.xxx.xxx.xxx

查看所有配置选项

执行以下命令获取完整的Coturn服务器配置参数列表：

bash
$ docker run --rm exoplatform/coturn -h

运行后将显示包括监听端口、TLS配置、数据库设置等详细选项，例如：

• -p, --listening-port <port>：指定监听端口（默认3478）
• -d, --listening-device <device-name>：指定监听网络接口（仅Linux，不推荐）
• 其他高级配置如TLS证书路径、认证机制等