如何在Node.js中集成FFmpeg实现视频镜像翻转并添加水印

核心实现逻辑 #

不需要从零搭建视频解码、滤镜处理能力，本质是通过Node.js进程调用本地/服务器安装的FFmpeg可执行程序，完全复现原参考命令的处理效果。

前置准备 #

• 确认运行环境已正确安装FFmpeg，在终端执行ffmpeg -version能正常返回版本信息即代表安装有效
• 确认原视频、logo素材的存储路径对Node进程可读，最终输出目录对Node进程有写权限

方案1：使用fluent-ffmpeg封装库（推荐） #

这类库对原生FFmpeg的参数语法做了封装，不需要手动处理命令转义，自带错误捕获、处理进度监听能力，开发体验更友好。

1. 安装依赖
   执行安装命令：npm install fluent-ffmpeg
2. 参考实现代码

   const ffmpeg = require('fluent-ffmpeg');
   // 如果系统全局环境未配置FFmpeg路径，需要手动指定可执行文件的实际位置
   // ffmpeg.setFfmpegPath('/本机ffmpeg/可执行文件的绝对路径');
   
   ffmpeg()
     // 加载原始待处理视频
     .input('./input.mp4')
     // 加载需要叠加的logo素材
     .input('./logo.png')
     // 配置和原参考命令完全一致的滤镜链
     .complexFilter([
       'hflip[flipped]',
       '[flipped][1:v]overlay=x=10:y=10'
     ])
     // 指定处理完成后的输出文件路径
     .output('./out.mp4')
     // 绑定处理事件回调
     .on('end', () => {
       console.log('视频处理完成');
     })
     .on('progress', (progress) => {
       // 获取实时处理进度
       console.log(`当前处理进度：${(progress.percent || 0).toFixed(2)}%`);
     })
     .on('error', (err) => {
       console.error('处理失败：', err.message);
     })
     .run();
   

方案2：基于Node内置模块直接调用（无额外依赖） #

不引入第三方依赖，直接使用Node内置的child_process模块拉起FFmpeg进程，适合追求最小依赖体积的场景。
参考实现代码：

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

// 将原FFmpeg命令拆分为独立参数，避免路径包含空格时的转义异常
const ffmpegParams = [
  '-i', './input.mp4',
  '-i', './logo.png',
  '-filter_complex', 'hflip[flipped];[flipped]overlay=x=10:y=10',
  './out.mp4'
];

execFile('ffmpeg', ffmpegParams, (error) => {
  if (error) {
    console.error('处理失败：', error.message);
    return;
  }
  console.log('视频处理完成');
});

常见问题提示 #

• 所有相对路径的基准是Node进程的启动工作目录，路径复杂场景建议直接使用绝对路径，减少文件找不到的异常
• 容器/线上服务器部署时，要保证运行环境的FFmpeg版本和本地测试版本一致，避免滤镜参数不兼容导致的处理失败
• 大体积视频处理属于耗时操作，不要在HTTP接口的同步逻辑中等待处理完成，建议搭配任务队列做异步处理

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