lsiobase/ffmpeg

LinuxServer.io FFmpeg Docker镜像

镜像概述

该镜像由LinuxServer.io团队提供，基于FFmpeg构建，是一个完整的跨平台音视频处理解决方案，支持音视频录制、格式转换和流媒体传输。镜像特点包括：定期应用更新、简单的用户映射（PGID、PUID）、基于s6 overlay的自定义基础镜像、每周基础系统更新以减少空间占用和 downtime、以及定期安全更新。

核心功能与特性

• 多架构支持：兼容x86-64、arm64、armhf架构
• 硬件加速：支持VAAPI和Nvidia硬件加速，提升转码效率
• 灵活的命令行使用：作为临时容器运行，直接解析用户自定义FFmpeg命令
• 权限匹配：自动根据输入文件权限设置输出文件权限
• 持续维护：定期更新FFmpeg版本和基础系统，确保安全性和功能完整性

支持的架构

通过Docker manifest实现多平台支持，拉取lscr.io/linuxserver/ffmpeg:latest即可自动匹配架构，也可通过标签指定特定架构：

使用方法

该镜像设计为临时运行模式，需通过命令行传入自定义FFmpeg命令。以下示例均假设当前工作目录包含输入文件input.mkv，并通过绑定挂载将当前目录映射到容器内的/config目录。

基本转码示例

bash
docker run --rm -it \
  -v $(pwd):/config \
  docker.xuanyuan.run/linuxserver/ffmpeg \
  -i /config/input.mkv \  # 输入文件路径
  -c:v libx264 \          # 视频编码器
  -b:v 4M \               # 视频比特率
  -vf scale=1280:720 \    # 视频分辨率缩放
  -c:a copy \             # 音频流直接复制
  /config/output.mkv      # 输出文件路径

VAAPI硬件加速

bash
docker run --rm -it \
  --device=/dev/dri:/dev/dri \  # 挂载DRI设备
  -v $(pwd):/config \
  linuxserver/ffmpeg \
  -vaapi_device /dev/dri/renderD128 \  # VAAPI设备路径
  -i /config/input.mkv \
  -c:v h264_vaapi \                   # VAAPI视频编码器
  -b:v 4M \
  -vf 'format=nv12|vaapi,hwupload,scale_vaapi=w=1280:h=720' \  # VAAPI缩放滤镜
  -c:a copy \
  /config/output.mkv

Nvidia硬件加速

bash
docker run --rm -it \
  --runtime=nvidia \  # 使用Nvidia运行时
  -v $(pwd):/config \
  linuxserver/ffmpeg \
  -hwaccel nvdec \    # Nvidia解码加速
  -i /config/input.mkv \
  -c:v h264_nvenc \   # Nvidia编码加速
  -b:v 4M \
  -vf scale=1280:720 \
  -c:a copy \
  /config/output.mkv

本地构建

如需修改镜像或进行开发，可本地构建：

bash
git clone https://github.com/linuxserver/docker-ffmpeg.git
cd docker-ffmpeg
docker build \
  --no-cache \
  --pull \
  -t linuxserver/ffmpeg:latest .

在x86_64硬件上构建ARM架构镜像，需先注册QEMU：

bash
docker run --rm --privileged docker.xuanyuan.run/multiarch/qemu-user-static:register --reset

然后使用对应架构的Dockerfile构建（如ARM64）：

bash
docker build -f Dockerfile.aarch64 -t linuxserver/ffmpeg:arm64 .

版本历史

• 2022年12月14日：基于Jammy重构，升级至FFmpeg 5.1.2
• 2022年6月19日：基于Focal重构
• 2021年8月26日：添加libOpenCL支持
• 2021年7月1日：升级至FFmpeg 4.4
• 2020年6月17日：升级至FFmpeg 4.3
• 2020年6月16日：添加libvmaf支持
• 2019年8月1日：初始发布