rupakg/docker-ffmpeg-thumb

docker-ffmpeg-thumb

镜像概述

本镜像基于https://hub.docker.com/r/jrottenberg/ffmpeg/%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%93%E6%B3%A8%E4%BA%8E%E7%AE%80%E5%8C%96%E8%A7%86%E9%A2%91%E7%BC%A9%E7%95%A5%E5%9B%BE%E7%94%9F%E6%88%90%E6%B5%81%E7%A8%8B%EF%BC%8C%E6%94%AF%E6%8C%81%E4%BB%8E%E8%A7%86%E9%A2%91%E6%96%87%E4%BB%B6%E4%B8%AD%E6%8F%90%E5%8F%96%E6%8C%87%E5%AE%9A%E6%97%B6%E9%97%B4%E7%82%B9%E7%9A%84%E5%B8%A7%E5%B9%B6%E8%BE%93%E5%87%BA%E4%B8%BA%E5%9B%BE%E7%89%87%E6%96%87%E4%BB%B6%E3%80%82

核心功能

• 从视频文件（URL或本地路径）提取指定时间点的帧
• 生成PNG格式的缩略图
• 通过目录挂载快速获取输出文件

使用场景

• 视频平台自动生成预览缩略图
• 媒体处理系统批量生成视频帧截图
• 个人项目快速获取视频关键帧

配置说明

环境变量

• INPUT_VIDEO_FILE_URL：待处理视频的URL或容器内可访问的本地路径
• POSITION_TIME_DURATION：提取帧的时间位置（格式如"00:00:05"表示第5秒）
• OUTPUT_VIDEO_FILE_NAME：输出缩略图的文件名（例如"output.png"）

挂载目录

将本地目录挂载到容器的/tmp/workdir，用于接收生成的缩略图文件

部署示例

构建镜像

bash
docker build -t rupakg/docker-ffmpeg-thumb .

运行容器

bash
docker run -v /本地路径:/tmp/workdir \
    -e INPUT_VIDEO_FILE_URL='视频文件URL' \
    -e POSITION_TIME_DURATION='00:00:03' \
    -e OUTPUT_VIDEO_FILE_NAME='thumbnail.png' \
    rupakg/docker-ffmpeg-thumb

运行后，缩略图thumbnail.png将生成在本地挂载的/本地路径目录中。