1. 项目缘起为什么我们需要自己动手处理HLS直播流最近在折腾一个项目需要把一些线上直播的内容留存下来做后续分析。这些直播源大多是HLS协议也就是大家常说的m3u8流。一开始我也图省事想着找个现成的录屏软件对着浏览器窗口一录不就完了但实际操作下来发现一堆问题网络稍有波动录出来的视频就卡顿丢帧直播时间一长录出来的文件巨大无比后期处理麻烦更别提有些页面还有防录屏机制直接黑屏或者弹出警告。折腾了几轮之后我算是明白了对于需要高质量、自动化留存HLS直播内容的需求靠传统录屏软件属于“治标不治本”。最根本的解决思路应该是直接抓取传输过程中的流媒体数据并重组这才是“釜底抽薪”的办法。这也就是我动手研究“m3u8直播流实时下载”的初衷——不依赖任何客户端录屏直接从网络层拦截和保存HLS流实现稳定、高效、自动化的直播内容获取。这个方法的核心价值在于“源头抓取”。它跳过了播放器渲染和屏幕采集这两个容易出问题的环节直接处理传输数据因此理论上只要你能正常观看直播就能把它完整地保存下来不受画面复杂度、系统负载甚至一些基础防录屏措施的影响。对于做内容归档、舆情分析、教学复盘或者单纯想收藏直播的朋友来说掌握这套方法能解决很多实际问题。2. HLS技术原理快速解读m3u8与TS切片在动手之前我们有必要快速理解一下HLS到底是怎么工作的。这能帮我们在后续抓包和处理时清楚地知道每一步在做什么遇到问题也知道该往哪个方向排查。HLS全称是HTTP Live Streaming是苹果公司提出的一套基于HTTP的流媒体传输协议。它的设计思想非常巧妙把一整个大的视频文件切割成无数个小的、易于通过网络传输的文件片段通常是.ts格式的视频切片然后用一个名为m3u8的索引文件播放列表来告诉播放器这些片段的顺序和地址。播放器就像听指挥一样按顺序去下载并播放这些.ts片段从而实现流式播放。2.1 m3u8索引文件直播流的“节目单”m3u8文件本质上是一个文本文件你可以用任何文本编辑器打开它。它的内容结构决定了直播流的类型和播放逻辑主要分为两类点播VOD列表包含所有TS切片的完整列表以及每个切片的时长。这种列表是固定的用于回放已结束的视频。直播列表这是一个动态更新的列表。它通常只包含最近一段时间内生成的TS切片。在文件里你会看到一个#EXT-X-PLAYLIST-TYPE:EVENT或#EXT-X-ENDLIST标签后者表示直播已结束。对于正在进行的直播列表会不断滚动更新新的切片URL被加入顶部或底部老的切片URL可能会被移除。一个典型的直播m3u8文件内容看起来是这样的#EXTM3U #EXT-X-VERSION:3 #EXT-X-TARGETDURATION:10 #EXT-X-MEDIA-SEQUENCE:163 #EXTINF:10.000, https://example.com/live/stream-163.ts #EXTINF:10.000, https://example.com/live/stream-164.ts #EXTINF:10.000, https://example.com/live/stream-165.ts#EXT-X-TARGETDURATION:10表示每个TS切片的最大时长大约是10秒。#EXT-X-MEDIA-SEQUENCE:163表示当前列表中第一个TS切片的序列号是163。这个序列号会随着直播推进而递增。#EXTINF行指明了下一个TS切片的持续时间紧接着的一行就是该切片的具体网络地址。2.2 TS切片视频内容的“数据块”.ts文件是实际的视频数据容器里面封装了遵循MPEG-2 TS流格式的音视频数据。每个.ts文件通常只有几秒到十几秒的长度这种设计带来了几个好处适应网络波动即使某个切片下载失败或缓慢也只会影响很小一段内容的播放播放器可以快速切换到下一个切片或者尝试重新下载从而保证播放的流畅性。便于CDN缓存和分发小文件更容易被CDN边缘节点缓存加速不同地区用户的访问速度。支持自适应码率HLS可以同时提供多种不同分辨率、码率的m3u8索引文件主列表播放器可以根据当前网速自动选择最合适的流进行播放这就是我们看到的“清晰度切换”。注意有些复杂的HLS流会采用“多级m3u8”结构。即第一个m3u8文件主列表里不直接包含.ts地址而是包含了几个子m3u8文件的地址这些子m3u8文件才分别对应不同码率的TS切片列表。我们在处理时需要递归地解析找到最终的.ts链接。理解了这些我们的任务就清晰了首先找到直播流的m3u8索引文件地址然后持续监控并下载这个m3u8文件解析出其中列出的所有.ts切片地址最后按顺序将这些.ts切片下载下来合并成一个完整的视频文件。3. 核心工具链选型与实战环境准备工欲善其事必先利其器。实现HLS流下载我们可以选择从零开始写脚本也可以利用一些成熟的开源工具。这里我推荐一种“组合拳”策略用专业工具抓取和解析流地址用灵活脚本控制下载和合并流程。这样既保证了可靠性又保留了自定义空间。3.1 流地址探测与抓包工具在下载之前我们得先拿到m3u8文件的真实URL。这是最关键的一步有几种常见方法浏览器开发者工具最简单直接这是我最推荐新手使用的方法。以Chrome浏览器为例打开直播页面并开始播放。按下F12打开开发者工具切换到Network网络面板。在筛选器Filter中输入m3u8。通常你就能立刻看到浏览器请求的m3u8文件。点击这个m3u8请求在Headers标签页中找到Request URL这个就是m3u8文件的地址。复制它。实操心得有时候直播流使用了HTTPS或者带有查询参数务必完整复制整个URL。另外注意观察请求的Referer和User-Agent有些服务器会校验这些信息我们在后续用下载工具时可能需要模拟这些请求头。专业抓包软件如果浏览器工具里找不到比如一些客户端应用或特殊协议可以使用像Wireshark或Fiddler这样的抓包工具。它们能捕获系统所有网络流量过滤出HTTP/HTTPS请求找到其中的m3u8链接。使用这类工具需要一点网络知识但功能更强大。浏览器插件有一些专门用于嗅探视频流的浏览器插件例如“Stream Video Downloader”等。它们可以自动检测页面中的视频流并显示地址对于简单场景很方便。3.2 HLS下载专用工具拿到m3u8地址后我们需要一个能理解HLS协议的工具来帮我们完成持续的下载和合并。这里有几个经典选择FFmpeg万能媒体工具这绝对是处理多媒体任务的瑞士军刀。它原生支持HLS协议可以直接将m3u8 URL作为输入输出为一个完整的视频文件。命令简单粗暴ffmpeg -i https://example.com/live/stream.m3u8 -c copy output.mp4-i后面跟着你的m3u8地址。-c copy表示直接复制流而不进行重新编码速度极快画质无损。output.mp4是输出的文件名。 FFmpeg会自动处理TS切片的下载、按序拼接和封装。对于大多数不加密的直播流这一条命令就足够了。N_m3u8DL-CLI又名N_m3u8DL-RE这是一个用Go语言编写的高性能HLS下载器在爱好者社区非常流行。它的优势在于速度快支持多线程并发下载TS切片极大提升下载效率。功能强自动处理密钥解密针对一些加密的HLS流、自动合并、生成元数据文件等。易用性提供命令行和图形界面两种版本。 基本使用命令N_m3u8DL-RE https://example.com/live/stream.m3u8 --workDir ./downloads --saveName my_videoyoutube-dl / yt-dlp这两个是知名的视频网站下载工具它们也支持HLS流。yt-dlp是youtube-dl的一个更活跃的分支功能更新更快。它们的好处是能模拟浏览器行为绕过一些简单的反爬机制。yt-dlp -o output.mp4 https://example.com/live/stream.m3u83.3 环境准备与工具安装为了完成整个流程你需要准备一个可以运行命令行工具的环境。Windows、macOS、Linux均可。安装FFmpegmacOS使用Homebrew最简单brew install ffmpegUbuntu/Debiansudo apt update sudo apt install ffmpegWindows到FFmpeg官网下载编译好的可执行文件解压后将bin目录添加到系统的环境变量PATH中。 安装后在终端输入ffmpeg -version验证是否成功。安装N_m3u8DL-RE访问其GitHub发布页面下载对应你操作系统的最新版本。解压后即可得到可执行文件。在终端中进入该文件所在目录即可运行。可选安装yt-dlp使用pippip install yt-dlp或直接下载其独立的可执行文件。工具选型建议对于绝大多数公开、未加密的HLS直播流FFmpeg是最简单、最通用的选择一行命令解决问题。如果你的网络环境好想下载得更快或者遇到需要解密AES-128加密的流N_m3u8DL-RE是更专业的工具。而yt-dlp则在下载各大视频网站公开内容时这些网站也多用HLS有奇效因为它内置了很多网站的特殊解析逻辑。4. 分步实战从抓取地址到完整视频生成现在我们结合一个模拟的实战场景把整个流程走一遍。假设我们要下载一个B站某个直播的回放注此例仅用于技术演示请务必遵守相关平台用户协议和版权规定。4.1 第一步定位并获取m3u8地址打开目标直播回放页面让视频开始播放。打开浏览器开发者工具F12进入Network面板筛选m3u8。刷新页面观察网络请求。你可能会看到多个m3u8请求它们通常对应不同的清晰度如720p.m3u8,1080p.m3u8。选择一个你想要的清晰度对应的m3u8请求右键点击它选择“Copy” - “Copy link address”。这样就得到了最关键的索引文件地址。示例地址可能类似于https://xxx.bilibili.com/xxx/playlist.m3u8?xxxxxx4.2 第二步使用FFmpeg进行基础下载与合并这是最快捷的方法。打开你的终端命令行窗口输入以下命令ffmpeg -i 你复制的m3u8地址 -c copy -bsf:a aac_adtstoasc bilibili_live_output.mp4-i指定输入URL。-c copy音视频流都直接复制不重新编码。-bsf:a aac_adtstoasc这是一个比特流过滤器用于处理某些TS流中的AAC音频头使其能正确封装进MP4。这是一个非常实用的参数能解决部分TS流合并后音频无法播放的问题。bilibili_live_output.mp4你希望输出的文件名。按下回车FFmpeg就会开始工作。你会看到它不断输出日志显示正在下载和拼接TS片段。直播回放是固定长度的所以下载完成后它会自动退出并生成最终的mp4文件。4.3 第三步使用N_m3u8DL-RE进行高效下载如果你追求更快的下载速度或者FFmpeg遇到问题可以换用N_m3u8DL-RE。将下载好的N_m3u8DL-RE可执行文件放在一个方便的目录比如D:\hls_downloader。在此目录打开命令行Windows下可在文件资源管理器地址栏输入cmd回车。运行命令N_m3u8DL-RE.exe 你复制的m3u8地址 --workDir ./downloaded_videos --saveName 我的直播录像 --enableDelAfterDone--workDir指定下载文件保存的目录。--saveName指定输出文件的主文件名不含扩展名。--enableDelAfterDone下载合并完成后自动删除零散的.ts切片文件只保留最终合并好的文件。工具会开始运行它默认会使用多线程下载你可以看到实时的下载速度和进度。完成后在./downloaded_videos目录下就能找到合并好的视频文件通常是.mp4或.mkv。4.4 第四步处理实时直播流下载实时直播流与下载回放的区别在于直播是持续不断的m3u8文件内容在动态更新。使用FFmpeg命令完全一样。FFmpeg会持续监控m3u8文件的变化只要有新的TS切片出现就会自动下载并追加到输出文件中。你需要手动决定何时停止。在终端中按下CtrlC即可终止FFmpeg进程此时它会完成最后一个切片的写入并关闭文件你得到的就是从开始到结束录制时间点的完整视频。关键技巧你可以使用FFmpeg的-t参数来限制录制时长。例如-t 01:00:00表示录制1小时。使用N_m3u8DL-RE它同样支持直播流。对于直播它会持续运行直到你手动中断CtrlC。中断后它也会自动将已下载的切片合并成最终文件。重要注意事项录制实时直播时请确保网络稳定。如果中途网络中断FFmpeg或下载工具可能会报错退出。对于重要的直播可以考虑在更稳定的服务器环境下运行此任务。5. 进阶技巧与常见问题深度排查掌握了基本操作后我们来看看那些“坑”和提升效率的技巧。5.1 处理加密的HLS流AES-128加密许多商业直播平台会使用AES-128加密来保护TS切片。此时m3u8文件中会包含一个#EXT-X-KEY标签指明了密钥KEY的获取方式通常也是一个URL。#EXT-X-KEY:METHODAES-128,URIhttps://example.com/key.key,IV0x...FFmpeg如果密钥URI是公开可访问的FFmpeg通常能自动处理这种标准的AES-128加密无需额外参数。N_m3u8DL-RE它同样能自动处理。如果遇到问题可以尝试手动指定密钥--key参数。手动处理在最复杂的情况下你可能需要手动下载key.key文件。用工具如openssl或编写脚本用这个密钥去解密每一个下载下来的.ts文件。将解密后的TS文件合并。 这个过程非常繁琐幸运的是上述工具在大多数情况下都能自动搞定。5.2 处理请求头校验与反爬机制有些服务器会检查HTTP请求头比如Referer来源页和User-Agent浏览器标识。如果直接用简单的下载命令可能会返回403禁止访问。在FFmpeg中添加请求头ffmpeg -headers Referer: https://www.bilibili.com/\r\nUser-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\r\n -i m3u8_url -c copy output.mp4使用-headers参数注意头部字段的格式每个头部行以\r\n结束。在N_m3u8DL-RE中添加请求头N_m3u8DL-RE.exe m3u8_url --header Referer: https://www.bilibili.com/ --header User-Agent: ... ...使用--header参数可以多次使用来添加多个头部。5.3 合并TS文件时遇到的各种问题有时工具自动合并会失败或者你想手动处理下载好的TS文件。简单合并TS文件列表顺序正确# 在Linux/macOS下 cat *.ts combined.ts # 或者使用FFmpeg更稳妥 ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4其中filelist.txt的内容格式为file segment1.ts file segment2.ts file segment3.ts合并后音频视频不同步这通常是因为某些TS切片的时长信息不准确。可以尝试让FFmpeg重新编码音频或视频流来修正但这会损失一些速度和质量。ffmpeg -i input.ts -c:v libx264 -c:a aac -strict experimental output.mp45.4 常见错误与解决方案速查表问题现象可能原因排查步骤与解决方案HTTP error 403 Forbidden服务器校验请求头或IP1. 检查并添加正确的Referer和User-Agent。2. 检查m3u8和TS地址是否带有时效性Token如?tokenxxx过期需要重新获取。Unable to open key file或解密失败AES密钥获取失败或密钥不正确1. 检查m3u8中的#EXT-X-KEYURI是否能直接访问。2. 尝试用浏览器访问密钥URI看是否被拒绝。3. 某些平台密钥是动态生成的需要研究其获取逻辑复杂度高。下载速度极慢单线程下载或网络限制1. 换用支持多线程的N_m3u8DL-RE。2. 检查是否被服务器限速可能性较小。合并后的视频只有声音没有画面或无法播放封装格式或编码问题1. 尝试用-bsf:a aac_adtstoasc参数FFmpeg。2. 尝试用其他播放器如VLC播放VLC兼容性极强。3. 使用ffprobe分析一下下载的TS文件看编码格式是否正确。FFmpeg报错Protocol not found输入的URL格式不对或FFmpeg编译时未包含协议1. 确认URL用引号括起来特别是含有符号时。2. 确保是完整的http/https链接。3. 重新安装完整版的FFmpeg。录制直播时中途停止后文件损坏录制被强制终止文件未正确关闭1. 尽量使用CtrlC正常终止FFmpeg进程。2. 可以尝试用ffmpeg -i broken_file.mp4 -c copy fixed_file.mp4进行修复有时有效。6. 自动化与高阶应用思路对于需要定期录制或监控多个直播源的需求手动操作显然不现实。这里分享一些自动化思路。6.1 编写Shell/Python监控脚本核心思路是周期性地检查目标直播是否开始例如通过访问一个固定的页面状态接口如果开始则自动启动下载命令。一个简单的Shell脚本示例#!/bin/bash # 这是一个简化的示例实际应用需要更严谨的判断逻辑 M3U8_URL你的直播流地址 OUTPUT_FILElive_$(date %Y%m%d_%H%M%S).mp4 LOG_FILEdownload.log echo $(date): 开始监控直播流... $LOG_FILE # 使用FFmpeg录制这里设定最多录制2小时 timeout 7200 ffmpeg -i $M3U8_URL -c copy -bsf:a aac_adtstoasc $OUTPUT_FILE $LOG_FILE 21 if [ $? -eq 0 ]; then echo $(date): 录制完成文件保存为: $OUTPUT_FILE $LOG_FILE else echo $(date): 录制过程可能被中断或出错。 $LOG_FILE fi你可以使用cronLinux/macOS或任务计划程序Windows来定时执行这个脚本。6.2 与媒体服务器结合如果你下载的直播流需要对外提供回看服务可以将下载流程与媒体服务器如Nginx with RTMP/HLS module,SRS,Jellyfin等结合。方案一录制后入库。脚本将直播录制下来后自动将视频文件移动到媒体服务器的资料库目录媒体服务器会自动扫描并纳入媒体库。方案二边录边播。使用FFmpeg不仅录制到文件同时推流到媒体服务器的一个直播频道。这样在录制的同时就能通过HLS或FLV协议实时观看这个“直播”录制结束后的文件也自然保存在服务器上。这需要媒体服务器支持RTMP/HTTP-FLV ingest。6.3 关于DRM加密视频的录屏搜索热词中有“drm加密视频可以录屏么”。这是一个法律和技术上的灰色地带。技术层面 Widevine、PlayReady、FairPlay等商业DRM数字版权管理的目的是防止内容被非法复制。它们通常将解密密钥存储在硬件或系统的安全区域播放过程也在受保护的内存中进行。传统的录屏软件包括本文所述的HLS流抓取几乎无法破解这种级别的加密录下来的要么是黑屏要么是花屏。法律与道德层面 绕过DRM技术措施进行复制在大多数国家和地区都违反著作权法及相关技术保护法规。作为技术研究者我们理解其原理但强烈不建议也不提供任何用于破解DRM以复制受版权保护内容的方法。本文讨论的技术仅适用于公开的、未使用强DRM保护的流媒体资源。最后技术是把双刃剑。HLS流下载技术能帮助我们合法地保存有价值的公开信息、进行技术学习与研究。但在使用中务必尊重内容创作者的劳动成果遵守相关网站的用户协议和版权声明将技术用于正当的用途。 HLS直播流下载实战：从m3u8解析到TS切片合并完整指南
1. 项目缘起为什么我们需要自己动手处理HLS直播流最近在折腾一个项目需要把一些线上直播的内容留存下来做后续分析。这些直播源大多是HLS协议也就是大家常说的m3u8流。一开始我也图省事想着找个现成的录屏软件对着浏览器窗口一录不就完了但实际操作下来发现一堆问题网络稍有波动录出来的视频就卡顿丢帧直播时间一长录出来的文件巨大无比后期处理麻烦更别提有些页面还有防录屏机制直接黑屏或者弹出警告。折腾了几轮之后我算是明白了对于需要高质量、自动化留存HLS直播内容的需求靠传统录屏软件属于“治标不治本”。最根本的解决思路应该是直接抓取传输过程中的流媒体数据并重组这才是“釜底抽薪”的办法。这也就是我动手研究“m3u8直播流实时下载”的初衷——不依赖任何客户端录屏直接从网络层拦截和保存HLS流实现稳定、高效、自动化的直播内容获取。这个方法的核心价值在于“源头抓取”。它跳过了播放器渲染和屏幕采集这两个容易出问题的环节直接处理传输数据因此理论上只要你能正常观看直播就能把它完整地保存下来不受画面复杂度、系统负载甚至一些基础防录屏措施的影响。对于做内容归档、舆情分析、教学复盘或者单纯想收藏直播的朋友来说掌握这套方法能解决很多实际问题。2. HLS技术原理快速解读m3u8与TS切片在动手之前我们有必要快速理解一下HLS到底是怎么工作的。这能帮我们在后续抓包和处理时清楚地知道每一步在做什么遇到问题也知道该往哪个方向排查。HLS全称是HTTP Live Streaming是苹果公司提出的一套基于HTTP的流媒体传输协议。它的设计思想非常巧妙把一整个大的视频文件切割成无数个小的、易于通过网络传输的文件片段通常是.ts格式的视频切片然后用一个名为m3u8的索引文件播放列表来告诉播放器这些片段的顺序和地址。播放器就像听指挥一样按顺序去下载并播放这些.ts片段从而实现流式播放。2.1 m3u8索引文件直播流的“节目单”m3u8文件本质上是一个文本文件你可以用任何文本编辑器打开它。它的内容结构决定了直播流的类型和播放逻辑主要分为两类点播VOD列表包含所有TS切片的完整列表以及每个切片的时长。这种列表是固定的用于回放已结束的视频。直播列表这是一个动态更新的列表。它通常只包含最近一段时间内生成的TS切片。在文件里你会看到一个#EXT-X-PLAYLIST-TYPE:EVENT或#EXT-X-ENDLIST标签后者表示直播已结束。对于正在进行的直播列表会不断滚动更新新的切片URL被加入顶部或底部老的切片URL可能会被移除。一个典型的直播m3u8文件内容看起来是这样的#EXTM3U #EXT-X-VERSION:3 #EXT-X-TARGETDURATION:10 #EXT-X-MEDIA-SEQUENCE:163 #EXTINF:10.000, https://example.com/live/stream-163.ts #EXTINF:10.000, https://example.com/live/stream-164.ts #EXTINF:10.000, https://example.com/live/stream-165.ts#EXT-X-TARGETDURATION:10表示每个TS切片的最大时长大约是10秒。#EXT-X-MEDIA-SEQUENCE:163表示当前列表中第一个TS切片的序列号是163。这个序列号会随着直播推进而递增。#EXTINF行指明了下一个TS切片的持续时间紧接着的一行就是该切片的具体网络地址。2.2 TS切片视频内容的“数据块”.ts文件是实际的视频数据容器里面封装了遵循MPEG-2 TS流格式的音视频数据。每个.ts文件通常只有几秒到十几秒的长度这种设计带来了几个好处适应网络波动即使某个切片下载失败或缓慢也只会影响很小一段内容的播放播放器可以快速切换到下一个切片或者尝试重新下载从而保证播放的流畅性。便于CDN缓存和分发小文件更容易被CDN边缘节点缓存加速不同地区用户的访问速度。支持自适应码率HLS可以同时提供多种不同分辨率、码率的m3u8索引文件主列表播放器可以根据当前网速自动选择最合适的流进行播放这就是我们看到的“清晰度切换”。注意有些复杂的HLS流会采用“多级m3u8”结构。即第一个m3u8文件主列表里不直接包含.ts地址而是包含了几个子m3u8文件的地址这些子m3u8文件才分别对应不同码率的TS切片列表。我们在处理时需要递归地解析找到最终的.ts链接。理解了这些我们的任务就清晰了首先找到直播流的m3u8索引文件地址然后持续监控并下载这个m3u8文件解析出其中列出的所有.ts切片地址最后按顺序将这些.ts切片下载下来合并成一个完整的视频文件。3. 核心工具链选型与实战环境准备工欲善其事必先利其器。实现HLS流下载我们可以选择从零开始写脚本也可以利用一些成熟的开源工具。这里我推荐一种“组合拳”策略用专业工具抓取和解析流地址用灵活脚本控制下载和合并流程。这样既保证了可靠性又保留了自定义空间。3.1 流地址探测与抓包工具在下载之前我们得先拿到m3u8文件的真实URL。这是最关键的一步有几种常见方法浏览器开发者工具最简单直接这是我最推荐新手使用的方法。以Chrome浏览器为例打开直播页面并开始播放。按下F12打开开发者工具切换到Network网络面板。在筛选器Filter中输入m3u8。通常你就能立刻看到浏览器请求的m3u8文件。点击这个m3u8请求在Headers标签页中找到Request URL这个就是m3u8文件的地址。复制它。实操心得有时候直播流使用了HTTPS或者带有查询参数务必完整复制整个URL。另外注意观察请求的Referer和User-Agent有些服务器会校验这些信息我们在后续用下载工具时可能需要模拟这些请求头。专业抓包软件如果浏览器工具里找不到比如一些客户端应用或特殊协议可以使用像Wireshark或Fiddler这样的抓包工具。它们能捕获系统所有网络流量过滤出HTTP/HTTPS请求找到其中的m3u8链接。使用这类工具需要一点网络知识但功能更强大。浏览器插件有一些专门用于嗅探视频流的浏览器插件例如“Stream Video Downloader”等。它们可以自动检测页面中的视频流并显示地址对于简单场景很方便。3.2 HLS下载专用工具拿到m3u8地址后我们需要一个能理解HLS协议的工具来帮我们完成持续的下载和合并。这里有几个经典选择FFmpeg万能媒体工具这绝对是处理多媒体任务的瑞士军刀。它原生支持HLS协议可以直接将m3u8 URL作为输入输出为一个完整的视频文件。命令简单粗暴ffmpeg -i https://example.com/live/stream.m3u8 -c copy output.mp4-i后面跟着你的m3u8地址。-c copy表示直接复制流而不进行重新编码速度极快画质无损。output.mp4是输出的文件名。 FFmpeg会自动处理TS切片的下载、按序拼接和封装。对于大多数不加密的直播流这一条命令就足够了。N_m3u8DL-CLI又名N_m3u8DL-RE这是一个用Go语言编写的高性能HLS下载器在爱好者社区非常流行。它的优势在于速度快支持多线程并发下载TS切片极大提升下载效率。功能强自动处理密钥解密针对一些加密的HLS流、自动合并、生成元数据文件等。易用性提供命令行和图形界面两种版本。 基本使用命令N_m3u8DL-RE https://example.com/live/stream.m3u8 --workDir ./downloads --saveName my_videoyoutube-dl / yt-dlp这两个是知名的视频网站下载工具它们也支持HLS流。yt-dlp是youtube-dl的一个更活跃的分支功能更新更快。它们的好处是能模拟浏览器行为绕过一些简单的反爬机制。yt-dlp -o output.mp4 https://example.com/live/stream.m3u83.3 环境准备与工具安装为了完成整个流程你需要准备一个可以运行命令行工具的环境。Windows、macOS、Linux均可。安装FFmpegmacOS使用Homebrew最简单brew install ffmpegUbuntu/Debiansudo apt update sudo apt install ffmpegWindows到FFmpeg官网下载编译好的可执行文件解压后将bin目录添加到系统的环境变量PATH中。 安装后在终端输入ffmpeg -version验证是否成功。安装N_m3u8DL-RE访问其GitHub发布页面下载对应你操作系统的最新版本。解压后即可得到可执行文件。在终端中进入该文件所在目录即可运行。可选安装yt-dlp使用pippip install yt-dlp或直接下载其独立的可执行文件。工具选型建议对于绝大多数公开、未加密的HLS直播流FFmpeg是最简单、最通用的选择一行命令解决问题。如果你的网络环境好想下载得更快或者遇到需要解密AES-128加密的流N_m3u8DL-RE是更专业的工具。而yt-dlp则在下载各大视频网站公开内容时这些网站也多用HLS有奇效因为它内置了很多网站的特殊解析逻辑。4. 分步实战从抓取地址到完整视频生成现在我们结合一个模拟的实战场景把整个流程走一遍。假设我们要下载一个B站某个直播的回放注此例仅用于技术演示请务必遵守相关平台用户协议和版权规定。4.1 第一步定位并获取m3u8地址打开目标直播回放页面让视频开始播放。打开浏览器开发者工具F12进入Network面板筛选m3u8。刷新页面观察网络请求。你可能会看到多个m3u8请求它们通常对应不同的清晰度如720p.m3u8,1080p.m3u8。选择一个你想要的清晰度对应的m3u8请求右键点击它选择“Copy” - “Copy link address”。这样就得到了最关键的索引文件地址。示例地址可能类似于https://xxx.bilibili.com/xxx/playlist.m3u8?xxxxxx4.2 第二步使用FFmpeg进行基础下载与合并这是最快捷的方法。打开你的终端命令行窗口输入以下命令ffmpeg -i 你复制的m3u8地址 -c copy -bsf:a aac_adtstoasc bilibili_live_output.mp4-i指定输入URL。-c copy音视频流都直接复制不重新编码。-bsf:a aac_adtstoasc这是一个比特流过滤器用于处理某些TS流中的AAC音频头使其能正确封装进MP4。这是一个非常实用的参数能解决部分TS流合并后音频无法播放的问题。bilibili_live_output.mp4你希望输出的文件名。按下回车FFmpeg就会开始工作。你会看到它不断输出日志显示正在下载和拼接TS片段。直播回放是固定长度的所以下载完成后它会自动退出并生成最终的mp4文件。4.3 第三步使用N_m3u8DL-RE进行高效下载如果你追求更快的下载速度或者FFmpeg遇到问题可以换用N_m3u8DL-RE。将下载好的N_m3u8DL-RE可执行文件放在一个方便的目录比如D:\hls_downloader。在此目录打开命令行Windows下可在文件资源管理器地址栏输入cmd回车。运行命令N_m3u8DL-RE.exe 你复制的m3u8地址 --workDir ./downloaded_videos --saveName 我的直播录像 --enableDelAfterDone--workDir指定下载文件保存的目录。--saveName指定输出文件的主文件名不含扩展名。--enableDelAfterDone下载合并完成后自动删除零散的.ts切片文件只保留最终合并好的文件。工具会开始运行它默认会使用多线程下载你可以看到实时的下载速度和进度。完成后在./downloaded_videos目录下就能找到合并好的视频文件通常是.mp4或.mkv。4.4 第四步处理实时直播流下载实时直播流与下载回放的区别在于直播是持续不断的m3u8文件内容在动态更新。使用FFmpeg命令完全一样。FFmpeg会持续监控m3u8文件的变化只要有新的TS切片出现就会自动下载并追加到输出文件中。你需要手动决定何时停止。在终端中按下CtrlC即可终止FFmpeg进程此时它会完成最后一个切片的写入并关闭文件你得到的就是从开始到结束录制时间点的完整视频。关键技巧你可以使用FFmpeg的-t参数来限制录制时长。例如-t 01:00:00表示录制1小时。使用N_m3u8DL-RE它同样支持直播流。对于直播它会持续运行直到你手动中断CtrlC。中断后它也会自动将已下载的切片合并成最终文件。重要注意事项录制实时直播时请确保网络稳定。如果中途网络中断FFmpeg或下载工具可能会报错退出。对于重要的直播可以考虑在更稳定的服务器环境下运行此任务。5. 进阶技巧与常见问题深度排查掌握了基本操作后我们来看看那些“坑”和提升效率的技巧。5.1 处理加密的HLS流AES-128加密许多商业直播平台会使用AES-128加密来保护TS切片。此时m3u8文件中会包含一个#EXT-X-KEY标签指明了密钥KEY的获取方式通常也是一个URL。#EXT-X-KEY:METHODAES-128,URIhttps://example.com/key.key,IV0x...FFmpeg如果密钥URI是公开可访问的FFmpeg通常能自动处理这种标准的AES-128加密无需额外参数。N_m3u8DL-RE它同样能自动处理。如果遇到问题可以尝试手动指定密钥--key参数。手动处理在最复杂的情况下你可能需要手动下载key.key文件。用工具如openssl或编写脚本用这个密钥去解密每一个下载下来的.ts文件。将解密后的TS文件合并。 这个过程非常繁琐幸运的是上述工具在大多数情况下都能自动搞定。5.2 处理请求头校验与反爬机制有些服务器会检查HTTP请求头比如Referer来源页和User-Agent浏览器标识。如果直接用简单的下载命令可能会返回403禁止访问。在FFmpeg中添加请求头ffmpeg -headers Referer: https://www.bilibili.com/\r\nUser-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\r\n -i m3u8_url -c copy output.mp4使用-headers参数注意头部字段的格式每个头部行以\r\n结束。在N_m3u8DL-RE中添加请求头N_m3u8DL-RE.exe m3u8_url --header Referer: https://www.bilibili.com/ --header User-Agent: ... ...使用--header参数可以多次使用来添加多个头部。5.3 合并TS文件时遇到的各种问题有时工具自动合并会失败或者你想手动处理下载好的TS文件。简单合并TS文件列表顺序正确# 在Linux/macOS下 cat *.ts combined.ts # 或者使用FFmpeg更稳妥 ffmpeg -f concat -safe 0 -i filelist.txt -c copy output.mp4其中filelist.txt的内容格式为file segment1.ts file segment2.ts file segment3.ts合并后音频视频不同步这通常是因为某些TS切片的时长信息不准确。可以尝试让FFmpeg重新编码音频或视频流来修正但这会损失一些速度和质量。ffmpeg -i input.ts -c:v libx264 -c:a aac -strict experimental output.mp45.4 常见错误与解决方案速查表问题现象可能原因排查步骤与解决方案HTTP error 403 Forbidden服务器校验请求头或IP1. 检查并添加正确的Referer和User-Agent。2. 检查m3u8和TS地址是否带有时效性Token如?tokenxxx过期需要重新获取。Unable to open key file或解密失败AES密钥获取失败或密钥不正确1. 检查m3u8中的#EXT-X-KEYURI是否能直接访问。2. 尝试用浏览器访问密钥URI看是否被拒绝。3. 某些平台密钥是动态生成的需要研究其获取逻辑复杂度高。下载速度极慢单线程下载或网络限制1. 换用支持多线程的N_m3u8DL-RE。2. 检查是否被服务器限速可能性较小。合并后的视频只有声音没有画面或无法播放封装格式或编码问题1. 尝试用-bsf:a aac_adtstoasc参数FFmpeg。2. 尝试用其他播放器如VLC播放VLC兼容性极强。3. 使用ffprobe分析一下下载的TS文件看编码格式是否正确。FFmpeg报错Protocol not found输入的URL格式不对或FFmpeg编译时未包含协议1. 确认URL用引号括起来特别是含有符号时。2. 确保是完整的http/https链接。3. 重新安装完整版的FFmpeg。录制直播时中途停止后文件损坏录制被强制终止文件未正确关闭1. 尽量使用CtrlC正常终止FFmpeg进程。2. 可以尝试用ffmpeg -i broken_file.mp4 -c copy fixed_file.mp4进行修复有时有效。6. 自动化与高阶应用思路对于需要定期录制或监控多个直播源的需求手动操作显然不现实。这里分享一些自动化思路。6.1 编写Shell/Python监控脚本核心思路是周期性地检查目标直播是否开始例如通过访问一个固定的页面状态接口如果开始则自动启动下载命令。一个简单的Shell脚本示例#!/bin/bash # 这是一个简化的示例实际应用需要更严谨的判断逻辑 M3U8_URL你的直播流地址 OUTPUT_FILElive_$(date %Y%m%d_%H%M%S).mp4 LOG_FILEdownload.log echo $(date): 开始监控直播流... $LOG_FILE # 使用FFmpeg录制这里设定最多录制2小时 timeout 7200 ffmpeg -i $M3U8_URL -c copy -bsf:a aac_adtstoasc $OUTPUT_FILE $LOG_FILE 21 if [ $? -eq 0 ]; then echo $(date): 录制完成文件保存为: $OUTPUT_FILE $LOG_FILE else echo $(date): 录制过程可能被中断或出错。 $LOG_FILE fi你可以使用cronLinux/macOS或任务计划程序Windows来定时执行这个脚本。6.2 与媒体服务器结合如果你下载的直播流需要对外提供回看服务可以将下载流程与媒体服务器如Nginx with RTMP/HLS module,SRS,Jellyfin等结合。方案一录制后入库。脚本将直播录制下来后自动将视频文件移动到媒体服务器的资料库目录媒体服务器会自动扫描并纳入媒体库。方案二边录边播。使用FFmpeg不仅录制到文件同时推流到媒体服务器的一个直播频道。这样在录制的同时就能通过HLS或FLV协议实时观看这个“直播”录制结束后的文件也自然保存在服务器上。这需要媒体服务器支持RTMP/HTTP-FLV ingest。6.3 关于DRM加密视频的录屏搜索热词中有“drm加密视频可以录屏么”。这是一个法律和技术上的灰色地带。技术层面 Widevine、PlayReady、FairPlay等商业DRM数字版权管理的目的是防止内容被非法复制。它们通常将解密密钥存储在硬件或系统的安全区域播放过程也在受保护的内存中进行。传统的录屏软件包括本文所述的HLS流抓取几乎无法破解这种级别的加密录下来的要么是黑屏要么是花屏。法律与道德层面 绕过DRM技术措施进行复制在大多数国家和地区都违反著作权法及相关技术保护法规。作为技术研究者我们理解其原理但强烈不建议也不提供任何用于破解DRM以复制受版权保护内容的方法。本文讨论的技术仅适用于公开的、未使用强DRM保护的流媒体资源。最后技术是把双刃剑。HLS流下载技术能帮助我们合法地保存有价值的公开信息、进行技术学习与研究。但在使用中务必尊重内容创作者的劳动成果遵守相关网站的用户协议和版权声明将技术用于正当的用途。