N_m3u8DL-RE 一条命令下载 DASH/HLS/M3U8 流的完整指南从解析到解密的深度拆解【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-REN_m3u8DL-RE 是一款跨平台的 .NET 命令行流媒体下载工具专门处理 MPDDASH、M3U8HLS和 ISMMSS三类封装格式覆盖点播下载与直播录制两条主线。它不依赖任何图形界面把拿到播放列表 → 挑出想要的音轨 → 并发拉分片 → 解密合并成完整文件整条链路做成了一个可脚本化的工具。为什么 m3u8 链接不能直接下载三个绕不开的问题把一个 m3u8 或 mpd 链接贴进浏览器你得到的通常只是一份文本索引而不是一段视频。原因有三媒体是切碎的。DASH/HLS 把视频切成若干秒一个的分片segment真正的内容散落在成百上千个小文件里索引文件本身几乎不占体积。音视频可能是分离的。一条 DASH 流里1080p 视频、英语音轨、中文音轨、多语种字幕各自是独立轨道播放器在运行时把它们拼装出来下载器必须替播放器做这件事。内容往往带加密。HLS 的 AES-128、ChaCha20DASH 的 CENC 广域加密都意味着裸下分片得到的是无法播放的乱码需要按密钥体系逐片解密。市面上的浏览器插件大多只解决第一个问题而 N_m3u8DL-RE 把三件事都收进了一条命令行里。下面拆开看它是怎么做的。整体架构一条从 URL 到成片的数据流水线源码按职责拆成了四个工程见src/N_m3u8DL-RE.sln主程序N_m3u8DL-RE、通用库N_m3u8DL-RE.Common、解析库N_m3u8DL-RE.Parser、测试N_m3u8DL-RE.Tests。一次下载任务的完整走向如下输入 URL / 本地 .m3u8 / .mpd 文件 │ ▼ StreamExtractor 加载文本 ──► 嗅探类型路由到对应解析器 │ HLS (#EXTM3U) → HLSExtractor │ DASH (MPD) → DASHExtractor2 │ MSS (SmoothStreamingMedia) → MSSExtractor ▼ 生成轨道清单 StreamSpec分辨率/语言/码率/编码 │ ▼ 轨道筛选正则选择 / auto-select / 交互菜单 │ ├── 点播 ──► SimpleDownloadManager多线程拉分片 └── 直播 ──► SimpleLiveRecordManager2轮询刷新播放列表 管道化实时写入 │ ▼ 解密进程内 ChaCha20 / 外部 mp4decrypt / shaka-packager │ ▼ 合并分片二进制直拼 或 ffmpeg concat→ 完整媒体文件值得注意的设计是嗅探而非声明StreamExtractor.cs 拿到源文本后先看是否以#EXTM3U开头、是否含MPD标签、是否含SmoothStreamingMedia标签命中哪条就构造哪个解析器。用户不需要告诉程序这是 DASH本地文件和网络 URL 走同一入口。关键机制拆解轨道选择器把正则表达式当查询语言用面对几十个视频档位、多语种音轨、若干字幕的清单人工肉眼挑选不现实。N_m3u8DL-RE 的做法是把筛选规则设计成字段正则的组合式 DSL领域专用语言核心逻辑在 FilterUtil.cs-sv res3840*:codecshvc1:forbest # 4K HEVC 里挑码率最高的一条 -sa langja|en:forbest2 # 英语或日语音轨里挑最好的两条 -ss name中文:forall # 所有名称含中文的字幕 --custom-range 05:00-20:00 # 只下第 5 到 20 分钟之所以用正则而不是精确值是因为流媒体元数据命名极其不规范——同是1080p可能写成1920x1080、1080p、high。正则一个模式就能兜住多种写法同时forbest/worst/N参数负责在命中集合里再排一次序把选哪条和怎么选出来分成了两个独立步骤。解密链路能用进程内算法就不调外部程序Program.cs 启动时会按声明的--decryption-engine预检 ffmpeg、mp4decrypt、shaka-packager 三个外部工具是否存在缺一个就直接报错退出而不是下载一半才失败——这是典型的快速失败设计。加密方式分两条路径处理。HLS 的 ChaCha20 加密按 1024 字节块加密、nonce 前补 4 字节全零由项目自带的 CSChaCha20 在进程内完成不产生任何子进程速度快且无路径依赖而 CENC 这类需要改写 MP4 容器结构的加解密则交给 mp4decrypt 或 shaka-packager 这类专门工具。另外--mp4-real-time-decryption选项允许分片一边下载一边解密而不是全部下完再统一处理对长时直播录制能明显缩短成片等待时间。直播录制把播放列表当成一条持续生长的队列直播和点播的本质区别在于播放列表是一份会不断刷新的活文档。SimpleLiveRecordManager2.cs 的录制模型可以概括为定时器轮询播放列表间隔可配 --live-wait-time │ ▼ 对比已知分片取增量 ──► 按时间戳命名写入磁盘 │ ├── --live-real-time-merge分片下载完立即合并避免攒一堆碎片 └── --live-pipe-mux分片流经管道直接喂给 ffmpeg 实时混流出一个 .ts 文件不落中间分片它用 .NET 的 BufferBlock一个线程安全的队列结构为每条轨道单独维护待写分片用 ConcurrentDictionary 记录每条流的已录时长 / 最大索引 / 是否出现 ENDLIST直播结束出现 ENDLIST 标记或达到--live-record-limit时长上限后自动收尾。README 特意提醒--live-pipe-mux模式下管道读端由 ffmpeg 接管网络不稳定时可能丢数据所以默认仍保留分片落盘。实战演示场景一点播 HLS/DASH 三连步下载以一条带加密的 HLS 链接为例试解析N_m3u8DL-RE https://example.com/xxx.m3u8 --skip-download。加--skip-download只解析不下载终端会打印全部轨道清单分辨率、码率、语言、编码同时把原始 m3u8 和解析结果meta.json写到临时目录方便核对。指定选择确认轨道后追加-sv best -sa langzh:forbest -ss all指定最优视频、最佳中语音轨和全部字幕。正式下载加上--save-dir D:\downloads --save-name episode01执行。若分片是 CENC 加密且你有密钥补--key KID:KEYHLS 加密密钥也可以单独指定--custom-hls-method AES_128 --custom-hls-key HEX。注意事项临时目录--tmp-dir要有足够空间分片先落盘再合并磁盘满会直接失败默认下载完成后自动删除临时文件--del-after-done默认 True调试时用--skip-merge保留现场需要系统代理时程序默认跟随系统代理直连可加--use-system-proxy false。场景二直播限时录制以 2 小时赛事直播为例把直播 m3u8 地址喂给程序程序检测到直播会自动切换到录制管理器并给出提示加--live-record-limit 02:00:00 --live-real-time-merge录满 2 小时自动停止并实时合并想边录边看进度追加--live-pipe-mux输出单个 TS 文件字幕时间轴偏了可开--live-fix-vtt-by-audio用音频起始时间修正 VTT。注意事项录制期间不要杀进程低延迟 HLS 源分片刷新极快源码里分片命名已改用毫秒级时间戳见SimpleLiveRecordManager2中GetUnixTimestamp的注释修复了同秒分片互相覆盖的问题这类细节正是直播场景下最容易丢内容的地方。工程取舍几个不显眼但关键的决定合并策略分两档。二进制直拼--binary-merge速度快但对加密分片不可用——加密流会被自动检测并强制切换到该模式之外的处理路径Program.cs里对EncryptMethod.UNKNOWN有显式兜底。走 ffmpeg 合并时分片数超过 9 万个会先按 MergeUtil.cs 的PartialCombineMultipleFiles分批预合并规避 concat 协议一次性打开所有文件句柄导致的 too many open files 崩溃。预检一切外部依赖。ffmpeg 找不到在任务开始前就抛异常退出而不是在合并阶段报错错误信息也更明确。元数据全量落盘。--write-meta-json默认开启把解析出的轨道清单和选中清单都写成 JSON 放进临时目录配合--morehelp输出单选项的详细帮助排障时不必靠猜。更新检测做得很轻。Program.cs 里CheckUpdateAsync只是发一个请求读取 302 重定向头拿到最新版本号异步执行、静默失败不打断主流程。旧 Windows 的兼容处理。主程序入口检测到 Windows 6.0Vista/7时自动设置 .NET 全局化不变模式规避老系统缺少 ICU 语言包导致的CultureNotFound崩溃。避坑与常见问题下完的文件打不开多半是没解密。先看meta.json里轨道的加密方式再按上文补--key或--custom-hls-*参数。分片数极大时合并失败确认走了--use-ffmpeg-concat-demuxer或预合并路径并留意系统文件句柄上限Linux 可调ulimit -n。某些网站 403/401分片请求缺少上下文加-H Cookie: ...传请求头若分片 URL 需要继承主地址的查询参数开--append-url-params源码注释点名对 kakao.com 这类站点有效。老版本 Windows 终端乱码或报错换 cmder 等支持现代终端协议的 shell或用--no-ansi-color关 ANSI 颜色。直播录制缺头首次拉取的分片数默认 16--live-take-count想保留更早内容可调大。总结N_m3u8DL-RE 的价值点可以浓缩为四条三合一解析DASH/HLS/MSS 自动嗅探路由本地文件与在线地址同口径处理另有 单元测试 和真实 MPD 样本如 Manifest_MultiPeriod.mpd覆盖多 Period 等复杂场景可编程的轨道选择正则 DSL 覆盖分辨率、编码、语言、声道、时长、带宽等维度适合批量脚本化加密流全链路覆盖进程内 ChaCha20 外部 CENC 解密工具双路径支持实时解密直播/点播双模式轮询式直播录制带实时合并与管道混流点播支持分片范围截取和广告分片过滤--ad-keyword。适合人群有基础命令行能力、需要批量或脚本化下载流媒体的用户以及想研究 DASH/HLS 解析逻辑的开发者——解析器按接口拆分IExtractor.cs结构清晰是很好的阅读入口。获取与安装Arch 系发行版可直接yay -Syu n-m3u8dl-re-bin其他平台克隆源码后编译即可git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE/src dotnet build编译产物运行--help可查看全部参数。项目基于 MIT License 开源作者声明仅用于学习和技术研究使用者需自行确保对目标内容拥有合法获取权限。【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 N_m3u8DL-RE 一条命令下载 DASH/HLS/M3U8 流的完整指南：从解析到解密的深度拆解
N_m3u8DL-RE 一条命令下载 DASH/HLS/M3U8 流的完整指南从解析到解密的深度拆解【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-REN_m3u8DL-RE 是一款跨平台的 .NET 命令行流媒体下载工具专门处理 MPDDASH、M3U8HLS和 ISMMSS三类封装格式覆盖点播下载与直播录制两条主线。它不依赖任何图形界面把拿到播放列表 → 挑出想要的音轨 → 并发拉分片 → 解密合并成完整文件整条链路做成了一个可脚本化的工具。为什么 m3u8 链接不能直接下载三个绕不开的问题把一个 m3u8 或 mpd 链接贴进浏览器你得到的通常只是一份文本索引而不是一段视频。原因有三媒体是切碎的。DASH/HLS 把视频切成若干秒一个的分片segment真正的内容散落在成百上千个小文件里索引文件本身几乎不占体积。音视频可能是分离的。一条 DASH 流里1080p 视频、英语音轨、中文音轨、多语种字幕各自是独立轨道播放器在运行时把它们拼装出来下载器必须替播放器做这件事。内容往往带加密。HLS 的 AES-128、ChaCha20DASH 的 CENC 广域加密都意味着裸下分片得到的是无法播放的乱码需要按密钥体系逐片解密。市面上的浏览器插件大多只解决第一个问题而 N_m3u8DL-RE 把三件事都收进了一条命令行里。下面拆开看它是怎么做的。整体架构一条从 URL 到成片的数据流水线源码按职责拆成了四个工程见src/N_m3u8DL-RE.sln主程序N_m3u8DL-RE、通用库N_m3u8DL-RE.Common、解析库N_m3u8DL-RE.Parser、测试N_m3u8DL-RE.Tests。一次下载任务的完整走向如下输入 URL / 本地 .m3u8 / .mpd 文件 │ ▼ StreamExtractor 加载文本 ──► 嗅探类型路由到对应解析器 │ HLS (#EXTM3U) → HLSExtractor │ DASH (MPD) → DASHExtractor2 │ MSS (SmoothStreamingMedia) → MSSExtractor ▼ 生成轨道清单 StreamSpec分辨率/语言/码率/编码 │ ▼ 轨道筛选正则选择 / auto-select / 交互菜单 │ ├── 点播 ──► SimpleDownloadManager多线程拉分片 └── 直播 ──► SimpleLiveRecordManager2轮询刷新播放列表 管道化实时写入 │ ▼ 解密进程内 ChaCha20 / 外部 mp4decrypt / shaka-packager │ ▼ 合并分片二进制直拼 或 ffmpeg concat→ 完整媒体文件值得注意的设计是嗅探而非声明StreamExtractor.cs 拿到源文本后先看是否以#EXTM3U开头、是否含MPD标签、是否含SmoothStreamingMedia标签命中哪条就构造哪个解析器。用户不需要告诉程序这是 DASH本地文件和网络 URL 走同一入口。关键机制拆解轨道选择器把正则表达式当查询语言用面对几十个视频档位、多语种音轨、若干字幕的清单人工肉眼挑选不现实。N_m3u8DL-RE 的做法是把筛选规则设计成字段正则的组合式 DSL领域专用语言核心逻辑在 FilterUtil.cs-sv res3840*:codecshvc1:forbest # 4K HEVC 里挑码率最高的一条 -sa langja|en:forbest2 # 英语或日语音轨里挑最好的两条 -ss name中文:forall # 所有名称含中文的字幕 --custom-range 05:00-20:00 # 只下第 5 到 20 分钟之所以用正则而不是精确值是因为流媒体元数据命名极其不规范——同是1080p可能写成1920x1080、1080p、high。正则一个模式就能兜住多种写法同时forbest/worst/N参数负责在命中集合里再排一次序把选哪条和怎么选出来分成了两个独立步骤。解密链路能用进程内算法就不调外部程序Program.cs 启动时会按声明的--decryption-engine预检 ffmpeg、mp4decrypt、shaka-packager 三个外部工具是否存在缺一个就直接报错退出而不是下载一半才失败——这是典型的快速失败设计。加密方式分两条路径处理。HLS 的 ChaCha20 加密按 1024 字节块加密、nonce 前补 4 字节全零由项目自带的 CSChaCha20 在进程内完成不产生任何子进程速度快且无路径依赖而 CENC 这类需要改写 MP4 容器结构的加解密则交给 mp4decrypt 或 shaka-packager 这类专门工具。另外--mp4-real-time-decryption选项允许分片一边下载一边解密而不是全部下完再统一处理对长时直播录制能明显缩短成片等待时间。直播录制把播放列表当成一条持续生长的队列直播和点播的本质区别在于播放列表是一份会不断刷新的活文档。SimpleLiveRecordManager2.cs 的录制模型可以概括为定时器轮询播放列表间隔可配 --live-wait-time │ ▼ 对比已知分片取增量 ──► 按时间戳命名写入磁盘 │ ├── --live-real-time-merge分片下载完立即合并避免攒一堆碎片 └── --live-pipe-mux分片流经管道直接喂给 ffmpeg 实时混流出一个 .ts 文件不落中间分片它用 .NET 的 BufferBlock一个线程安全的队列结构为每条轨道单独维护待写分片用 ConcurrentDictionary 记录每条流的已录时长 / 最大索引 / 是否出现 ENDLIST直播结束出现 ENDLIST 标记或达到--live-record-limit时长上限后自动收尾。README 特意提醒--live-pipe-mux模式下管道读端由 ffmpeg 接管网络不稳定时可能丢数据所以默认仍保留分片落盘。实战演示场景一点播 HLS/DASH 三连步下载以一条带加密的 HLS 链接为例试解析N_m3u8DL-RE https://example.com/xxx.m3u8 --skip-download。加--skip-download只解析不下载终端会打印全部轨道清单分辨率、码率、语言、编码同时把原始 m3u8 和解析结果meta.json写到临时目录方便核对。指定选择确认轨道后追加-sv best -sa langzh:forbest -ss all指定最优视频、最佳中语音轨和全部字幕。正式下载加上--save-dir D:\downloads --save-name episode01执行。若分片是 CENC 加密且你有密钥补--key KID:KEYHLS 加密密钥也可以单独指定--custom-hls-method AES_128 --custom-hls-key HEX。注意事项临时目录--tmp-dir要有足够空间分片先落盘再合并磁盘满会直接失败默认下载完成后自动删除临时文件--del-after-done默认 True调试时用--skip-merge保留现场需要系统代理时程序默认跟随系统代理直连可加--use-system-proxy false。场景二直播限时录制以 2 小时赛事直播为例把直播 m3u8 地址喂给程序程序检测到直播会自动切换到录制管理器并给出提示加--live-record-limit 02:00:00 --live-real-time-merge录满 2 小时自动停止并实时合并想边录边看进度追加--live-pipe-mux输出单个 TS 文件字幕时间轴偏了可开--live-fix-vtt-by-audio用音频起始时间修正 VTT。注意事项录制期间不要杀进程低延迟 HLS 源分片刷新极快源码里分片命名已改用毫秒级时间戳见SimpleLiveRecordManager2中GetUnixTimestamp的注释修复了同秒分片互相覆盖的问题这类细节正是直播场景下最容易丢内容的地方。工程取舍几个不显眼但关键的决定合并策略分两档。二进制直拼--binary-merge速度快但对加密分片不可用——加密流会被自动检测并强制切换到该模式之外的处理路径Program.cs里对EncryptMethod.UNKNOWN有显式兜底。走 ffmpeg 合并时分片数超过 9 万个会先按 MergeUtil.cs 的PartialCombineMultipleFiles分批预合并规避 concat 协议一次性打开所有文件句柄导致的 too many open files 崩溃。预检一切外部依赖。ffmpeg 找不到在任务开始前就抛异常退出而不是在合并阶段报错错误信息也更明确。元数据全量落盘。--write-meta-json默认开启把解析出的轨道清单和选中清单都写成 JSON 放进临时目录配合--morehelp输出单选项的详细帮助排障时不必靠猜。更新检测做得很轻。Program.cs 里CheckUpdateAsync只是发一个请求读取 302 重定向头拿到最新版本号异步执行、静默失败不打断主流程。旧 Windows 的兼容处理。主程序入口检测到 Windows 6.0Vista/7时自动设置 .NET 全局化不变模式规避老系统缺少 ICU 语言包导致的CultureNotFound崩溃。避坑与常见问题下完的文件打不开多半是没解密。先看meta.json里轨道的加密方式再按上文补--key或--custom-hls-*参数。分片数极大时合并失败确认走了--use-ffmpeg-concat-demuxer或预合并路径并留意系统文件句柄上限Linux 可调ulimit -n。某些网站 403/401分片请求缺少上下文加-H Cookie: ...传请求头若分片 URL 需要继承主地址的查询参数开--append-url-params源码注释点名对 kakao.com 这类站点有效。老版本 Windows 终端乱码或报错换 cmder 等支持现代终端协议的 shell或用--no-ansi-color关 ANSI 颜色。直播录制缺头首次拉取的分片数默认 16--live-take-count想保留更早内容可调大。总结N_m3u8DL-RE 的价值点可以浓缩为四条三合一解析DASH/HLS/MSS 自动嗅探路由本地文件与在线地址同口径处理另有 单元测试 和真实 MPD 样本如 Manifest_MultiPeriod.mpd覆盖多 Period 等复杂场景可编程的轨道选择正则 DSL 覆盖分辨率、编码、语言、声道、时长、带宽等维度适合批量脚本化加密流全链路覆盖进程内 ChaCha20 外部 CENC 解密工具双路径支持实时解密直播/点播双模式轮询式直播录制带实时合并与管道混流点播支持分片范围截取和广告分片过滤--ad-keyword。适合人群有基础命令行能力、需要批量或脚本化下载流媒体的用户以及想研究 DASH/HLS 解析逻辑的开发者——解析器按接口拆分IExtractor.cs结构清晰是很好的阅读入口。获取与安装Arch 系发行版可直接yay -Syu n-m3u8dl-re-bin其他平台克隆源码后编译即可git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE/src dotnet build编译产物运行--help可查看全部参数。项目基于 MIT License 开源作者声明仅用于学习和技术研究使用者需自行确保对目标内容拥有合法获取权限。【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考