rafalkrypa/ffmpeg

FFmpeg 静态构建 Docker 镜像

镜像概述

本镜像包含来自 [***] 的半官方 FFmpeg 静态二进制构建版本。通过 Docker 17.05 引入的多阶段构建技术，实现了镜像体积的最小化。该镜像基于 scratch（空镜像）构建，仅包含 FFmpeg 静态二进制文件，无其他冗余组件。

核心功能与特性

• 极小体积：采用多阶段构建技术，基于 scratch 镜像，仅保留 FFmpeg 静态二进制文件，显著减小镜像体积
• 静态构建：包含完整的 FFmpeg 静态二进制，无需依赖系统动态库，可直接运行
• 可靠来源：基于 johnvansickle.com 提供的半官方 FFmpeg 构建，确保功能完整性和稳定性

使用场景

• 轻量级视频/音频处理任务（格式转换、编码/解码、剪辑等）
• 媒体流处理服务
• 需要 FFmpeg 功能但对镜像体积有严格要求的容器化环境
• CI/CD 流程中的媒体文件处理步骤

使用方法

基本使用

查看 FFmpeg 版本信息

bash
docker run --rm johnvansickle/ffmpeg ffmpeg -version

执行简单的媒体转换

将本地文件挂载到容器中进行处理：

bash
docker run --rm -v $(pwd):/workdir johnvansickle/ffmpeg ffmpeg -i input.mp4 -c:v libx264 output.mp4

Docker Compose 配置示例

yaml
version: '3'
services:
  ffmpeg:
    image: johnvansickle/ffmpeg
    volumes:
      - ./media:/workdir
    command: ffmpeg -i /workdir/input.mkv -c:a copy /workdir/output.mp4

注意事项

• 由于镜像基于 scratch 构建，不含 shell 环境，直接运行容器时需显式指定 FFmpeg 命令及参数
• 处理本地文件时，需通过 -v 参数挂载宿主目录到容器内，确保文件可访问
• 可通过 FFmpeg 原生命令行参数实现各类媒体处理功能，具体参数参考 FFmpeg 官方文档