onerahmet/ffmpeg

FFmpeg容器

一个用于运行FFmpeg命令的轻量级Docker容器。

该容器提供即用的FFmpeg环境，用于音视频处理。基于Alpine Linux构建，在包含常用FFmpeg编解码器和工具的同时保持较小体积。

使用方法

拉取并运行容器：

shell
docker pull onerahmet/ffmpeg
docker run --rm -v "$(pwd):/workspace" onerahmet/ffmpeg -i input.mp4 output.mp4

-v "$(pwd):/workspace"标志将当前目录挂载到容器内的/workspace目录，使FFmpeg能够访问本地文件。

示例命令

1. 转换视频格式：

shell
docker run --rm -v "$(pwd):/workspace" onerahmet/ffmpeg -i input.mp4 output.mkv

2. 从视频中提取音频：

shell
docker run --rm -v "$(pwd):/workspace" onerahmet/ffmpeg -i input.mp4 -vn -acodec libmp3lame output.mp3

3. 压缩视频：

shell
docker run --rm -v "$(pwd):/workspace" onerahmet/ffmpeg -i input.mp4 -c:v libx264 -crf 23 -preset medium -c:a aac output.mp4

4. 创建视频缩略图：

shell
docker run --rm -v "$(pwd):/workspace" onerahmet/ffmpeg -i input.mp4 -ss 00:00:01 -vframes 1 -q:v 2 thumbnail.jpg

构建容器

构建容器时需要指定FFmpeg版本：

shell
docker build --build-arg FFMPEG_VERSION=n7.1 -t onerahmet/ffmpeg:7.1 .

可用版本可在https://github.com/FFmpeg/FFmpeg/tags%E4%B8%AD%E6%89%BE%E5%88%B0%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%9A

• n7.1
• n6.0

注意：必须提供FFMPEG_VERSION构建参数，否则构建将失败。

核心功能与特性

• 基于Alpine Linux，镜像体积小（约120MB）
• 包含常用FFmpeg编解码器和工具
• 简单的卷挂载，便于文件访问
• 支持所有标准FFmpeg命令和选项

使用注意事项

• 所有命令在容器内的/workspace目录中运行
• 输入和输出文件必须在挂载的卷中可访问
• 使用绝对路径或相对于挂载目录的路径

许可证

本项目采用MIT许可证 - 详见LICENSE文件。

致谢

本容器打包了FFmpeg，这是一个完整的跨平台音视频记录、转换和流媒体解决方案。FFmpeg采用LGPL v2.1+许可证。

FFmpeg是Fabrice Bellard的商标，他是FFmpeg项目的创始人。