跳到主要内容
FFmpeg 教程

如何使用 FFmpeg 将 M3U8 转换为 MP4:完整命令行指南

HTTP 实时流(HLS)通过 .m3u8 播放列表以小分片传输视频。它非常适合流式播放,却无法通过简单的“另存为”获得本地视频文件。FFmpeg 是业界标准的开源工具,能够解析 M3U8 播放列表、下载分片,并将其复用为单个兼容性很高的 MP4 文件。

无论是归档点播资源、调试流封装,还是保存直播,FFmpeg 都提供了一套非常可靠的 HLS 流处理命令。本指南将讲解基本转换流程、高级音频处理、解密以及特定协议配置,帮助你实现无损提取。

为什么使用 FFmpeg?

网上大多数“M3U8 下载器”本质上都是 FFmpeg 的图形界面封装。直接使用 FFmpeg 可以完全掌控下载过程,包括应对严格的速率限制、指定自定义 HTTP 标头、准确选择音轨,以及在不造成不必要质量损失的情况下重新封装。

M3U8 转 MP4 的基本命令

将 HLS 流转换为 MP4 文件最简单的方法,是让 FFmpeg 直接读取清单 URL。假设已经安装 FFmpeg,请打开终端并运行:

ffmpeg -i "https://example.com/stream/playlist.m3u8" -c copy output.mp4

下面逐项说明这条命令的作用:

  • -i "url" 指定输入。如果 URL 包含可能破坏 Shell 命令的查询参数(如 ?token=123),引号就非常重要。
  • -c copy 指示 FFmpeg 直接复制视频和音频编码流(重新封装),而不会重新编码视频。这样既能保证零质量损失,也能让整个过程非常快,速度只受下载带宽限制。
  • output.mp4 是输出文件。.mp4 扩展名会让 FFmpeg 将下载的 H264/AAC 数据封装进 MP4 容器。

处理直播流与超时

对直播流执行基本命令时,FFmpeg 会持续下载分片且不会自行结束。要录制指定时长的直播,请使用 -t 参数,以秒数或 HH:MM:SS 格式指定时间。

ffmpeg -i "https://live-server.com/live.m3u8" -t 00:30:00 -c copy live_capture.mp4

避免连接中断

直播流可能丢失分片或暂停。若希望 FFmpeg 在网络短暂波动时继续重试,而不是立即失败,请添加 -reconnect 参数。

要让直播流下载更能抵御网络错误,请使用以下高级命令:

ffmpeg -reconnect 1 -reconnect_at_eof 1 -reconnect_streamed 1 -reconnect_delay_max 5 -i "https://live-server.com/live.m3u8" -c copy output.mp4

解密 AES-128 加密流

HLS 原生支持 AES-128 加密。如果播放列表包含 #EXT-X-KEY:METHOD=AES-128,URI="key.bin" 标签,只要 FFmpeg 能访问密钥 URI,就会自动完成解密。

如果密钥受身份验证保护或需要特定 Cookie,FFmpeg 会因 HTTP 403 禁止访问错误而失败。可以使用 -headers 参数,将 HTTP 标头和 Cookie 直接传给 FFmpeg。

ffmpeg -headers "Cookie: session_id=abc123xyz" -i "https://protected-site.com/video.m3u8" -c copy output.mp4
注意:FFmpeg 无法绕过 Widevine、FairPlay 或 PlayReady 等 DRM 方案(以 SAMPLE-AES 表示),只能解密使用明文密钥的标准 AES-128。

修复音画同步问题

原始 TS(传输流)分片的显示时间戳(PTS)有时会轻微错位。重新封装到 MP4 容器后,这可能导致音频逐渐偏离视频。

要强制 FFmpeg 在解复用阶段正确重建时间戳,请使用 -bsf:a aac_adtstoasc 比特流过滤器。它会将 ADTS AAC 音频转换为 MPEG-4 音频专用配置,通常可以修复 QuickTime 和常见浏览器中的播放问题。

ffmpeg -i "https://example.com/playlist.m3u8" -c copy -bsf:a aac_adtstoasc output.mp4

选择特定视频与音频轨道

主 M3U8 播放列表通常包含多个分辨率(360p、720p、1080p)。将主播放列表直接传给 FFmpeg 时,它通常会选择第一个可用流或质量最高的流。若要确保获得所需的准确版本,应使用 -map 功能。

要在不下载文件的情况下查看所有可用流,请运行:

ffmpeg -i "https://example.com/master.m3u8"

查找标有 Program 1、Program 2 等内容的行。如果要下载 Program 2(例如带英语音频的 1080p 轨道),请指定映射:

ffmpeg -i "https://example.com/master.m3u8" -map p:2 -c copy output.mp4

另一种更可靠的方法,是在文本编辑器(或浏览器开发者工具)中检查主清单,找到特定媒体播放列表的 URL(例如 1080p.m3u8),再把这个直接 URL 而非主 URL 传给 FFmpeg。

批量处理本地 M3U8 文件

如果已经将 .m3u8 清单和 .ts 分片下载到本地文件夹,仍可使用 FFmpeg 将它们合并。进入包含本地 .m3u8 文件的目录并运行:

ffmpeg -allowed_extensions ALL -i local_playlist.m3u8 -c copy output.mp4

读取本地播放列表时,-allowed_extensions ALL 参数至关重要,因为 FFmpeg 的默认安全模型会限制它读取文本文档中引用的任意本地文件。