N_m3u8DL-CLI Windows下载

简介

N_m3u8DL-CLI 是基于 .NET Framework 4.6 的开源命令行 m3u8 下载工具，用于抓取 m3u8/HLS/DASH 播放列表中的分片，并合并输出 MP4 或 TS 文件。它解决的是网页流媒体只能在线观看、无法离线保存的问题：把链接粘贴进去即可开始下载，支持 AES-128-CBC 自动解密、多线程下载与自定义请求头。适合需要批量、可控地保存视频内容的用户，自带 Simple GUI 图形界面，界面提供简体中文、繁体中文和英文。

核心功能

• 支持 m3u8、HLS、DASH 播放列表下载，把分片抓取后合并为 MP4 或 TS 两种输出格式。
• 内置 AES-128-CBC 解密，遇到常见加密的播放列表可直接下载，无需再单独处理密钥。
• 多线程下载分片，分片数量多、体积大的资源可以并行抓取，缩短整体等待时间。
• 支持自定义请求头，可按目标站点的访问要求补齐请求信息后再发起下载。
• 支持从视频中选择一部分下载，不必每次都拉取整段内容。
• 提供丰富的命令行参数，输出格式、合并方式、请求头等均可在命令中指定，具体写法以官方文档为准。
• 自带 Simple GUI 图形界面，双击 EXE、粘贴 m3u8 链接、按下回车即可开始。
• 界面与提示支持简体中文、繁体中文和英文三种语言。
• 可调用 ffmpeg 把下载得到的 .ts 分片合并成一个 MP4 文件。
• 支持通过 m3u8dl:// 协议与浏览器扩展联动，点一下链接即可唤起下载。

使用场景

• 视频只能在线播放、页面没有下载入口，需要把 m3u8 链接保存成本地文件。
• 资源由大量 .ts 分片组成，逐个下载再手动合并过于繁琐。
• 播放列表带 AES-128-CBC 加密，直接复制分片地址无法得到可播放内容。
• 只需要长视频中的某一段，希望按范围选择部分下载。
• 需要在命令行里批量处理多个链接，或把下载动作写进自己的脚本。
• 用猫抓等浏览器扩展抓到 m3u8 地址后，希望通过 m3u8dl:// 协议一键交给本工具处理。

安装与获取步骤

1. 打开项目页面 https://github.com/nilaoda/N_m3u8DL-CLI/ ，进入 Release 页面，下载形如 N_m3u8DL-CLI_v版本号_with_ffmpeg_and_SimpleG.zip 的压缩包，具体版本以官方页面为准。
2. 把压缩包解压到自定义目录，确认 ffmpeg 与 Simple GUI 位于同一目录，这样合并 MP4 时程序才能调用到 ffmpeg。
3. 检查系统是否已具备 .NET Framework 4.6 或更高版本，缺失时程序无法正常启动，可到微软官方获取对应运行库。
4. GitHub 访问不畅时，可查看 newbe 整理的国内镜像地址列表 https://www.newbe.pro/Mirrors/Mirrors-N_m3u8DL-CLI ，或从 SourceForge 的镜像文件页获取 N_m3u8DL-CLI-SimpleG.exe。
5. 最简用法：双击 EXE，把 m3u8 文件或 m3u8 链接粘贴进输入框，按下回车，程序开始输出下载日志。
6. 命令行用法：在解压目录打开终端，按官方文档的参数格式调用程序，可指定输出格式、请求头等选项后回车执行。

图形界面与联动方式

• 自带的 Simple GUI 只有基础输入框，没有任务列表；社区有 N_m3u8DL-CLI-SimpleG_List 改版补上了任务列表功能，可以和猫抓配合使用。
• 与猫抓联动的步骤：下载 URLProtocol 与 N_m3u8DL-RE 两个程序并放在一起，打开 URLProtocol 工具，协议名填 m3u8dl，点击选择目标程序按钮选中 N_m3u8DL-RE.exe，再点添加。
• 官方文档站为 https://nilaoda.github.io/N_m3u8DL-CLI/ ，包含简介、使用入门等页面；英文 README 位于 https://github.com/nilaoda/N_m3u8DL-CLI/blob/master/README_ENG.md 。

注意事项

• 仅下载你有权保存的内容；对受版权保护或平台明确禁止下载的资源，请先确认授权范围。
• 运行依赖 .NET Framework 4.6 及以上，环境缺失会导致程序直接报错退出，应先补齐运行库再排查其他问题。
• 输入必须是 m3u8 地址或 m3u8 文件；普通 mp4 链接、网页播放页地址不会被识别为播放列表。
• 合并 MP4 依赖同目录下的 ffmpeg，缺少该组件时只能得到分片或 TS 结果，建议使用带 ffmpeg 的发布包。
• 目标站点校验请求头时，需要用自定义请求头补齐相应字段，否则下载会失败。
• 文中出现的版本号、参数名与下载入口均以官方页面为准，第三方镜像仅作为访问备用渠道。