2026年了小程序和网课平台里还在用 m3u8 播视频的并不少。HLS 协议把视频切成几秒一个的 ts 片段播放器按顺序拉取再连续播放好处是弱网切换清晰度都比较稳坏处是想把视频“存下来离线看”的人找不到一个直接的 mp4 下载按钮。这篇文章不绕弯子先讲清楚 m3u8 视频的协议结构再说怎么在合规前提下拿到视频流地址用 FFmpeg 下载、解密、合并成 mp4最后处理最常见的几个坑。无论你是做视频下载工具开发还是想备份自己已购课程都可以按这套流程跑一遍。1. 核心能力速览能力项说明核心协议HLSHTTP Live Streamingm3u8 为播放列表文件主要用途定位小程序 / 网课平台中的视频流地址下载并转换为 MP4常用工具FFmpeg、浏览器开发者工具、抓包工具、N_m3u8DL-RE 等运行平台Windows / macOS / Linux 均可前置条件已获得视频内容的合法访问权限如已购买课程或已登录账号加密视频支持 AES-128 加密的 m3u8FFmpeg 可在拿到合法密钥后自动解码批量任务可通过脚本或工具参数批量处理多个 m3u8 链接实际效果取决于网络带宽、视频服务器限速、ts 片段数量和工具参数最终输出单个 MP4 文件或保留原始 ts 分片如果你只是偶尔下一两个视频看完第 5、6 节就够了。如果你要批量处理几十个课程链接建议直接看第 7 节的批量思路和第 8 节的排查清单。2. HLS 与 m3u8 协议基础m3u8 本质上是一个文本播放列表文件内容是 UTF-8 编码的扩展 M3U 格式。打开一个最常见的 m3u8 文件你会看到类似这样的结构#EXTM3U #EXT-X-VERSION:3 #EXT-X-TARGETDURATION:10 #EXT-X-MEDIA-SEQUENCE:0 #EXT-X-PLAYLIST-TYPE:VOD #EXTINF:10.000000, https://example.com/video/segment_00001.ts #EXTINF:10.000000, https://example.com/video/segment_00002.ts每个#EXTINF行后面跟的是分片文件地址播放器会逐个请求这些 ts 分片然后再连续渲染。这种按顺序切片的设计就是 HLS 最核心的思路。如果视频内容需要保护服务端通常会在 m3u8 里加一个#EXT-X-KEY标签#EXT-X-KEY:METHODAES-128,URIhttps://example.com/video/key.key,IV0x00000000000000000000000000000000METHODAES-128表示后续 ts 分片是用 AES-128 加密的解密密钥从URI指定的地址获取。这里的“解密”并不是什么破解操作而是播放器在播放过程中自动完成的常规步骤。只要你有合法的访问权限、会话有效播放器或下载工具就能拿到 key 并解出原始视频。理解了这两层结构之后后面的下载思路就很简单了找到视频播放时实际请求的 m3u8 地址。用工具拉取 m3u8 里的所有分片。按顺序合并必要时附带解密过程。转封装成 MP4。3. 适用场景与使用边界这套技术适合以下场景已经购买某门网课想下载到本地离线复习避免在线播放卡顿。自己开发的视频播放项目需要验证 HLS 播放效果。需要把合法取得的视频素材从 m3u8 流转换为 MP4 并做后期剪辑。做 HLS 视频下载器或者课程备份工具的开发测试。不合适的场景非常明确未购买、未授权的情况下下载付费课程属于对版权所有者的侵权。绕过付费墙、伪造授权、非法获取密钥并传播视频违反相关法律法规。将下载的视频二次售卖或公开传播风险极高。所以这篇文章里所有“获取 m3u8 地址”的操作前提都是你已经拥有正常访问权限。抓包、下载、解密这些操作和浏览器播放视频本质上是同一回事只是把“播放”变成了“保存”。工具本身是中性的具体用途需要你来把握。4. 环境准备与工具清单这一步先把工具备齐。以下工具全部免费适合 Windows / macOS / Linux。4.1 FFmpegFFmpeg 负责下载、解密、合并、转码是整个流程的核心。Windows 用户从官网下载 release 包解压后把bin目录加入系统 PATHmacOS 用户可以直接用 Homebrew 安装。# macOS 安装示例 brew install ffmpeg # 验证安装 ffmpeg -versionLinux 用户按发行版选择# Ubuntu / Debian sudo apt update sudo apt install ffmpeg # CentOS / RHEL sudo yum install epel-release sudo yum install ffmpeg4.2 浏览器开发者工具Chrome / Edge 自带的 DevTools 足够完成大多数地址定位。重点看 Network 面板里的media类型过滤m3u8 请求通常属于媒体资源。4.3 N_m3u8DL-RE可选这是 GitHub 上一个开源的 HLS 下载工具对比裸 FFmpeg 有更多优势自动合并、多线程下载、支持多种加密方式、输出目录结构化。如果你要批量下载课程可以优先考虑它。4.4 通用检查清单检查项说明是否已登录部分视频地址需要登录态才能访问是否已购买/授权未购买内容不建议尝试下载网络环境与视频服务器的连通性是否正常磁盘空间一个 1080P 时长的视频ts 分片占用的空间不可忽视端口占用后端工具或代理工具的端口是否被其他程序占用5. 如何定位小程序 / 网课视频的 m3u8 地址获取 m3u8 地址常见有两条路浏览器开发者工具和抓包工具。5.1 浏览器开发者工具适用于 Web 播放器如果网课平台用的是浏览器播放器定位地址非常简单打开课程播放页并开始播放视频。按F12打开开发者工具切到 Network 面板。在筛选框中输入m3u8或选择All再找类型为media的请求。播放器每次请求的是完整 m3u8 文件还是带m3u8?tokenxxx的动态地址都能在这个面板里看到。右键复制请求地址。注意很多平台的 m3u8 地址是带参数的例如https://example.com/playlist.m3u8?tokenabcexpires1690000000。这类地址有时效性复制后要尽快使用。5.2 抓包工具适用于小程序播放场景小程序里播放视频时请求过程不在浏览器开发者工具里直接抓包更直接。常用工具包括 Charles、Stream 等。基本步骤电脑和手机连同一个局域网。电脑端开启抓包代理并配置 HTTPS 证书。手机设置 HTTP 代理指向电脑。在小程序里播放目标视频观察请求。过滤m3u8或ts后缀找到视频流地址。这个流程有个前提你已经在小程序里登录并拥有播放权限。抓包只是把播放器发出的网络请求展示出来不会绕过任何授权。需要额外提醒的一点小程序平台本身不允许在非授权环境下抓取业务数据。如果你只是测试自己开发的小程序可以开启开发者工具中的合法调试通道。如果直接抓第三方小程序的包并下载其中未授权的付费内容会涉及版权和隐私合规问题不建议这么做。6. 使用 FFmpeg 下载 m3u8 视频流拿到 m3u8 地址后最直接的下载方式就是 FFmpeg。6.1 基础下载命令ffmpeg -i https://example.com/playlist.m3u8 -c copy output.mp4-c copy表示不重新编码直接把 ts 分片合并到 MP4 容器中速度快、画质无损。大多数 VOD 类型的 m3u8 都可以这样处理。6.2 加密视频的下载如果 m3u8 里带#EXT-X-KEYFFmpeg 会自动从 key 地址拉取密钥并解密。只要你的会话正常、key 地址可访问命令和基础下载完全一样。ffmpeg -headers Referer: https://example.com -i https://example.com/playlist.m3u8 -c copy output.mp4-headers参数用来携带 Referer 等信息。部分平台会校验来源不加 Referer 可能返回 403。6.3 处理特殊请求头有些平台要求更完整的请求头比如User-Agent和Cookie。你可以用-user_agent和-headers组合ffmpeg -user_agent Mozilla/5.0 (Windows NT 10.0; Win64; x64) \ -headers Referer: https://example.com/course/123\r\nCookie: sessionabc123 \ -i https://example.com/playlist.m3u8 \ -c copy output.mp4注意-headers里的多个字段要用\r\n分隔这是 FFmpeg 解析请求头时的固定格式要求。实际 Cookie 和 Referer 需要替换为你自己账号会话中的有效值。6.4 下载低清晰度分片部分 m3u8 会引用多码率播放列表类似#EXT-X-STREAM-INF:PROGRAM-ID1,BANDWIDTH2000000,RESOLUTION1920x1080 https://example.com/1080p/index.m3u8 #EXT-X-STREAM-INF:PROGRAM-ID1,BANDWIDTH1000000,RESOLUTION1280x720 https://example.com/720p/index.m3u8这种情况下直接下载外层 m3u8 时 FFmpeg 会默认选择最高码率。如果你想下载 720p 版本就要把内层的 url 复制出来作为下载地址ffmpeg -i https://example.com/720p/index.m3u8 -c copy output_720p.mp47. m3u8 转 MP4 与批量下载下载合并完成之后如果 FFmpeg 输出的还是 ts 容器没有完成转封装可以再执行一次转封装得到适用性更广的 MP4 文件。7.1 强制转封装为 MP4ffmpeg -i input.ts -c copy -movflags faststart output.mp4-movflags faststart会把 MP4 的索引信息移到文件头部适合边下边播的场景。7.2 批量下载多个课程链接把 m3u8 地址放在一个文本文件里每行一个链接然后用脚本循环处理。下面是一个 Python 调用 FFmpeg 的批量脚本示例import subprocess import os m3u8_list [ https://example.com/course01.m3u8, https://example.com/course02.m3u8, ] output_dir ./downloads os.makedirs(output_dir, exist_okTrue) for index, url in enumerate(m3u8_list, start1): output_file os.path.join(output_dir, fcourse_{index:02d}.mp4) command [ ffmpeg, -y, -i, url, -c, copy, output_file ] print(f正在下载: {url}) result subprocess.run(command, capture_outputTrue, textTrue) if result.returncode 0: print(f下载完成: {output_file}) else: print(f下载失败: {url}) print(result.stderr[-500:])实际使用时把m3u8_list替换成你自己的合法课程链接列表即可。建议在脚本里加入重试逻辑比如失败后等待 3 秒再重试一次避免网络抖动导致任务中断。7.3 使用 N_m3u8DL-RE 批量处理如果你更倾向专门的下载工具N_m3u8DL-RE 的批量参数更清晰N_m3u8DL-RE https://example.com/course01.m3u8 --save-dir ./downloads --save-name course01在 Windows 上也可以直接用命令行一次传多个 URL。工具会自动处理分片合并和加密分片还能选择输出格式。8. 资源占用与性能观察很多人会忽略这一块。实际上 m3u8 下载最耗资源的不是 CPU而是磁盘和网络。8.1 磁盘空间一小时的 1080P HLS 视频ts 分片总大小普遍在 1GB 到 2GB 左右。如果中间还包含不同码率的分片下载过程中的临时文件会更多。建议下载前确认磁盘剩余空间大于视频大小的 2 倍。下载完成后立即清理临时 ts 文件和日志。输出目录分课程、分日期管理避免文件混乱。8.2 网络与限速很多视频 CDN 会限制单链接速度。FFmpeg 在-c copy模式下基本属于纯网络 IO 操作CPU 占用很低瓶颈通常在网络。如果下载速度很慢可以尝试ffmpeg -http_multiple 1 -i https://example.com/playlist.m3u8 -c copy output.mp4-http_multiple 1允许 FFmpeg 并发请求多个 ts 分片对网速提升有帮助但在部分 CDN 上可能被拒绝需要实际测试。8.3 内存与进程残留正常下载时 FFmpeg 内存占用并不高但如果你用浏览器开发者工具、抓包工具、下载工具同时跑内存占用会明显上升。另外下载任务被中断时可能出现ffmpeg.exe进程残留Linux 下也可能出现僵死进程。遇到这种情况直接结束进程并重新执行命令即可。9. 常见问题与排查方法问题现象可能原因排查方式解决方案下载报 403 ForbiddenReferer 或 Cookie 缺失检查 FFmpeg 命令是否带-headers补充有效 Referer 和 Cookiem3u8 地址访问超时链接带时效参数已过期回播放页面重新抓取地址重新复制 m3u8 URL下载的 MP4 没有声音音频流是独立 m3u8检查原始播放列表是否有多个 media 条目单独下载音频流后合并出现 TLS/SSL 握手失败证书校验失败或代理冲突确认是否需要配置代理证书更新证书或在 FFmpeg 中配置-ssl_verify 0测试视频播放卡顿但文件已下载成功分片顺序错乱或存在丢帧用播放器检查关键帧位置使用 FFmpeg 重新转码修复磁盘空间不足导致下载中断ts 分片占用空间大查看磁盘占用清理空间后重新下载批量脚本中途失败某个链接失效或网络波动查看脚本 stderr 输出在脚本中加入重试机制下载后是 ts 不是 mp4分片未被封装用 ffprobe 查看容器格式执行ffmpeg -i input.ts -c copy output.mp4m3u8 里嵌套多码率外层是主播放列表查看 m3u8 内容跳转到内层码率地址再下载另外有一个高频问题m3u8视频转换失败。如果 FFmpeg 报No NVENC capable devices found或编码器相关错误说明命令里带了-c:v h264_nvenc这类 GPU 编码参数而当前机器不支持。解决方法很简单改用-c copy或软件编码libx264ffmpeg -i input.m3u8 -c:v libx264 -c:a aac output.mp4不过要注意重新编码会损失画质并显著提升 CPU 占用能-c copy就尽量-c copy。10. 最佳实践与合规建议到这里整套 m3u8 下载流程基本就齐了。给几个实践建议第一次跑通前先拿一个 1 分钟以内的测试视频练习不要直接对十几个链接开干。把 m3u8 地址、输出目录、课程名称按“日期-课程名-清晰度”命名避免下载完以后找不到对应内容。FFmpeg 命令写成长参数形式放在脚本里方便替换 URL 和输出路径。批量任务加上日志输出记录每个链接的下载状态方便排查失败项。下载完成后用ffprobe验证文件完整性和时长ffprobe -v error -show_entries formatduration -of defaultnoprint_wrappers1:nokey1 output.mp4涉及他人头像、声音、课程内容的视频下载后不要二次传播。只保留在自己可控的设备上用于离线学习。如果课程有明确禁止下载的条款建议先仔细阅读。授权边界不清晰的时候不要为了省事冒合规风险。对于想进一步扩展的人来说后续可以考虑把下载流程做成一个简单的 Web 服务前端粘贴 m3u8 地址后端调度 FFmpeg 任务输出 MP4 并返回下载链接。再配合数据库记录课程维度的下载状态就变成一个可复用的课程备份工具了。最后说回最开始的问题小程序视频课程、m3u8 视频下载、网课视频备份本质上都是围绕 HLS 协议做流式媒体的获取和转封装。只要保证自己拥有合法访问权限用 FFmpeg 等免费工具完全足够完成个人使用场景的需求。建议把 FFmpeg 的基本命令熟练记下来这套方法换个平台也能继续用。