Ant Media Server 官方Docker镜像文档

1. 镜像概述与主要用途

Ant Media Server 官方Docker镜像是一个即用型、高可扩展的实时视频流引擎容器化方案。该镜像旨在提供便捷的部署体验，支持在本地环境、私有云或公共云平台（如AWS、Azure、GCP等）快速搭建实时视频流服务。其核心用途是处理大规模实时视频流传输，通过动态扩缩容能力自动化服务数百万并发观众，满足各类实时音视频场景的技术需求。

2. 核心功能与特性

2.1 即用型部署

无需复杂前置配置，拉取镜像后即可快速启动服务，降低部署门槛。

2.2 高可扩展性

支持动态扩缩容，可根据观众规模自动调整资源，实现从数千到数百万并发用户的平滑过渡。

2.3 多环境适配

兼容本地服务器、私有云及主流公共云平台（AWS、Azure、GCP等），部署环境灵活多样。

2.4 实时视频流处理

原生支持低延迟视频流传输、转码、分发等核心能力，保障实时音视频体验。

2.5 自动化大规模服务

内置自动化扩展逻辑，可无缝对接容器编排工具（如Kubernetes），实现大规模观众的稳定服务。

3. 使用场景与适用范围

3.1 典型使用场景

• 直播平台：支持娱乐、游戏、电商等场景的高并发直播需求。
• 在线教育：实时互动课堂、大班课直播（万人级并发）。
• 企业直播：公司年会、产品发布会、内部培训等企业级场景。
• 视频会议：低延迟多方音视频交互（需配合WebRTC协议）。
• 大规模活动：体育赛事、演唱会等超大规模观众实时观看场景。

3.2 适用范围

• 需要处理10万+并发观众的实时视频流场景。
• 对部署灵活性有高要求（跨云、混合云部署）的用户。
• 需快速迭代、动态调整资源的互联网服务团队。
• 希望降低基础设施维护成本，专注业务逻辑的企业。

4. 使用方法与配置说明

4.1 拉取镜像

从Docker Hub拉取官方最新镜像：

docker pull antmedia/ant-media-server:latest

4.2 基本运行命令（docker run）

4.2.1 单节点基础启动

docker run -d \
  --name ant-media-server \
  -p 80:80 \       # HTTP端口（Web管理界面、HLS/DASH分发）
  -p 443:443 \     # HTTPS端口（加密传输）
  -p 1935:1935 \   # RTMP端口（视频推流）
  -p 5000-5050:5000-5050 \  # WebRTC端口范围（实时互动）
  -v /local/data:/usr/local/antmedia/data \  # 持久化媒体数据
  -v /local/logs:/usr/local/antmedia/logs \  # 持久化日志
  antmedia/ant-media-server:latest

4.2.2 带自定义配置的启动（示例）

docker run -d \
  --name ant-media-server \
  -p 80:80 -p 443:443 -p 1935:1935 \
  -v /local/config:/usr/local/antmedia/conf \  # 挂载自定义配置文件
  -e SERVER_URL="[***]" \   # 服务器对外访问URL
  -e LOG_LEVEL="INFO" \                        # 日志级别（INFO/DEBUG/WARN/ERROR）
  -e MAX_VIEWERS=100000 \                      # 单节点最大观众数阈值（用于扩展触发）
  antmedia/ant-media-server:latest

4.3 Docker Compose配置示例

创建docker-compose.yml文件，支持多容器协同或依赖服务（如数据库）集成：

version: '3.8'
services:
  ant-media-server:
    image: antmedia/ant-media-server:latest
    container_name: ant-media-server
    ports:
      - "80:80"
      - "443:443"
      - "1935:1935"
      - "5000-5050:5000-5050"
    volumes:
      - ./data:/usr/local/antmedia/data
      - ./logs:/usr/local/antmedia/logs
      - ./conf:/usr/local/antmedia/conf
    environment:
      - SERVER_URL=[***]
      - LICENSE_KEY=your_license_key  # 企业版需配置授权密钥
      - SCALE_MODE=AUTO  # 启用自动扩展模式
    restart: unless-stopped
    networks:
      - antmedia-network

networks:
  antmedia-network:
    driver: bridge

启动服务：

docker-compose up -d

4.4 核心配置参数说明

4.4.1 环境变量

4.4.2 端口映射说明

5. 扩展与部署最佳实践

5.1 Kubernetes扩展

Ant Media Server支持通过Kubernetes实现容器编排与自动扩缩容，详细配置可参考官方文档：
使用Kubernetes扩展Ant Media Server

5.2 数据持久化建议

• 媒体文件（如录制视频）建议挂载至外部存储（如NFS、S3兼容存储），避免容器重启导致数据丢失。
• 配置文件（conf目录）建议持久化，确保自定义配置不被覆盖。

6. 注意事项

• 社区版与企业版功能差异：企业版支持更多高级特性（如GPU转码、多租户管理），需通过LICENSE_KEY激活。
• 性能优化：高并发场景下建议配置CPU/内存资源限制（如--cpus=4 --memory=8g），并启用硬件加速转码。
• 安全配置：生产环境需启用HTTPS（挂载SSL证书至/usr/local/antmedia/conf/ssl目录），限制端口访问权限。