N_m3u8DL-RE 快速上手：一条命令下载 M3U8/MPD 加密流，跨平台免费

2026/8/14 19:51:05

N_m3u8DL-RE 快速上手：一条命令下载 M3U8/MPD 加密流，跨平台免费

【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE

当你拿到一个.m3u8或.mpd播放列表链接，想把它保存成一段完整的本地视频时，N_m3u8DL-RE 会是你见过的最省心的答案。这是一款基于 C# 的跨平台流媒体下载工具，支持 DASH/HLS/MSS 三大主流协议，内置 AES 与 ChaCha20 解密能力，点播、直播都能处理，而且完全免费开源。下面这份指南会从常见的认知误区讲起，带你逐步掌握它的正确用法。

动手之前，先戳破三个关于流媒体下载的误会

误会一：M3U8 下载就是把几十个 ts 片段挨个保存

很多人的第一反应是"用浏览器插件嗅探出所有 .ts 链接，再写脚本批量保存"。这条思路没错，但极其脆弱：一个 2 小时的视频可能有上千个分片，插件崩一次、断网一次就得重来，更别提有些站点还做了防盗链、动态签名和跨域限制。N_m3u8DL-RE 的做法是把"读取播放列表 → 下载全部片段 → 解密 → 合并"整条流水线自动化，你只需要提供一个链接，剩下的交给它。

误会二：加密视频必须靠付费软件或神秘技巧

HLS 常见的 AES-128 加密、DASH 常见的 CENC 加密，其实都有公开的密钥管理机制，并非不可破解的黑盒。N_m3u8DL-RE 在src/N_m3u8DL-RE/Crypto/下实现了AESUtil和ChaCha20Util，能处理大多数点播场景；对于更复杂的 DRM 内容，它还支持把密钥交给mp4decrypt、shaka-packager或ffmpeg去解，--key参数一行就能指定，不必求助于付费工具。

误会三：下载工具只认 HLS，遇到 MPD 就抓瞎

M3U8 只是 HLS 的清单格式，如今主流平台越来越多采用 DASH（清单为 .mpd）或微软的 ISM。N_m3u8DL-RE 在src/N_m3u8DL-RE.Parser/Extractor/下同时内置了HLSExtractor、DASHExtractor2、MSSExtractor三个解析器，三种协议的流都能直接喂给它。这也是"RE"这个名字想强调的定位：不只是 M3U8 下载器，而是一个通用流媒体下载器。

它凭什么能"一键"完成：四个环节拆开看

一次看似简单的下载，背后其实是四个模块的接力，它们在src/目录里对应着清晰的代码分层。

第一棒：解析层。N_m3u8DL-RE.Parser负责把播放列表读成结构化数据，包括每个分片的地址、时长、加密方式、音视频轨道的码率与语言信息。你可以在src/N_m3u8DL-RE.Parser/Config/ParserConfig.cs看到解析配置的入口。

第二棒：加密处理层。检测到加密内容时，N_m3u8DL-RE/Crypto/会按EncryptMethod枚举分发到对应的解密实现；解密用的第三方程序路径则通过DecryptEngine枚举管理（src/N_m3u8DL-RE/Enum/）。

第三棒：下载调度层。SimpleDownloadManager负责点播场景的多线程分片下载，HTTPLiveRecordManager与SimpleLiveRecordManager2负责直播场景的持续拉流。它们都在src/N_m3u8DL-RE/DownloadManager/下。

第四棒：合并混流层。下载完成后，MergeUtil（src/N_m3u8DL-RE/Util/）会把音视频、字幕合并进 mp4 或 mkv 容器，必要时调用 ffmpeg 完成混流。

理解这条流水线，你就能推断出每个命令行参数大概影响哪个环节——这比死记硬背选项高效得多。

三分钟跑通第一个下载任务

获取程序

最简单的方式是从项目 Release 页面下载对应平台的现成二进制；想自己编译也很直接：

git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build src/N_m3u8DL-RE.sln

跑一个最简单的命令

拿一个点播流举例，一条命令就能完成全流程：

N_m3u8DL-RE "https://example.com/video.m3u8" --save-name myvideo

程序会默认选择最佳的音频、视频和字幕轨道，下载完成后自动合并，并在终端里实时显示每个分片的下载速度与进度百分比——这些进度渲染逻辑可以在src/N_m3u8DL-RE/Column/下看到，连下载速度列都是单独封装的。

第一次运行要注意什么？

如果系统里没有 ffmpeg，先装好它，或用--ffmpeg-binary-path指定完整路径，否则合并步骤会失败。
想指定输出位置，用--save-dir和--tmp-dir分别控制成品目录与临时目录。
下载日志默认写入文件，出问题时可先用--log-level DEBUG重跑一遍，错误定位会清晰得多。

五个高频场景：从"能下载"到"会下载"

场景一：只想选某一条音轨

默认的"全选最佳"未必合你胃口。想拿最佳画质视频、最佳英语音轨、全部中文字幕，可以这样组合：

N_m3u8DL-RE "https://example.com/manifest.mpd" -sv best -sa lang=eng:for=best -ss name="中文":for=all -M format=mp4

-sv、-sa、-ss都支持用正则表达式精确匹配，例如-sv res="3840*":codecs=hvc1就能锁定 4K 的 HEVC 视频轨，非常适合强迫症用户。

场景二：长视频只想要中间一段

不用先全量下载再剪辑，--custom-range直接按分片序号或时间范围切：

N_m3u8DL-RE "https://example.com/video.m3u8" --custom-range 05:00-20:00

需要整场演讲里的某段高潮？这条参数能帮你省下大量带宽和时间。

场景三：直播流实时落盘

录制 DASH/HLS 直播时，加上--live-real-time-merge可以边录边合并，避免中途崩溃导致数据全丢；网络极稳的环境下还可以尝试--live-pipe-mux走管道直通 ffmpeg 实时封装成 TS。想控制录制时长，用--live-record-limit 02:00:00即可。注意：网络波动较大的场景不要开--live-pipe-mux，管道数据在弱网下容易丢。

场景四：手动指定密钥解加密内容

当密钥没有自动出现在播放列表里时，可以手工喂给程序：

N_m3u8DL-RE "https://example.com/encrypted.mpd" --key KID:KEY -M format=mp4

若所有分片使用同一个密钥，直接写--key KEY即可；密钥较多时还可以用--key-text-file传入密钥文件。解不开时，先确认加密算法（--custom-hls-method可以强制指定 AES_128、CHACHA20、CENC 等），再检查解密引擎路径配置，这两步能解决九成以上的解密报错。

场景五：批量下载与轨道编排

一次任务里想同时并发拉取多组音视频，用-mt（--concurrent-download）开启并发；需要把多个分辨率的视频存成不同文件，用--save-pattern "<SaveName>_<Resolution>"这样的命名模板，<Language>、<Bandwidth>、<Codecs>等变量都可组合，脚本化批量下载时非常顺手。

踩坑手册：常见问题速查

下载速度上不去。先检查线程数，--thread-count 16通常能显著提速；确认是否走代理，--custom-proxy http://127.0.0.1:8080指定代理，或--use-system-proxy false关闭系统代理；个别站点对分片有签名时效，--download-retry-count 5和--http-request-timeout 30能减少偶发失败。
合并阶段报错。多半是 ffmpeg 缺失或路径不对，检查--ffmpeg-binary-path；也可能是磁盘空间不足，给--tmp-dir换个大分区的路径。
下载的分片数和预期对不上。默认开启的--check-segments-count会帮你发现静默丢失的分片，遇到这种情况提高重试次数后重跑即可。
旧版 Windows 终端显示乱码。低版本系统自带终端可能不支持 ANSI，程序内已做了兼容处理，也可以在 cmder 等终端里运行。

写在最后：能下载，不等于可以随便下载

N_m3u8DL-RE 的价值在于把解析、解密、下载、合并这条原本繁琐的链路压缩成一条命令，它适合下载你有权访问的内容：公开的测试流、自己购买课程的离线缓存、免费电台的录制存档等。请在下载前确认内容的授权范围，遵守你所在地区的法律法规与平台服务条款。工具本身是中立的，怎么使用，取决于你自己。

如果你是从零开始，建议按这条路径走：先用一条简单命令跑通一个公开测试流，再逐个尝试-sv/-sa选择轨道，最后探索直播录制与自定义密钥——你会发现，从"能下载"到"会下载"，中间只差一次动手实验的距离。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

N_m3u8DL-RE 快速上手：一条命令下载 M3U8/MPD 加密流，跨平台免费