如何在Node.js中生成视频缩略图并直接获取buffer无需保存到本地文件

核心逻辑是让ffmpeg将生成的缩略图直接输出到标准输出流，而非本地磁盘文件，再在业务代码中捕获该输出流即可直接得到buffer数据，无需本地IO操作。

调整后的ffmpeg命令 #

如果要输出单帧JPEG格式的缩略图，命令模板如下：
ffmpeg -ss {中点时间戳秒数} -i video.mp4 -vframes 1 -q:v 2 -f image2pipe -
参数说明：

• -vframes 1：仅输出1帧图像，符合缩略图提取需求，你原命令中写的-t 4是输出4秒内容，仅提取单帧的话可以删除
• -q:v 2：控制JPEG输出质量，取值范围为2-31，数值越小质量越高，2为最高质量
• -f image2pipe：指定输出格式为管道流，避免ffmpeg因无法从输出文件后缀推断格式导致报错
• 末尾的-：代表将输出内容写入标准输出流，而非写入本地文件

如果需要自动计算视频中点时间戳，可以先通过ffprobe获取视频总时长，再除以2得到中点时间戳：
ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 video.mp4

代码示例（捕获输出得到Buffer） #

Python示例 #

使用subprocess模块捕获子进程的stdout输出：

import subprocess

mid_time = 146 # 替换为实际计算得到的中点时间戳（单位：秒）
cmd = [
    "ffmpeg",
    "-ss", str(mid_time),
    "-i", "video.mp4",
    "-vframes", "1",
    "-q:v", "2",
    "-f", "image2pipe",
    "-"
]
result = subprocess.run(cmd, stdout=subprocess.PIPE, stderr=subprocess.DEVNULL)
thumbnail_buffer = result.stdout

Node.js示例 #

使用child_process模块执行命令获取Buffer：

const { execFileSync } = require('child_process');

const midTime = 146; // 替换为实际计算得到的中点时间戳（单位：秒）
const cmd = 'ffmpeg';
const args = [
    '-ss', midTime.toString(),
    '-i', 'video.mp4',
    '-vframes', '1',
    '-q:v', '2',
    '-f', 'image2pipe',
    '-'
];
const thumbnailBuffer = execFileSync(cmd, args, { stdio: ['ignore', 'pipe', 'ignore'] });

注意事项 #

• 如果你的设备没有将ffmpeg加入系统环境变量，需要将命令中的ffmpeg替换为ffmpeg程序的完整绝对路径
• 如果需要PNG格式的缩略图，将-f image2pipe修改为-f png即可
• 请确保-ss参数放在-i参数之前，这样ffmpeg会直接跳转到对应时间点处理，执行效率会高很多

内容的提问来源于stack exchange，提问作者Jourdelune