omnileads/rtpengine

WebRTC VoIP 转码组件 Docker 镜像

镜像概述

本Docker镜像提供WebRTC VoIP场景下的媒体转码功能，专注于解决不同设备、浏览器及网络环境中音频/视频编解码器不兼容问题。通过实时转码处理，确保WebRTC通信链路中的媒体流能够在各类终端间无缝互通，适用于实时音视频通信系统的兼容性增强环节。

核心功能与特性

• 多编解码器支持：兼容主流WebRTC编解码器，包括音频（OPUS、G.711、G.722、PCMA/PCMU）和视频（VP8、VP9、H.264）
• 低延迟转码：优化转码流水线，端到端延迟控制在200ms以内，满足实时通信要求
• 自适应码率调整：根据网络带宽动态调整输出码率，平衡画质与流畅度
• 轻量化设计：基于 Alpine 基础镜像构建，镜像体积小，资源占用低
• 灵活配置：支持通过环境变量或配置文件自定义转码参数（分辨率、帧率、码率等）

使用场景

• 跨浏览器/设备WebRTC通信（如Chrome与Safari间H.264/VP8转码）
• 企业视频会议系统中的媒体兼容性处理
• 实时直播平台的多码率流生成
• IoT设备与Web端的音视频数据互通（嵌入式设备编解码器适配）
• 低带宽环境下的媒体流压缩与优化

使用方法

基础运行命令

bash
docker run -d \
  --name webrtc-transcoder \
  -p 8080:8080 \  # 转码服务API端口
  -p 5000-5010:5000-5010/udp \  # 媒体流传输端口
  -e INPUT_CODEC=vp8 \          # 输入视频编解码器
  -e OUTPUT_CODEC=h264 \        # 输出视频编解码器
  -e AUDIO_BITRATE=32000 \      # 音频输出码率（bps）
  -e VIDEO_BITRATE=500000 \     # 视频输出码率（bps）
  your-registry/webrtc-voip-transcoder:latest

Docker Compose 配置示例

yaml
version: '3'
services:
  transcoder:
    image: your-registry/webrtc-voip-transcoder:latest
    container_name: webrtc-transcoder
    ports:
      - "8080:8080"
      - "5000-5010:5000-5010/udp"
    environment:
      - INPUT_CODEC=vp9
      - OUTPUT_CODEC=h264
      - VIDEO_RESOLUTION=1280x720
      - VIDEO_FRAMERATE=30
      - AUDIO_SAMPLERATE=48000
      - LOG_LEVEL=info
    volumes:
      - ./transcoder-config:/etc/transcoder  # 挂载自定义配置文件
    restart: unless-stopped

环境变量配置说明

配置文件挂载（高级配置）

如需更复杂的转码规则（如条件转码、多输出流），可通过挂载配置文件实现：

bash
docker run -d \
  --name webrtc-transcoder \
  -p 8080:8080 \
  -v ./transcoder-config:/etc/transcoder \  # 挂载配置目录
  your-registry/webrtc-voip-transcoder:latest

配置文件（/etc/transcoder/config.json）示例：

json
{
  "transcode_rules": [
    {
      "input_codec": "vp8",
      "output_codecs": ["h264", "vp9"],
      "h264": {
        "bitrate": 1500000,
        "resolution": "1280x720",
        "framerate": 30
      },
      "vp9": {
        "bitrate": 800000,
        "resolution": "854x480",
        "framerate": 25
      }
    }
  ],
  "network": {
    "buffer_size": 4096,
    "timeout": 30
  }
}

注意事项

• 转码为CPU密集型操作，建议根据并发会话数配置CPU资源（每10路720p转码建议分配2核CPU）
• 视频转码需开启Docker容器的GPU支持（如使用NVIDIA GPU，需安装nvidia-docker）以提升性能
• 生产环境建议配合服务发现（如Consul）和负载均衡使用，实现水平扩展
• 网络延迟敏感场景需确保主机网络性能，建议使用主机网络模式（--net=host）减少容器网络开销