shffmpegw/ffmpeg

FFmpeg 镜像文档

镜像概述和主要用途

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获取文件编码信息、时长、比特率等元数据。
• 开发集成：作为底层库集成到音视频应用中，提供编解码和格式处理能力。

使用方法和配置说明

基础使用（Docker Run命令）

使用FFmpeg镜像处理本地文件时，需挂载工作目录以访问输入文件和输出结果。以下是基本示例：

bash
# 将当前目录挂载到容器的/workdir，处理input.mp4并输出为output.avi
docker run --rm -v $(pwd):/workdir jrottenberg/ffmpeg -i /workdir/input.mp4 /workdir/output.avi

参数说明：

• --rm：容器退出后自动删除。
• -v $(pwd):/workdir：将本地当前目录挂载到容器内的/workdir，实现文件共享。
• jrottenberg/ffmpeg：常用的FFmpeg Docker镜像（可根据需求选择其他镜像，如linuxserver/ffmpeg）。
• -i /workdir/input.mp4：指定输入文件路径（容器内路径）。
• /workdir/output.avi：指定输出文件路径（容器内路径，对应本地当前目录）。

常用功能示例

1. 视频格式转换

将MP4转换为WebM格式：

bash
docker run --rm -v $(pwd):/workdir jrottenberg/ffmpeg -i /workdir/input.mp4 -c:v libvpx -c:a libvorbis /workdir/output.webm

2. 提取音频

从视频中提取MP3音频：

bash
docker run --rm -v $(pwd):/workdir jrottenberg/ffmpeg -i /workdir/input.mp4 -vn -c:a libmp3lame -q:a 2 /workdir/output.mp3

• -vn：禁用视频流。
• -c:a libmp3lame：指定音频编码器为MP3。

3. 视频裁剪

裁剪视频前30秒：

bash
docker run --rm -v $(pwd):/workdir jrottenberg/ffmpeg -i /workdir/input.mp4 -t 30 -c copy /workdir/trimmed.mp4

• -t 30：指定时长为30秒。
• -c copy：直接复制流，不重新编码（快速操作）。

4. 使用ffprobe分析媒体文件

查看文件元数据：

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

文档与资源

• 离线文档：镜像内doc/目录包含离线文档。
• 在线文档：官方网站（[***]
• 代码示例：doc/examples目录包含C语言编码示例，可用于开发集成。

许可证

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

贡献方式

补丁需通过git format-patch或git send-email提交至ffmpeg-devel邮件列表。不建议使用GitHub Pull Request，因其不属于官方审核流程。