N_m3u8DL-CLI Win11下载
它是什么N_m3u8DL-CLI 是基于 .NET Framework 的开源 m3u8 命令行下载工具,支持多线程下载、AES-128-CBC 自动解密、自定义请求头与断点续传
N_m3u8DL-CLI 是基于 .NET Framework 的开源 m3u8 命令行下载工具,支持多线程下载、AES-128-CBC 自动解密、自定义请求头与断点续传,自带 Simple GUI 图形界面,适合 Windows 下处理 IDM 无法下载的流媒体地址。
详细介绍
简介
N_m3u8DL-CLI 是一个基于 .NET Framework 的开源命令行工具,专门用来下载 m3u8 格式的流媒体视频。它解决的是普通下载器面对播放列表无从下手的问题:程序按列表逐段抓取 TS 分片,自动完成 AES-128-CBC 解密并合并为完整视频。工具自带名为 Simple GUI 的图形界面,同时保留细粒度的命令行选项,适合在 Windows 上需要多线程、断点续传或自定义请求头的下载任务。
核心功能
- 基于 .NET Framework 4.6 开发,调用系统类库完成 HTTP 下载,覆盖常见的 m3u8 格式。
- 多线程下载:分片并行抓取,长列表视频不必一节一节串行等待。
- AES-128-CBC 加密自动解密,下载结束后自动合并分片,不必再换别的工具二次处理。
- 支持自定义请求头,可按站点校验规则补充 Referer、User-Agent 等字段。
- 支持从视频中选择一部分下载,指定范围即可,不必拉取整个播放列表。
- 提供丰富的命令行选项,可组合成批量任务或写进脚本循环执行。
- 自带 Simple GUI 简单图形界面,不想敲命令时直接在窗口里粘贴链接回车。
- 下载支持断点续传,网络波动导致中断后可继续未完成的任务。
使用场景
- IDM 嗅探出真实地址却提示不支持 playlist 类型视频下载时,把该 m3u8 链接交给本工具处理。
- 面对数百个 AES-128 加密 TS 分片的复杂流,一次跑完下载、解密与合并三步。
- 站点必须带 Referer 或 User-Agent 才能取到分片时,用自定义请求头补齐校验字段。
- 只需要长视频中的某一段,指定起止范围只下载所需部分,节省等待时间。
- 网络不稳、任务中途断开时,依靠断点续传接着下完剩余分片。
- 需要批量处理多个链接时,把命令写进脚本,按统一参数循环执行。
安装与获取步骤
- 打开项目仓库 https://github.com/nilaoda/N_m3u8DL-CLI,在 Releases 或仓库文件中获取程序;具体版本号与文件信息以官方页面为准。
- 确认当前 Windows 系统已具备 .NET Framework 4.6 运行环境,缺失时先补齐再启动 EXE。
- 双击 EXE 启动程序;需要图形界面时使用自带的 Simple GUI,把 m3u8 文件或链接粘贴进去按下回车。
- 需要更多控制时在命令行中带上选项执行,参数写法参考官方 Wiki:https://github.com/nilaoda/N_m3u8DL-CLI/wiki
- 完成后在 EXE 同级的 Downloads 文件夹查看视频,在 Logs 文件夹的 *.log 中查看本次运行日志。
与同类方案的区别
IDM 这类通用下载器能嗅探出 m3u8 地址,但其官网明确说明不支持通过 playlist 指向视频类别的下载,点击开始会直接报错;N_m3u8DL-CLI 正是为这类地址设计的,按分片逐段抓取再合并。与同作者的 N_m3u8DL-RE 相比,本项目基于 .NET Framework、不具备跨平台能力,目前已进入维护阶段;RE 版本抛弃历史包袱从零做起,支持 Win/Linux/Mac,更多新功能会先出现在那一支。
参数与目录速查
- 运行方式:双击 EXE,粘贴 m3u8 文件或 m3u8 链接后回车。
- 输出目录:EXE 同级的 Downloads 文件夹存放下载完成的视频。
- 日志目录:EXE 同级的 Logs 文件夹,日志文件名为 *.log。
- 运行环境:.NET Framework 4.6,Windows 下运行,不具备跨平台能力。
- 入门文档:https://nilaoda.github.io/N_m3u8DL-CLI/Introductory.html
- 反馈渠道:Issues 见 https://github.com/nilaoda/N_m3u8DL-CLI/issues,另有 Discussions 可讨论。
注意事项
- 本项目已进入维护阶段,跨平台能力与新功能集中在 N_m3u8DL-RE,选型前先确认自己要长期用哪一支。
- 基于 .NET Framework,不具备跨平台能力,Linux 或 Mac 环境无法直接运行本项目。
- 命令行报错时逐步减少参数,确保每个参数的正确性,再逐项加回以定位问题。
- 下载中断多为网络原因,先检查网络连接是否稳定,再用断点续传继续任务。
- 版本号、文件与选项写法一律以官方页面为准,第三方转载的数值不一定与仓库一致。
- 仅下载你有权保存的内容,流媒体资源的使用需遵守来源站点条款与当地法规。
更新记录
最近更新:2026-10-18
软件参数速览
常见问题
IDM 提示「不支持通过 playlist 指向视频类别的下载」时怎么办?
IDM 官方明确不支持 M3U8 播放列表形式的视频下载,遇到该报错就把嗅探到的 m3u8 地址复制出来,改用 N_m3u8DL-CLI 粘贴后回车,由它按分片逐段抓取并合并成完整视频。
双击 EXE 之后应该输入什么?
把 m3u8 文件或 m3u8 链接粘贴进窗口后按下回车即可开始下载。默认视频输出到 EXE 同目录的 Downloads 文件夹,运行日志写入同目录 Logs 文件夹下的 *.log 文件。
下载中途断了,怎么接着下?
先确认网络连接稳定,排除网络波动导致的中断,再使用断点续传功能继续未完成的任务;如果反复中断,可逐步减少参数,确认是哪一项设置引起的。
命令行报错,参数太多怎么定位?
逐步减少参数,确保每个参数的正确性:先用最基础的「EXE + m3u8 链接」跑通,再逐个加回选项,哪一步开始报错就检查哪一项设置。
AES-128 加密的分片需要另外解密吗?
不需要。工具支持 AES-128-CBC 加密自动解密,下载完成后会把分片合并成完整视频;面对数百个加密 TS 分片的流,也能一次跑完下载、解密与合并。
能在 Linux 或 Mac 上运行吗?
本项目基于 .NET Framework,不具备跨平台能力,只能在 Windows 环境使用。需要跨平台时看同作者的 N_m3u8DL-RE,它支持 Win/Linux/Mac。
只想下载视频中的一段,怎么指定?
工具支持从视频中选择一部分下载,通过相应命令行选项指定起止范围即可,不必拉取整个播放列表;具体选项名称与写法以官方 Wiki 和文档页面为准。
项目还在更新吗,遇到问题去哪里反馈?
本项目已进入维护阶段,更多新功能会出现在 N_m3u8DL-RE。使用问题可在 Issues 提交,想法与讨论可发到 Discussions,地址见 https://github.com/nilaoda/N_m3u8DL-CLI/issues