sameersbn/ffmpeg

docker-ffmpeg 镜像文档

镜像概述

docker-ffmpeg是由sameersbn维护的Docker镜像，封装了FFmpeg工具及其依赖环境，旨在提供一个便捷、一致的音视频处理运行环境。该镜像基于轻量级基础镜像构建，可直接用于执行FFmpeg命令，无需在主机系统中单独安装FFmpeg及其依赖库，简化了音视频处理工具的部署与使用流程。

核心功能与特性

• 完整FFmpeg工具链：包含FFmpeg命令行工具及常用编解码器（如H.264、H.265、AAC等），支持多种音视频格式处理。
• 轻量级部署：基于精简基础镜像，镜像体积小，启动快速。
• 灵活的文件访问：支持通过卷挂载（Volume）访问主机文件系统，方便处理本地音视频文件。
• 跨平台兼容：可在任何支持Docker的系统（Linux、Windows、macOS）上运行，确保环境一致性。

使用场景

• 开发与测试环境：快速搭建FFmpeg测试环境，验证音视频处理命令。
• 自动化音视频处理：集成到CI/CD流程或脚本中，实现批量格式转换、压缩、剪辑等自动化任务。
• 服务器端音视频处理：在服务器环境中部署，处理用户上传的音视频文件（如转码、加水印等）。
• 学习与实验：无需复杂配置即可学习FFmpeg命令的使用。

使用方法

基本使用（docker run）

通过docker run命令直接执行FFmpeg命令，需挂载本地目录以访问输入输出文件：

bash
# 示例：将本地MP4文件转换为WebM格式
docker run --rm -v /path/to/local/files:/data sameersbn/ffmpeg \
  -i /data/input.mp4 -c:v libvpx -c:a libvorbis /data/output.webm

参数说明：

• --rm：容器退出后自动删除。
• -v /path/to/local/files:/data：将本地目录/path/to/local/files挂载到容器内/data目录，实现文件共享。
• sameersbn/ffmpeg：镜像名称。
• 后续为标准FFmpeg命令参数（如-i指定输入文件，-c:v指定视频编码器等）。

查看FFmpeg版本信息

bash
docker run --rm sameersbn/ffmpeg -version

复杂处理示例（添加水印）

bash
docker run --rm -v /path/to/files:/data sameersbn/ffmpeg \
  -i /data/input.mp4 -i /data/watermark.png \
  -filter_complex "overlay=10:10" \
  /data/output_with_watermark.mp4

docker-compose配置（可选）

若需频繁使用，可通过docker-compose.yml简化配置：

yaml
version: '3'
services:
  ffmpeg:
    image: sameersbn/ffmpeg
    volumes:
      - ./local_files:/data
    command: -i /data/input.mp4 -c:v libx264 -crf 23 /data/compressed.mp4

执行：docker-compose up

配置参数

卷挂载（Volumes）

• 必需：通过-v <本地目录>:<容器内目录>挂载文件目录，确保FFmpeg可访问输入文件并输出处理结果。建议将本地工作目录挂载到容器内/data目录（如示例所示）。

环境变量（可选）

该镜像暂无特殊环境变量配置，所有音视频处理参数通过FFmpeg命令行参数指定（参考FFmpeg官方文档）。

参考链接

• https://github.com/sameersbn/docker-ffmpeg
• https://github.com/sameersbn/docker-ffmpeg/releases
• https://github.com/sameersbn/docker-ffmpeg/blob/master/README.md
• https://github.com/sameersbn/docker-ffmpeg/issues