nachochip/ffmpeg

nachochip/ffmpeg 镜像文档

镜像概述

本镜像将通过 ffmpeg-build 编译的FFmpeg二进制文件集成到基础Debian容器中，实现了显著的体积优化（约130MB，相比原始Debian容器减少约230MB）。镜像以FFmpeg作为入口点，可直接作为命令行工具使用，适用于各类音视频处理场景。

核心功能和特性

• 编解码器支持：内置x264（H.264视频编解码器）和fdk-aac（高级音频编解码器），满足主流音视频处理需求。
• 体积优化：通过精简基础容器和仅包含编译后的FFmpeg二进制文件，实现约130MB的轻量级体积。
• 即开即用：镜像入口点设为ffmpeg，可直接传递FFmpeg命令参数，无需额外配置。

使用场景和适用范围

• 音视频格式转换（如MP4、AVI、MKV等格式互转）。
• 音视频编解码处理（如H.264视频编码、AAC音频编码）。
• 批量音视频处理任务自动化。
• 嵌入式或资源受限环境中的音视频处理需求。

使用方法和配置说明

基本使用方式

由于镜像入口点已设置为ffmpeg，可直接通过docker run命令传递FFmpeg参数执行操作。

示例：音视频流复制（无损处理）

bash
docker run docker.xuanyuan.run/nachochip/ffmpeg -i INPUT -vcodec copy -acodec copy - > OUTPUT.mp4

参数说明：

• -i INPUT：指定输入文件路径（需确保容器可访问输入文件，可通过-v挂载本地目录实现）。
• -vcodec copy：复制视频流，不重新编码（无损处理）。
• -acodec copy：复制音频流，不重新编码（无损处理）。
• - > OUTPUT.mp4：将处理结果输出到本地文件OUTPUT.mp4。

挂载本地文件系统

若需处理本地文件，需通过-v参数将本地目录挂载到容器中：

bash
docker run -v /path/to/local/files:/data docker.xuanyuan.run/nachochip/ffmpeg -i /data/input.mp4 -c:v libx264 -c:a libfdk_aac /data/output.mp4

说明：

• /path/to/local/files：本地文件目录路径。
• /data：容器内挂载路径，用于访问输入文件和输出结果。
• -c:v libx264：使用x264编码器重新编码视频。
• -c:a libfdk_aac：使用fdk-aac编码器重新编码音频。

常用FFmpeg命令示例

1. 提取音频：

bash
docker run -v /local/path:/data docker.xuanyuan.run/nachochip/ffmpeg -i /data/input.mp4 -vn -c:a libfdk_aac /data/audio.aac

2. 视频压缩：

bash
docker run -v /local/path:/data docker.xuanyuan.run/nachochip/ffmpeg -i /data/large_video.mp4 -c:v libx264 -crf 23 -c:a copy /data/compressed_video.mp4

（注：-crf 23为视频质量参数，值越小质量越高，范围0-51）