企业官网建设流程全解析

cat-catch m3u8解析下载三步上手指南：从资源发现到完整视频文件

【免费下载链接】cat-catch猫抓 浏览器资源嗅探扩展 / cat-catch Browser Resource Sniffing Extension项目地址: https://gitcode.com/GitHub_Trending/ca/cat-catch

很多视频网站不提供直链，视频被拆成几十段ts切片，还常带加密。猫抓cat-catch的m3u8解析下载功能把发现、解密、合并成完整文件一气呵成完成。本文以一个真实下载为例，讲清它怎么用、为什么靠谱。

完整操作走查：三步下载一个m3u8视频

第1步：发现资源。打开视频页面，等视频开始播放后，点击工具栏的猫抓图标。弹窗会列出当前页面捕获到的媒体资源，找到标注为m3u8的条目（HLS流地址），点击其旁的解析下载按钮。js/popup.js 中的openParser会带着该地址、来源页标题和Referer信息，在相邻位置新开一个解析页。

第2步：确认解析结果。解析页自动请求并解析m3u8清单。页面顶部会给出总时长、切片数、分辨率、码率和估算文件大小；如果清单里含多个清晰度，会先列出各级别的分辨率与码率，勾选目标级别再进入下一级解析。

第3步：合并下载。勾选“转mp4格式”（推荐，直接得到可播放的mp4），点击“合并下载”。进度按“成功数/总数”滚动，失败切片单独标红可重试，完成后文件存入浏览器下载目录，可选自动关闭页面。

幕后机制：m3u8切片如何变成完整文件

用户点下的只是一个地址，内部数据流分四步走：

1. 输入：m3u8地址加请求头。处理：解析页用 hls.js 拉取清单，监听MANIFEST_PARSED与LEVEL_LOADED事件。输出：完整的切片列表，每项含url、时长、加密信息，存于 _fragments。
2. 输入：标记为加密的切片。处理：parseTs顺带fetch密钥地址，校验返回内容是否恰为16字节。输出：密钥缓存，并在界面上展示算法、Hex与Base64，供核对或手填。
3. 输入：勾选的切片列表。处理：Downloader 按线程数（默认6）并发fetch，每个结果按序进入处理管线。输出：按index归位的buffer，乱序下载也不影响最终顺序。

down.use(preprocess, "preprocess"); // 预处理：剔除伪装图片头 down.use(decrypt, "decrypt"); // AES解密 down.use(transcode, "transcode"); // mux.js转mp4

4. 输入：全部buffer。处理：按索引顺序拼接，勾选mp4时用 mux.js 转封装；直播流则按切片序号续记、边下边存。输出：单个可播放的完整文件。

为什么这样设计：源码里的三个取舍

并发下载换内存。默认6线程并行，速度可观，代价是所有buffer先驻留内存，大文件内存占用高。为此留了“边下边存”选项：牺牲一步到位的即时性，换成流式写盘的低占用。

管线化换固定流程。下载器不写死“下载后解密”，而是暴露use(fn, name)注册处理步骤。预处理（剥掉个别站点给ts套的PNG/JPG假头）、解密、转码都可按需装卸，代价是调用方要自己编排步骤顺序。

失败重试换请求次数。清单请求403时，js/m3u8.js 的ERROR处理会先去掉Referer重试，失败再补上来源页的Referer与Origin重试一轮；单切片失败则延迟递增自动重试：

fragment.retryCount = (fragment.retryCount || 0) + 1; setTimeout(() => this.downloader(fragment), 500 * fragment.retryCount);

用两次多余加载，换对防盗链站点的兼容。

避坑手册：m3u8解析下载报错的常见原因与解决

• 清单加载失败（403/manifestLoadError）→ 原因：该URL只在来源页上下文有效，缺Referer或带了错误的Referer → 解法：在解析页填对Referer；猫抓也会自动增减请求头重试一轮，仍失败则手动补全。
• 文件无法播放或开头花屏→ 原因：切片加密但密钥获取失败，或缺少EXT-X-MAP初始化段 → 解法：核对提示区显示的密钥地址与16字节长度，必要时在“密钥”框手填。
• 个别切片下载失败→ 原因：网络抖动 → 解法：自动重试3次后仍失败的，用“全部重新下载”按钮只重下失败项。
• 内存占用高→ 原因：多线程下载需缓存全部buffer → 解法：调低线程数，或启用“边下边存”流式写出。
• ts单独请求403→ 原因：站点要求切片带查询参数 → 解法：在“更多功能”里启用“获取参数”，把m3u8地址的参数追加到每个ts上。

m3u8解析下载是cat-catch里把“发现—解析—解密—合并”串成一条线的核心能力，理解了上面的数据流，mpd.js 的DASH转m3u8和直播录制也顺理成章。更多参数说明见 m3u8.html 界面与 README.md。

【免费下载链接】cat-catch猫抓 浏览器资源嗅探扩展 / cat-catch Browser Resource Sniffing Extension项目地址: https://gitcode.com/GitHub_Trending/ca/cat-catch