alexxit/go2rtc

go2rtc Docker镜像技术文档

镜像概述与主要用途

go2rtc 是一款终极摄像头流媒体应用，支持 RTSP、WebRTC、MJPEG、HomeKit、FFmpeg 等多种协议与功能，可实现摄像头流的采集、转换与分发，适用于各类视频监控与流媒体场景。

核心功能与特性

• 多协议支持：兼容 RTSP、WebRTC、MJPEG、HomeKit 等主流流媒体协议，满足多样化接入与输出需求。
• 硬件转码加速：支持 Intel iGPU、Raspberry Pi、AMD GPU 及 NVidia GPU 硬件转码，提升性能并降低 CPU 占用。
• 多架构适配：提供 amd64、386、arm、arm64 架构支持，适配 x86 服务器、嵌入式设备（如树莓派）等多种硬件环境。
• WebUI 配置：支持通过 Web 界面编辑配置文件（go2rtc.yaml），简化配置流程。
• 自动重启机制：配置变更或故障时可自动重启，保障服务稳定性。

使用场景与适用范围

• 家庭/企业 IP 摄像头监控系统搭建。
• 需要多协议转换的流媒体服务（如将 RTSP 流转为 WebRTC 供网页访问）。
• 对硬件资源敏感，需通过硬件加速降低 CPU 占用的场景。
• 需跨平台部署（如 x86 服务器与 ARM 嵌入式设备）的流媒体应用。

版本说明

使用方法与配置说明

Docker Compose 配置

通过 docker-compose.yml 快速部署，配置示例如下：

yaml
services:
  go2rtc:
    image: docker.xuanyuan.run/alexxit/go2rtc  # 默认使用 latest 标签
    network_mode: host       # 必须：WebRTC、HomeKit、UDP 摄像头依赖主机网络
    privileged: true         # 必须：FFmpeg 硬件转码需特权模式
    restart: unless-stopped  # 配置：故障或 WebUI 配置变更后自动重启
    environment:
      - TZ=Atlantic/Bermuda  # 可选：设置日志时区（如 Asia/Shanghai）
    volumes:
      - "~/go2rtc:/config"   # 必须：挂载配置目录，用于存储 go2rtc.yaml（支持 WebUI 编辑）

启动命令：docker-compose up -d

基本部署命令

使用 docker run 直接部署稳定版：

bash
docker run -d \
  --name go2rtc \
  --network host \
  --privileged \
  --restart unless-stopped \
  -e TZ=Atlantic/Bermuda \  # 替换为实际时区，如 Asia/Shanghai
  -v ~/go2rtc:/config \     # 本地配置目录路径，可自定义（如 /opt/go2rtc:/config）
  alexxit/go2rtc

GPU 加速部署命令

如需启用 GPU 硬件转码（支持 NVidia/AMD/Intel GPU），使用硬件加速版本镜像：

bash
docker run -d \
  --name go2rtc \
  --network host \
  --privileged \
  --restart unless-stopped \
  -e TZ=Atlantic/Bermuda \  # 替换为实际时区
  --gpus all \              # 必须：启用所有 GPU 设备（需 Docker 支持 GPU 驱动）
  -v ~/go2rtc:/config \
  alexxit/go2rtc:latest-hardware  # 使用硬件加速版本镜像

环境变量与卷挂载说明

环境变量

卷挂载

硬件转码详细说明参见：https://github.com/AlexxIT/go2rtc/wiki/Hardware-acceleration