portableffmpegs/ffmpeg

FFmpeg 镜像文档

镜像概述和主要用途

FFmpeg 镜像包含处理多媒体内容的完整库和工具集，可用于音频、视频、字幕及相关元数据的处理。该镜像提供便捷的部署方式，适用于多媒体文件转换、编辑、流媒体处理、内容分析等场景，无需手动配置复杂的依赖环境。

核心功能和特性

核心库

• libavcodec：提供多种编解码器实现，支持广泛的音视频编码格式。
• libavformat：实现流媒体协议、容器格式处理及基础 I/O 访问功能。
• libavutil：包含哈希函数、解压缩器及各类实用工具函数。
• libavfilter：通过过滤器链对解码后的音视频进行处理（如特效、裁剪等）。
• libavdevice：提供访问音视频采集和播放设备的抽象接口。
• libswresample：实现音频混合与重采样功能。
• libswscale：实现色彩空间转换和图像缩放功能。

工具集

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

使用场景和适用范围

• 多媒体文件格式转换（如 MP4 转 AVI、FLAC 转 MP3 等）。
• 视频剪辑、滤镜处理（添加水印、裁剪、调色等）。
• 音频混合、重采样及格式标准化。
• 流媒体服务器内容处理（直播推流、转码）。
• 多媒体文件元数据提取与分析。
• 开发集成：作为依赖库用于音视频处理应用开发。

使用方法和配置说明

基本使用方式

通过 Docker 运行 FFmpeg 命令，需将本地文件目录挂载到容器中以访问输入输出文件。

拉取镜像

bash
docker pull ffmpeg:latest

基本命令格式

bash
docker run --rm -v [本地目录]:/workdir ffmpeg:latest [ffmpeg命令]

• --rm：容器退出后自动删除。
• -v [本地目录]:/workdir：将本地目录挂载到容器内的 /workdir，用于文件读写。

常用示例

1. 视频格式转换（MP4 转 AVI）

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

2. 音频提取（从视频中提取 MP3）

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

• -vn：禁用视频流。
• -acodec mp3：指定音频编码器为 MP3。

3. 使用 ffprobe 分析媒体文件

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

4. 使用 ffplay 播放视频（需配置显示环境，适用于桌面系统）

bash
docker run --rm -v /tmp/.X11-unix:/tmp/.X11-unix -e DISPLAY=$DISPLAY -v $(pwd):/workdir ffmpeg:latest ffplay input.mp4

文档和资源

• 离线文档：镜像内 doc/ 目录包含完整离线文档。
• 在线文档：官方网站（[] wiki（[]
• 代码示例：doc/examples 目录提供 C 语言开发示例。

许可证

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

贡献方式

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