thinkz/ffmpeg

镜像概述

本镜像基于Alpine 3.12系统构建，集成了FFmpeg音视频处理工具及librtmp库。FFmpeg是一款功能强大的音视频处理工具，支持格式转换、编解码、剪辑等操作；librtmp则提供对RTMP（实时消息传输协议）的支持，可实现RTMP流的推送与拉取。镜像体积轻量，适用于各类音视频处理场景及RTMP相关业务需求。

核心功能

FFmpeg基础功能

• 音视频格式转换（如MP4转FLV、AVI转MKV等）
• 音视频编解码（支持H.264、H.265、AAC等主流编码格式）
• 音视频剪辑与合并（截取片段、拼接多个文件）
• 滤镜处理（添加水印、调整画质/音量、裁剪尺寸等）
• 媒体信息提取（获取视频分辨率、比特率、时长等元数据）

librtmp扩展功能

• RTMP推流：将本地音视频文件或实时流推送到RTMP服务器（如直播平台）
• RTMP拉流：从RTMP服务器拉取实时流并保存为文件或进一步处理
• 支持RTMP协议的身份验证与参数配置（如设置推流密钥、超时时间等）

使用场景

• 音视频文件处理：批量转换用户上传的音视频文件格式，适配不同播放设备
• 直播推流：将本地摄像头采集的视频或预录制视频通过RTMP推送到直播平台
• 流录制：从RTMP直播流中实时录制内容，保存为本地文件用于回放或归档
• 边缘计算：在资源受限的边缘设备上轻量处理音视频流，降低中心服务器负载
• 教育/培训系统：处理教学视频（如添加水印、压缩大小）并通过RTMP实时推流教学内容

使用方法

基础命令格式

通过docker run执行FFmpeg命令，需将宿主机文件/目录挂载到容器内以实现文件交互，基本格式如下：

bash
docker run --rm -v [宿主机目录]:[容器内目录] thinkz/ffmpeg:latest ffmpeg [FFmpeg参数]

说明：--rm表示容器退出后自动删除，避免残留容器文件；-v用于挂载宿主机目录到容器内，实现文件读写。

常用操作示例

1. 查看FFmpeg版本及支持的编解码器

验证镜像功能完整性：

bash
docker run --rm thinkz/ffmpeg:latest ffmpeg -version
docker run --rm thinkz/ffmpeg:latest ffmpeg -encoders | grep -E "h264|aac"  # 查看是否支持H.264/AAC编码
docker run --rm thinkz/ffmpeg:latest ffmpeg -protocols | grep rtmp  # 验证RTMP协议支持

2. 本地文件格式转换

将宿主机/data/video目录下的input.mp4转码为FLV格式（适合RTMP分发），输出到同目录：

bash
docker run --rm -v /data/video:/workdir thinkz/ffmpeg:latest ffmpeg -i /workdir/input.mp4 -c:v libx264 -c:a aac -f flv /workdir/output.flv

• 参数说明：-i指定输入文件，-c:v libx264设置视频编码器为H.264，-c:a aac设置音频编码器为AAC，-f flv指定输出格式为FLV

3. RTMP推流（本地文件推送到直播服务器）

将本地视频文件推送到RTMP服务器（以推流地址rtmp://live.example.com/live/stream-key为例）：

bash
docker run --rm -v /data/video:/workdir thinkz/ffmpeg:latest ffmpeg -re -i /workdir/input.mp4 -c:v libx264 -c:a aac -f flv rtmp://live.example.com/live/stream-key

• 参数说明：-re表示按视频实际播放速度读取输入（避免推流速度过快），rtmp://...为目标RTMP服务器地址及流密钥

4. RTMP拉流录制

从RTMP服务器拉取实时流并保存为MP4文件（保存到宿主机/data/record目录）：

bash
docker run --rm -v /data/record:/workdir thinkz/ffmpeg:latest ffmpeg -i rtmp://live.example.com/live/stream-key -c copy /workdir/live_record.mp4

• 参数说明：-c copy表示直接复制流数据（不重新编码），减少CPU占用，适用于快速录制

相关链接

• 项目源码及更多示例：https://github.com/ThinkZ/ffmpeg/