liviudm/ffmpeg

ffmpeg 最小化Docker镜像文档

镜像概述

本镜像基于Alpine Linux构建，提供最小化的ffmpeg工具集。通过Alpine的轻量级特性，显著减小镜像体积，同时保留ffmpeg核心音视频处理功能，适用于对资源占用敏感的场景。

核心功能与特性

• 轻量级设计：基于Alpine Linux，镜像体积远小于基于其他Linux发行版的ffmpeg镜像
• 完整功能：包含ffmpeg核心工具，支持音视频编解码、格式转换、流媒体处理等基础功能
• 资源高效：低内存占用和磁盘空间需求，适合边缘计算、嵌入式环境或资源受限的服务部署
• 多平台支持：支持常见架构（如x86_64、arm64），适配多种运行环境

使用场景与适用范围

• 开发环境中的音视频处理测试与验证
• CI/CD流程中的自动化音视频格式转换任务
• 轻量级服务中的音视频处理模块（如小型媒体服务器、视频转码服务）
• 边缘设备或嵌入式系统中的音视频处理需求

使用方法与配置说明

基本使用

通过docker run命令直接调用ffmpeg功能：

bash
# 查看ffmpeg版本信息
docker run --rm ffmpeg-alpine ffmpeg -version

# 转换视频格式（将input.mp4转换为output.avi）
docker run --rm -v $(pwd):/workdir ffmpeg-alpine ffmpeg -i /workdir/input.mp4 /workdir/output.avi

挂载文件系统

为处理本地文件，需挂载主机目录到容器内：

bash
# 挂载当前目录作为工作目录
docker run --rm -v $(pwd):/data ffmpeg-alpine ffmpeg -i /data/input.mkv -c:v libx264 /data/output.mp4

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  ffmpeg:
    image: ffmpeg-alpine
    volumes:
      - ./media:/media  # 挂载媒体文件目录
    command: ffmpeg -i /media/input.flv -c:a aac -b:a 128k /media/output.mp3

运行服务：

bash
docker-compose up

常用命令示例

• 提取视频中的音频：

  bash
  docker run --rm -v $(pwd):/data ffmpeg-alpine ffmpeg -i /data/video.mp4 -vn -acodec copy /data/audio.aac
  

• 调整视频分辨率：

  bash
  docker run --rm -v $(pwd):/data ffmpeg-alpine ffmpeg -i /data/input.mp4 -s 1280x720 /data/output_720p.mp4
  

• 生成视频缩略图：

  bash
  docker run --rm -v $(pwd):/data ffmpeg-alpine ffmpeg -i /data/video.mp4 -ss 00:00:10 -vframes 1 /data/thumbnail.jpg
  

注意事项

• 由于Alpine Linux使用musl libc，部分依赖glibc的ffmpeg功能可能受限
• 如需使用额外编解码器，需基于此镜像构建自定义版本并安装相关依赖
• 处理大文件时建议增加容器内存限制：--memory=2g