kartaltabak/ffmpeg

FFmpeg Docker镜像文档

镜像概述

本Docker镜像提供预配置的FFmpeg环境，同时集成多种字体，旨在简化音视频处理流程，特别适用于需要文本叠加、字幕渲染等依赖字体的场景，无需额外安装字体文件即可直接使用。

核心功能和特性

• 完整FFmpeg工具链：包含FFmpeg核心组件，支持音视频编解码、转码、剪辑、滤镜等基础及高级操作。
• 内置多种字体：预先集成常用字体文件，满足文本水印、动态字幕等场景的字体需求。
• 即开即用：无需手动配置字体环境，拉取镜像后可直接执行FFmpeg命令。

使用场景和适用范围

• 音视频格式转换与编码处理
• 视频添加文字水印或动态文本元素
• 字幕文件渲染与合成
• 批量音视频处理自动化任务
• 需要字体支持的FFmpeg滤镜应用（如drawtext）

使用方法和配置说明

基本使用（docker run）

bash
docker run --rm -v /本地媒体路径:/media 镜像名称 ffmpeg -i /media/输入文件 -vf "drawtext=fontfile=/usr/share/fonts/字体文件.ttf:text='文本内容':x=10:y=10:fontsize=24:fontcolor=white" /media/输出文件

参数说明：

• --rm：容器退出后自动删除
• -v /本地媒体路径:/media：挂载本地媒体目录到容器内/media，用于输入输出文件
• drawtext滤镜：使用内置字体添加文本，需指定容器内字体路径（通常位于/usr/share/fonts/目录）

查看内置字体

通过以下命令列出容器内所有可用字体：

bash
docker run --rm 镜像名称 fc-list

自定义字体扩展

如需添加额外字体，可通过挂载字体目录实现：

bash
docker run --rm -v /本地字体目录:/usr/share/fonts/custom -v /本地媒体路径:/media 镜像名称 ffmpeg [FFmpeg命令参数]

注意事项

• 确保本地媒体目录挂载路径正确，避免文件权限问题
• 字体文件路径需使用容器内绝对路径，可通过fc-list命令获取具体字体路径
• 复杂FFmpeg命令建议参考FFmpeg官方文档调整参数