ffmpegcustomizeda/ffmpeg

FFmpeg Docker镜像文档

镜像概述和主要用途

FFmpeg是一个功能强大的多媒体处理工具集，包含一系列库和命令行工具，用于处理音频、视频、字幕及相关元数据。该镜像提供了FFmpeg的完整运行环境，可用于多媒体内容的编解码、格式转换、流媒体传输、音视频分析等多种场景。

核心功能和特性

核心库

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

命令行工具

• ffmpeg：命令行工具箱，用于多媒体内容的处理、转换和流媒体传输。
• ffplay：轻量级多媒体播放器。
• ffprobe：简单的多媒体内容分析工具，用于检查媒体文件信息。
• 其他小型工具：如aviocat、ismindex和qt-faststart等。

使用场景和适用范围

• 多媒体格式转换：将音频/视频文件转换为不同格式（如MP4转AVI、FLAC转MP3等）。
• 流媒体服务：实时编码和传输音视频流（如直播推流、RTMP/HTTP流媒体服务）。
• 音视频分析：检查媒体文件的编码信息、时长、比特率等元数据。
• 多媒体处理自动化：集成到脚本或应用中，实现批量处理音视频文件。
• 开发支持：作为开发环境，用于基于FFmpeg库的应用程序开发和测试。

使用方法和配置说明

Docker部署示例

基本使用（查看版本）

bash
docker run --rm docker.xuanyuan.run/ffmpeg ffmpeg -version

转换视频格式（MP4转WebM）

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

说明：-v $(pwd):/workdir将当前目录挂载到容器内的/workdir，实现文件输入输出。

分析媒体文件信息

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

播放媒体文件（需宿主机支持X11）

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

命令行工具基本用法

ffmpeg常用参数

• -i：指定输入文件
• -c:v：设置视频编码器（如libx264、libvpx）
• -c:a：设置音频编码器（如libmp3lame、libvorbis）
• -s：设置视频分辨率（如1280x720）
• -b:v：设置视频比特率（如1M表示1Mbps）
• -b:a：设置音频比特率（如128k表示128kbps）
• -t：设置输出文件时长（如00:01:30表示1分30秒）

文档和资源

离线文档

容器内的doc/目录包含离线文档。

在线文档

• 官方网站：https://ffmpeg.org
• 官方Wiki：https://trac.ffmpeg.org

示例代码

容器内的doc/examples目录提供C语言编码示例。

许可证

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

贡献方式

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