dradenvandewind/ffmpeg

FFmpeg 多编解码器集成镜像

镜像概述

本Docker镜像提供预编译的FFmpeg环境，集成了多种主流音视频编解码器和质量评估工具，旨在为音视频处理任务提供一站式解决方案。镜像基于FFmpeg 8.0构建，包含X264、X265等常用H.264/H.265编码器，以及AOM（AV1）、VVENC、XEVE等新兴编码标准支持，同时集成VMAF视频质量评估工具，满足从基础转码到高级质量分析的多样化需求。

核心功能与组件版本

主要组件及版本

• FFmpeg: n8.0 - 核心音视频处理框架
• X265: 4.1 - H.265/HEVC编码器
• X264: stable - H.264/AVC编码器
• VVENC: v1.13.1-rc1 - 开源H.266/VVC编码器
• AOM: v3.13.1 - AV1视频编解码器
• LCEVC: 3.3.6 - 低复杂度增强视频编码技术
• XEVE: v0.5.1 - 高效率视频编码扩展工具
• VMAF: v3.0.0 - 视频多方法评估融合工具，用于视频质量客观评估

使用场景

• 音视频格式转换（如MP4、MKV、AVI等格式互转）
• 视频压缩与码率控制（通过X264/X265实现高效压缩）
• 新一代编码标准测试（AV1、VVC等编码实验）
• 视频质量评估（使用VMAF进行客观质量分析）
• 批量音视频处理任务自动化部署

使用方法

基础使用（Docker Run）

1. 查看FFmpeg版本及支持组件

bash
docker run --rm [镜像名称] ffmpeg -version

2. 基本视频转码示例（H.264转H.265）

bash
docker run --rm -v /本地输入目录:/input -v /本地输出目录:/output [镜像名称] \
  ffmpeg -i /input/input.mp4 -c:v libx265 -crf 28 -c:a copy /output/output_h265.mp4

• -v /本地目录:/容器目录: 挂载本地目录到容器，实现文件输入输出
• -c:v libx265: 使用X265编码器
• -crf 28: 设置恒定速率因子（值越低质量越高，通常范围18-28）
• -c:a copy: 复制音频流，不重新编码

3. 使用VMAF评估视频质量

bash
docker run --rm -v /本地输入目录:/input [镜像名称] \
  ffmpeg -i /input/reference.mp4 -i /input/encoded.mp4 -lavfi "libvmaf=model_path=/usr/share/vmaf/models/vmaf_v0.6.1.json:log_path=/input/vmaf_result.json" -f null -

• 生成VMAF评分报告（JSON格式）到vmaf_result.json

Docker Compose配置示例

yaml
version: '3'
services:
  ffmpeg:
    image: docker.xuanyuan.run/[镜像名称]
    volumes:
      - ./input:/input
      - ./output:/output
    command: ffmpeg -i /input/input.mp4 -c:v libaom-av1 -crf 30 -b:v 0 -c:a libopus /output/output_av1.mkv

• 此配置使用AV1编码器（libaom-av1）转码视频，音频使用***编码

注意事项

• 编解码任务通常CPU密集型，建议根据任务需求分配足够的CPU资源
• 部分编码器（如AOM-AV1）编码速度较慢，适合非实时场景
• 挂载目录时确保本地目录有读写权限，避免文件操作失败
• 详细参数可参考FFmpeg官方文档及各编码器说明

支持的编解码器

• 视频编码: H.264 (x264), H.265 (x265), AV1 (libaom-av1), VVC (vvcenc), MPEG-4, VP9等
• 视频解码: 支持主流视频格式解码，包括H.264/265/266、AV1、VP8/9等
• 音频编码: AAC, MP3, ***, FLAC等
• 音频解码: 支持多种音频格式解码

质量评估工具

• VMAF: 提供客观视频质量评分，支持自定义模型和参数，输出详细质量分析报告