3 条命令跑通 m3u8 / DASH 流媒体下载：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
从网页源码里抠出一条以.m3u8或.mpd结尾的链接，直接点开只会得到一堆文本，喂给常见下载器也大多没反应。N_m3u8DL-RE 就是针对这类场景做的流媒体下载工具，覆盖 DASH、HLS、MSS 三种协议，点播视频和直播录制都能处理，Windows、Linux 上都能跑。
先看清楚它能干什么
| 能力 | 一句话说明 |
|---|---|
| 协议支持 | 解析 DASH（MPD）、HLS（M3U8）、MSS（ISM）清单，点播与直播均可 |
| 加密处理 | 内置 AES-128、ChaCha20 等算法，也支持手动传入密钥 |
| 运行平台 | Windows、Linux，界面提供中文与英文 |
| 输出格式 | MP4、MKV、TS 三种容器可选，字幕可导出 SRT / VTT |
| 直播录制 | 按指定时长持续抓取直播分片并合成 |
| 并发下载 | 分片多线程抓取，线程数可手动调节 |
| 过程反馈 | 实时刷新速度、完成百分比、剩余时间与重试计数 |
把工具跑起来：发布包与源码两条路
路线一：拿发布包（多数人走这条）到项目的 Release 页面下载对应平台的压缩包，解压后直接运行里面的可执行文件即可，不需要任何依赖环境。
路线二：源码编译（想参与开发或验证最新提交时）
git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build src/N_m3u8DL-RE.sln编译完成后，可执行文件会出现在输出目录中。
小提示：较老版本 Windows 自带的终端对 ANSI 输出支持不佳，颜色和控制台刷新可能异常，换用 cmder 等第三方终端体验会更稳。
第一次下载：m3u8 下载命令怎么写
第一条命令保持最简，只给链接加一个命名参数，基本不会出错：
N_m3u8DL-RE "https://example.com/video.m3u8" --save-name "我的视频"逐个拆解：
- 第一个参数（位置参数）：清单地址，
.m3u8、.mpd都行，也可以指向本地文件。 --save-name：决定最终保存的文件名，程序会自动补上扩展名。- 其余行为都有默认值：下载线程数默认取本机 CPU 核心数，单个分片失败默认重试 3 次，完成后临时文件自动清理。
运行期间控制台会滚动显示下载速度、已完成比例和预计剩余时间，等进度走满即可在默认目录找到成片。
进阶组合拳：按目的加参数
不需要背参数，下面这张表按"你想实现什么"来查：
| 你想实现什么 | 加哪些参数 |
|---|---|
| 下载加密分片 | --key <密钥>；多把密钥可重复传入，也支持KID:KEY成对写法 |
| 指定解密引擎 | --decryption-engine，可选FFMPEG、MP4DECRYPT、SHAKA_PACKAGER |
| 录制 1 小时直播 | --live-record-limit 01:00:00（HH:mm:ss 格式） |
| 挑视频画质 | -sv/--select-video，例如best取最高档 |
| 挑音频码率 | -sa/--select-audio，例如192000 |
| 挑字幕语言 | -ss/--select-subtitle，例如zh |
| 改输出目录 / 临时目录 | --save-dir、--tmp-dir |
| 限制带宽 | -R/--max-speed，单位支持 Mbps 或 Kbps，如15M、100K |
| 加下载线程 | --thread-count 16 |
| 出问题时留痕 | --log-level DEBUG --log-file-path "log.txt" |
批量下载就写一个脚本，一行一条命令串行执行即可：
@echo off N_m3u8DL-RE "视频链接1" --save-name "视频1" N_m3u8DL-RE "视频链接2" --save-name "视频2"带宽紧张时，给每条命令追加--max-speed 512之类上限，避免占满链路。遇到"到底哪一步挂了"说不清的情况，把日志级别提到 DEBUG 并落地到文件，事后再翻日志比盯着控制台快得多。
排错速查：下载慢、解密失败、链接不识别
| 现象 | 可能原因 | 处理办法 |
|---|---|---|
| 速度明显偏慢 | 线程未跑满、网络本身差、DNS 解析慢 | 调大--thread-count；排查网络链路；更换 DNS 服务器 |
| 解密阶段报错 | 密钥不对，或密钥格式不符合要求 | 核对密钥来源；十六进制密钥应为 16 / 32 位；用--decryption-engine换一种引擎再试 |
| 提示无法识别链接 | 给的地址并不是真实清单，或缺少必要请求头 | 确认地址指向.m3u8/.mpd文件；用-H补 Referer、User-Agent；必要时以--base-url指定解析基准地址 |
源码地图：想深入时看哪里
解析、下载、解密、合并四条流水线各自独立成模块，对照目录看即可：协议解析核心在 src/N_m3u8DL-RE.Parser/，多线程下载引擎在 src/N_m3u8DL-RE/Downloader/，加解密实现在 src/N_m3u8DL-RE/Crypto/，分片合成逻辑则集中在 src/N_m3u8DL-RE/Util/MergeUtil.cs。
写在最后
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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
