N_m3u8DL-CLI 离线安装包

简介

N_m3u8DL-CLI 是一款用于下载 m3u8 的命令行工具，基于 .NET Framework 4.6 框架开发，调用系统类库进行 HTTP 下载，支持常见的 m3u8 格式，也能从视频中选择一部分下载，并提供丰富的命令行选项。离线安装包把运行所需文件一并打包，解决的是内网机器、临时受限网络环境下无法在线获取依赖、无法现场部署的问题，适合运维人员、课程视频整理者以及需要批量抓取流媒体的技术用户。它的核心优势在于多线程下载、AES-128-CBC 加密自动解密与自定义请求头，同时自带 Simple GUI 图形界面，并有支持任务列表的改版可与浏览器扩展对接。

核心功能

• 基于 .NET Framework 4.6 框架开发，调用系统类库进行 HTTP 下载，不依赖第三方下载内核。
• 支持常见的 m3u8 格式下载，可将 m3u8 流下载为 MP4 或 TS，输出格式由所选命令行参数决定。
• 支持从视频中选择一部分下载，不必拉取整段内容即可得到需要的片段。
• 支持多线程下载、AES-128-CBC 加密自动解密，并可自定义请求头以通过需要 Referer 或 UA 校验的站点。
• 提供丰富的命令行选项，具体参数含义以官方使用说明书为准：https://nilaoda.github.io/N_m3u8DL-CLI/
• 支持 ChaCha20 解密，并优化了对 #EXT-X-BYTERANGE 标签的处理，减少分片定位出错的情况。
• 自带名为 Simple GUI 的简单图形界面，可直接填入地址执行下载，不必记忆命令行。
• SimpleG 改版在原版基础上增加任务列表功能，GUI 端支持 m3u8dl 协议，可与 Chrome 扩展猫抓对接。

使用场景

• 内网或离线机房部署：现场没有外网时，直接使用离线安装包解压即可运行，不必在线拉取依赖。
• 批量抓取：在猫抓扩展中点击下载，自动打开 GUI 工具并把下载任务添加到任务列表，连续排队执行。
• 加密流处理：遇到 AES-128-CBC 或 ChaCha20 加密的播放列表，由工具自动完成解密后再合并输出。
• 片段截取：只需视频中某一段时，用“从视频中选择一部分下载”的能力只取所需，节省时间与磁盘。
• 需要登录态的站点：通过自定义请求头带上 Referer、Cookie 等信息，绕过仅凭裸链接无法下载的情况。
• 命令行集成：把工具写入脚本或定时任务，批量处理一批 m3u8 地址，输出统一到指定目录。

安装与获取步骤

1. 获取离线安装包文件，核对下载来源是否指向项目页面或其镜像目录，版本与文件信息以官方页面为准。
2. 将压缩包解压到一个固定位置，不要放在会被系统清理的临时目录中，后续协议注册与调用都依赖该路径。
3. 检查系统环境：确认 Windows 已安装 .NET Framework 4.6 或更高版本；未安装时从微软官方网站下载并安装。
4. 开启调用协议（m3u8dl://）并完成参数设置；按猫抓文档的提示，先解压到固定位置再进行注册。
5. 启动 GUI 或命令行，填入 m3u8 地址开始下载；配合猫抓使用时，点击“下载”即可自动打开 GUI 并把任务加入列表。

与同类方案的区别

• 原版自带的 Simple GUI 过于精简，连任务列表都没有；SimpleG 改版补上了任务列表，可排队管理多个下载。
• 浏览器直接保存 m3u8 通常只能拿到分片列表，而本工具能处理多线程、请求头、#EXT-X-BYTERANGE 与加密流。
• 命令行与图形界面两种用法并存：脚本场景用命令行选项，人工操作场景用 GUI，二者调用同一套下载能力。

参数与版本速查

• 运行依赖：.NET Framework 4.6 或更高版本。
• 输出容器：MP4 或 TS。
• 协议：m3u8dl://，用于被猫抓等扩展唤起。
• 镜像目录中可见 3.0.2 版本页面，该版本记录了 ChaCha20 解密与 #EXT-X-BYTERANGE 处理优化，其余版本信息以官方页面为准。

注意事项

• 运行前确认系统已具备 .NET Framework 4.6 或更高版本，缺失时程序无法正常启动。
• 程序目录应保持固定，移动或重命名后已注册的 m3u8dl:// 调用路径会失效，需要重新注册。
• 命令行参数、输出格式与片段截取的具体写法以官方使用说明书为准，不要照搬来源不明的参数表。
• 解密失败时优先检查播放列表中 key 地址是否可达，以及自定义请求头是否与浏览器中一致。
• 下载内容的授权范围与用途需自行判断，仅用于你有权获取的素材。