lsiodev/ffmpeg

LinuxServer.io FFmpeg 镜像文档

镜像概述

FFmpeg 是一个完整的跨平台解决方案，用于录制、转换和流式传输音频和视频。LinuxServer.io 提供的此镜像基于自定义基础镜像构建，包含 s6 覆盖层，支持定期应用更新、用户映射（PGID、PUID）和每周基础 OS 更新，确保安全性和稳定性。

核心功能与特性

• 多架构支持：兼容 x86-64 和 arm64 架构
• 硬件加速：支持 VAAPI、QSV、Nvidia 和 Vulkan 硬件加速
• 丰富驱动：包含最新 Intel 驱动（iHD、i965）、Libva、Qsv Dispatcher 及运行时
• 格式支持：支持 WebP、SVT-AV1、libvmaf 等多种格式和编解码器
• 权限管理：自动匹配输入文件的用户/组权限，确保输出文件权限正确

支持的架构

使用方法

此镜像设计为临时从命令行运行，需结合自定义 FFmpeg 命令使用。以下示例假设当前工作目录包含输入文件 input.mkv，并通过 -v $(pwd):/config 将当前目录挂载到容器的 /config 目录。

包含的 Intel 驱动（最新版本编译）

• iHD 驱动：支持 gen8+（Intel 默认驱动）
• i965 驱动：支持 gen5+（通过设置环境变量 LIBVA_DRIVER_NAME=i965 启用，适用于 gen5-gen9.5）
• Libva (VAAPI)：配合 i965 驱动支持 gen5+，配合 iHD 驱动支持 gen8+
• Qsv Dispatcher：OneVPL（支持 OneVPL 和 MSDK 运行时，自动切换）
• Qsv 运行时：
  • OneVPL：支持 gen12+
  • MSDK (libmfx)：支持 gen8 - gen12

基本转码

bash
docker run --rm -it \
  -v $(pwd):/config \
  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 \
  -v $(pwd):/config \
  linuxserver/ffmpeg \
  -vaapi_device /dev/dri/renderD128 \
  -i /config/input.mkv \
  -c:v h264_vaapi \
  -b:v 4M \
  -vf 'format=nv12|vaapi,hwupload,scale_vaapi=w=1280:h=720' \
  -c:a copy \
  /config/output.mkv

QSV 硬件加速（更多信息）

bash
docker run --rm -it \
  --device=/dev/dri:/dev/dri \
  -v $(pwd):/config \
  linuxserver/ffmpeg \
  -hwaccel qsv \
  -c:v h264_qsv \
  -i /config/input.mkv \
  -c:v h264_qsv \
  -global_quality 25 \
  /config/output.mkv

Nvidia 硬件加速（更多信息）

bash
docker run --rm -it \
  --runtime=nvidia \
  -v $(pwd):/config \
  linuxserver/ffmpeg \
  -hwaccel nvdec \
  -i /config/input.mkv \
  -c:v h264_nvenc \
  -b:v 4M \
  -vf scale=1280:720 \
  -c:a copy \
  /config/output.mkv

Vulkan 支持

x86_64 架构已添加 Vulkan 支持（经 Intel 和 AMD iGPU 测试）（更多信息）。

bash
docker run --rm -it \
  --device=/dev/dri:/dev/dri \
  -v $(pwd):/config \
  -e ANV_VIDEO_DECODE=1 \
  linuxserver/ffmpeg \
  -init_hw_device "vulkan=vk:0" \
  -hwaccel vulkan \
  -hwaccel_output_format vulkan \
  -i /config/input.mkv \
  -f null - -benchmark

注意：Vulkan 支持三种驱动：

• ANV：Intel 需设置环境变量 ANV_VIDEO_DECODE=1
• RADV：AMD 需设置环境变量 RADV_PERFTEST=video_decode
• NVIDIA：需在主机安装 Nvidia Vulkan Beta 驱动（参考此文章）

本地构建

如需本地修改或自定义镜像：

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 变体，需使用 multiarch/qemu-user-static：

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

注册后，可通过 -f Dockerfile.aarch64 指定架构 Dockerfile。

版本历史

• 05.12.23：更新 Mesa，修复 vdpau 和 AMD VAAPI
• 25.11.23：从源码编译 Mesa，添加完整 Vulkan 支持（无需 ENABLE_VULKAN=true 环境变量，已通过 Intel 测试）
• 22.11.23：添加 shaderc 和（初步）Vulkan 支持（x86_64，通过 ENABLE_VULKAN=true 环境变量启用），更新 Intel 驱动及其他库
• 13.11.23：升级 FFmpeg 至 6.1
• 02.11.23：移除 ffmpeg 构建选项 --enable-small，恢复部分功能
• 05.10.23：添加 SVT-AV1 支持，更新多个库
• 16.08.23：添加 WebP 格式支持
• 11.08.23：添加可选 i965 驱动，支持 gen5+
• 14.06.23：切换至最新 iHD 驱动（Intel），添加 qsv 支持
• 13.06.23：升级至 FFmpeg 6.0，更新共享库，弃用 armhf，合并 bin 阶段
• 14.12.22：基于 Jammy 重建，升级至 5.1.2
• 19.06.22：基于 Focal 重建
• 26.08.21：添加 libOpenCL 支持
• 01.07.21：升级至 4.4
• 17.06.20：升级至 4.3
• 16.06.20：添加 libvmaf 支持
• 01.08.19：初始发布