M3U8/MPD流媒体下载完整指南：从0到1上手N_m3u8DL-RE
【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE
N_m3u8DL-RE是一款跨平台流媒体下载工具，能解析 M3U8、MPD、ISM 播放列表，支持点播下载、直播录制与加密流解密。本文只讲四件事：它适合什么场景、第一次怎么配置、内部如何实现、坑在哪里。
🎯 流媒体离线保存的三个典型场景
课程视频按流分发
网课常以 M3U8 分段分发，播放页没有下载按钮。把链接交给程序，它会解析播放列表、逐段下载并合并成单个可播放文件。
直播回看与录制
赛事、发布会一类的活动，可以持续录制 DASH/HLS 直播流，结束后自动合并；用--live-record-limit限定录制时长，只保留需要的部分。
个人素材归档
多语言音轨、多分辨率变体、字幕轨，用-sv/-sa/-ss可同时选取；--save-pattern按分辨率等变量自动命名，避免文件名冲突。
🚀 第一次下载怎么配置
环境一句话：clone 仓库（https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE），取 release 页对应平台的二进制，或用dotnet build自行构建（.NET 10）。
最短形态是：N_m3u8DL-RE "链接" --save-name 文件名。想"能拿最好的就拿最好的"，加上选流与并发：
N_m3u8DL-RE "https://example.com/master.m3u8" --save-name my_video -sv best -sa best -mt其余参数按需查表：
| 参数 | 作用 | 什么时候用 |
|---|---|---|
-sv best/-sa best | 正则选出最高质量视频/音频轨 | 多码率流 |
-mt | 音、视、字幕并行下载 | 多轨下载慢时 |
--key KID:KEY | 给加密流提供解密密钥 | 流带加密头时 |
--custom-range 05:00-20:00 | 只下载部分片段区间 | 长视频只取一段 |
加密流、多线程、跨平台是怎么实现的
加密M3U8流怎么下载
HLS 流分段用 AES/ChaCha20 加密时，直接下下来的密文无法播放。程序内置解密引擎：ChaCha20 有纯 C# 实现，按每 1024 字节一段解密；CENC 类加密交给 mp4decrypt/ffmpeg 等外部工具处理，--decryption-engine可切换；密钥用--key KID:KEY指定。实现见src/N_m3u8DL-RE/Crypto/（AESUtil.cs、CSChaCha20.cs）。
多线程下载怎么配置
几百个分片串行下载浪费带宽：它做分片级并发，默认线程数为 CPU 线程数，--thread-count可调，分片异常自动重试（默认 3 次）。网络良好且源站支持并发时提速明显，单轨或源站限速场景收益有限。调度逻辑在src/N_m3u8DL-RE/DownloadManager/SimpleDownloadManager.cs。
Windows、macOS、Linux上怎么用
单一 .NET 构建（AnyCPU;x64），同一命令行在 Windows、macOS、Linux 行为一致；较老的 Windows 终端可能不兼容，README 建议换用 cmder 一类终端运行。工程配置见src/N_m3u8DL-RE/N_m3u8DL-RE.csproj。
六个参数技巧与常见坑
| # | 坑/技巧 | 具体建议 |
|---|---|---|
| 1 | 盲目加线程 | 默认即 CPU 线程数，源站支持并发再上调；网络差时加线程不会更快 |
| 2 | 存储空间 | 1080p 一小时视频约 800MB~1.5GB，多轨时数倍于此 |
| 3 | 直播断流 | 网络不稳易丢分片，用--live-wait-time调播放列表刷新间隔 |
| 4 | 输出格式 | 默认音视频分离；想要单文件加-M format=mp4或mkv |
| 5 | 文件名冲突 | 多分辨率同下时加--save-pattern "<SaveName>_<Resolution>" |
| 6 | 版权红线 | 只下载有合法权限的内容，限于学习与技术研究 |
先打开TestStreams.md挑一条测试链接，用本文第一条命令下载一遍，再补上-mt对比速度。
【免费下载链接】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），仅供参考
