alpine-coturn

镜像概述

alpine-coturn是一个基于Alpine Linux的多架构Docker镜像，集成了S6进程管理工具和Coturn STUN/TURN服务，专为VoIP通信场景设计。该镜像提供轻量级、高效的STUN/TURN网关功能，解决网络地址转换（NAT）环境下的实时音视频通信连接问题。

维护方：WOAHBase
***文档 | 镜像地址 | 源码仓库

核心功能与特性

多架构支持

• 支持多种硬件架构，包括：x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64、s390x等

轻量级基础

• 基于Alpine Linux构建，镜像体积小，资源占用低

进程管理

• 集成S6进程管理系统，确保服务稳定运行和优雅重启

Coturn STUN/TURN服务

• 完整集成Coturn开源STUN/TURN服务器，支持：
  • STUN（会话初始协议遍历NAT）功能
  • TURN（Traversal Using Relays around NAT）中继功能
  • 支持UDP、TCP传输协议
  • 可配置认证机制

使用场景

• VoIP应用服务器（如SIP、WebRTC）的NAT穿透解决方案
• 实时音视频通信平台（如视频会议、在线教育）
• 需要跨NAT网络建立P2P连接的场景
• IoT设备远程通信中的连接中继

使用方法

基本部署

通过docker run命令快速启动：

docker run -d \
  --name coturn \
  -p 3478:3478/tcp \
  -p 3478:3478/udp \
  -p 5349:5349/tcp \
  -p 5349:5349/udp \
  woahbase/alpine-coturn

自定义配置

Coturn服务可通过挂载配置文件进行自定义配置：

1. 准备本地配置文件turnserver.conf（参考Coturn***配置文档）

2. 启动容器时挂载配置文件：

docker run -d \
  --name coturn \
  -p 3478:3478/tcp \
  -p 3478:3478/udp \
  -p 5349:5349/tcp \
  -p 5349:5349/udp \
  -v /path/to/turnserver.conf:/etc/turnserver.conf \
  woahbase/alpine-coturn

关键端口说明

docker-compose配置示例

version: '3'
services:
  coturn:
    image: woahbase/alpine-coturn
    container_name: coturn
    ports:
      - "3478:3478/tcp"
      - "3478:3478/udp"
      - "5349:5349/tcp"
      - "5349:5349/udp"
    volumes:
      - ./turnserver.conf:/etc/turnserver.conf
    restart: unless-stopped

注意事项

• 生产环境中建议通过配置文件设置认证机制（如用户名/密码）以提高安全性
• 根据实际网络环境调整端口映射和NAT配置
• 对于大规模部署，建议结合负载均衡和监控工具使用