引言
随着在线视频需求的激增，HTTP Live Streaming（HLS）因其广泛的设备兼容性（尤其在 iOS 和现代浏览器中）和自适应码率能力，已成为主流的流媒体传输协议。HLS 的核心在于将一个完整的视频文件切分为一系列小的 .ts（MPEG-TS）片段，并生成对应的 .m3u8 播放列表文件。
在 Node.js 生态中，fluent-ffmpeg 作为对 FFmpeg 命令行工具的优雅封装，极大简化了音视频处理流程。本文将详细介绍如何使用 fluent-ffmpeg 将任意格式的视频文件（如 MP4、AVI、MOV）高效转码并切片为符合 HLS 标准的 .ts 片段与 .m3u8 索引文件，为构建自定义流媒体服务奠定基础。
一、前置准备
1. 安装依赖
确保系统已安装 FFmpeg（建议 4.0+ 版本），并安装 Node.js 依赖：
npm install fluent-ffmpeg💡 提示：可通过
ffmpeg -version验证 FFmpeg 是否可用。若未安装，请参考 FFmpeg 官网 或使用包管理器（如brew install ffmpeg/apt install ffmpeg）。
2. 目录结构规划
建议创建清晰的输出目录，例如：
/output/
├── master.m3u8 # 主播放列表（可选）
├── stream_720p/ # 720p 分辨率子流
│ ├── index.m3u8
│ └── segment_0.ts, segment_1.ts, ...
└── stream_480p/ # 480p 子流（多码率场景）二、基础 HLS 切片实现
以下代码将单个输入视频转码为固定分辨率的 HLS 流：
const ffmpeg = require('fluent-ffmpeg');
const path = require('path');
// 输入与输出配置
const inputPath = './input.mp4';
const outputDir = './output/stream_720p';
const playlistName = 'index.m3u8';
// 确保输出目录存在（可使用 fs.mkdirSync 或 mkdirp）
ffmpeg(inputPath)
.addOption('-profile:v', 'baseline') // 兼容性最佳的 H.264 profile
.addOption('-level', '3.0')
.addOption('-start_number', 0)
.addOption('-hls_time', 10) // 每个 ts 片段时长（秒）
.addOption('-hls_list_size', 0) // 0 表示保留所有片段（点播）
.addOption('-f', 'hls') // 输出格式为 HLS
.addOption('-hls_segment_filename', path.join(outputDir, 'segment_%03d.ts'))
.output(path.join(outputDir, playlistName))
.on('end', () => {
console.log('✅ HLS 转码与切片完成！');
})
.on('error', (err) => {
console.error('❌ 转码失败:', err.message);
})
.run();关键参数说明：
-hls_time 10：每个.ts文件约 10 秒（实际可能略长，FFmpeg 会在关键帧处切割）；-hls_list_size 0：生成完整播放列表（适用于点播）；若为直播可设为正整数（如 5）仅保留最近 N 个片段；-hls_segment_filename：指定片段命名模板，%03d表示三位数字序号（000, 001...）；-profile:v baseline -level 3.0：确保最大设备兼容性（尤其移动端）。
三、进阶：多码率自适应 HLS（ABR）
为支持不同网络环境下的流畅播放，可生成多个分辨率/码率的子流，并创建主播放列表（master playlist）：
const resolutions = [
{ name: '480p', width: 854, bitrate: '800k' },
{ name: '720p', width: 1280, bitrate: '2000k' },
{ name: '1080p', width: 1920, bitrate: '4000k' }
];
const generateVariant = (input, res) => {
const dir = `./output/stream_${res.name}`;
return new Promise((resolve, reject) => {
ffmpeg(input)
.videoCodec('libx264')
.audioCodec('aac')
.size(`${res.width}x?`) // 高度自动保持比例
.videoBitrate(res.bitrate)
.audioBitrate('128k')
.addOption('-profile:v', 'main')
.addOption('-preset', 'fast')
.addOption('-hls_time', 6)
.addOption('-hls_list_size', 0)
.addOption('-f', 'hls')
.addOption('-hls_segment_filename', `${dir}/segment_%03d.ts`)
.output(`${dir}/index.m3u8`)
.on('end', resolve)
.on('error', reject)
.run();
});
};
// 并行生成所有变体
Promise.all(resolutions.map(r => generateVariant('./input.mp4', r)))
.then(() => {
// 生成主播放列表 master.m3u8
const masterPath = './output/master.m3u8';
let masterContent = '#EXTM3U\n#EXT-X-VERSION:3\n';
resolutions.forEach(r => {
masterContent += `#EXT-X-STREAM-INF:BANDWIDTH=${parseInt(r.bitrate)*1000},RESOLUTION=${r.width}x${Math.round(r.width * 9 / 16)}\n`;
masterContent += `stream_${r.name}/index.m3u8\n`;
});
require('fs').writeFileSync(masterPath, masterContent);
console.log('✅ 多码率 HLS 流生成完成！');
})
.catch(console.error);📌 注意：主播放列表中的
BANDWIDTH单位为 bps（比特/秒），需将'800k'转换为800000。
四、优化与注意事项
-
关键帧对齐：为确保多码率流切换平滑，各变体应使用相同的关键帧间隔（GOP）。可添加：
.addOption('-g', 60) // GOP = 60 帧（假设 30fps，则每 2 秒一个关键帧） -
音频统一处理：避免每个变体重复编码音频，可先提取 AAC 音频，再复用。
-
CDN 与缓存 ：
.m3u8文件应设置短缓存（如Cache-Control: max-age=2），而.ts文件可长期缓存。 -
错误处理：生产环境中需监控 FFmpeg 进程、磁盘空间及输入文件有效性。
-
性能考量：高分辨率视频转码消耗大量 CPU，建议使用工作队列或云函数异步处理。
五、验证与播放
生成完成后，可通过以下方式测试：
-
本地 HTTP 服务 （因 HLS 需通过 HTTP 加载）：
npx http-server ./output -p 8080 -
播放地址 ：
http://localhost:8080/master.m3u8 -
播放器 ：使用 hls.js（浏览器）或原生 Safari / iOS AVPlayer。
结语
借助 fluent-ffmpeg，开发者可以高效、灵活地将任意视频资产转化为标准 HLS 流，无需深入 FFmpeg 命令细节。无论是构建点播平台、直播回看系统，还是为移动应用提供自适应视频服务，这一方案都提供了坚实的技术基础。未来还可结合对象存储（如 S3）、边缘计算与实时转码服务，打造端到端的云原生流媒体架构。
让视频流动起来，从一行代码开始。