ffmpegclearu/ffmpeg

FFmpeg Docker镜像文档

镜像概述与主要用途

FFmpeg Docker镜像是包含FFmpeg工具和库的容器化版本，用于处理多媒体内容，如音频、视频、字幕及相关元数据。它集成了多种编解码库和实用工具，支持多媒体文件的转换、处理、流媒体传输及分析等操作，适用于开发、测试和生产环境中的多媒体处理任务。

核心功能与特性

核心库

• libavcodec：提供广泛的编解码器实现，支持多种音频和视频编码格式
• libavformat：实现流媒体协议、容器格式及基本I/O访问，支持多种文件格式的读写
• libavutil：包含哈希函数、解压缩器及各类实用工具函数，为其他库提供基础支持
• libavfilter：通过过滤器链对解码后的音频和视频进行处理，支持特效、转码等操作
• libavdevice：提供访问捕获和播放设备的抽象接口，支持摄像头、麦克风等设备的输入输出
• libswresample：实现音频混音和重采样功能，支持不同音频格式和采样率的转换
• libswscale：实现色彩空间转换和图像缩放功能，支持视频分辨率调整和格式转换

主要工具

• ffmpeg：命令行工具集，用于多媒体内容的处理、转换和流媒体传输
• ffplay：轻量级多媒体播放器，支持播放多种格式的音视频文件
• ffprobe：多媒体内容分析工具，用于检查音视频文件的元数据和流信息
• 其他小型工具：如aviocat（AVI文件连接工具）、ismindex（平滑流式处理工具）、qt-faststart（QuickTime文件优化工具）等

使用场景与适用范围

• 视频转码：将视频文件转换为不同格式（如MP4、AVI、MKV等）或调整分辨率、比特率
• 音频处理：音频格式转换、混音、音量调整、音频提取等
• 流媒体服务：实时编码和传输音视频流（如RTMP、HLS等协议）
• 多媒体分析：使用ffprobe检查文件元数据、流信息、编码参数等
• 自动化处理：集成到CI/CD流程或后台服务中，实现批量多媒体处理任务

使用方法与配置说明

基本使用（docker run）

通过Docker命令直接运行FFmpeg工具，基本语法：

bash
docker run --rm -v /path/to/local/files:/workdir ffmpeg <ffmpeg-command>

• --rm：容器退出后自动删除
• -v /path/to/local/files:/workdir：挂载本地文件目录到容器内的/workdir，用于访问输入文件和保存输出文件
• <ffmpeg-command>：FFmpeg命令参数

示例1：视频格式转换

将本地input.mp4转换为output.avi：

bash
docker run --rm -v $(pwd):/workdir ffmpeg -i /workdir/input.mp4 /workdir/output.avi

示例2：提取音频

从视频文件中提取音频并保存为MP3格式：

bash
docker run --rm -v $(pwd):/workdir ffmpeg -i /workdir/input.mp4 -vn -acodec libmp3lame /workdir/output.mp3

• -vn：禁用视频流
• -acodec libmp3lame：指定MP3编码器

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  ffmpeg:
    image: ffmpeg
    volumes:
      - ./media:/workdir
    command: -i /workdir/input.mkv -c:v libx264 -c:a aac /workdir/output.mp4

运行命令：docker-compose up，自动执行视频转码任务

文档与资源

• 离线文档：容器内/doc目录包含FFmpeg离线文档
• 在线文档：FFmpeg官方网站和FFmpeg Wiki
• 代码示例：容器内/doc/examples目录包含C语言编码示例，展示FFmpeg库的使用方法

许可证信息

FFmpeg代码库主要采用LGPL许可证，部分可选组件采用GPL许可证。详细信息请参见容器内的LICENSE文件。