N_m3u8DL-RE 使用教程:最强 M3U8 下载器完整指南(2026)

如果你用 FFmpeg 下载 M3U8 遇到障碍,或是需要更多自动化控制,N_m3u8DL-RE 几乎是目前最强大的开源选择。
它能自动处理 Master Playlist 画质选择、AES-128 解密、多线程下载、自定义 HTTP Header,甚至支持部分 MPD(DASH)格式。这篇文章带你从安装到进阶使用,完整搞懂这个工具。
N_m3u8DL-RE 是什么?
N_m3u8DL-RE(GitHub:nilaoda/N_m3u8DL-RE)是由中国开发者 nilaoda 维护的开源命令行工具,使用 .NET 开发,跨平台支持 Windows / macOS / Linux。
它的前身是 m3u8DL-CLI(Windows 专用),-RE 版本是 Remake,重写后性能与兼容性大幅提升。
主要特点
- ✅ 多线程并行下载:默认多段同时下载,速度比 FFmpeg 快数倍
- ✅ 自动选最高画质:解析 Master Playlist 后自动选择分辨率
- ✅ AES-128 自动解密:内置解密逻辑,不需要额外工具
- ✅ 自定义 HTTP Header:支持 Cookie、Referer、Token 等
- ✅ 断点续传:下载中断后可恢复
- ✅ 跨平台:Windows / macOS / Linux 单一执行文件
想先了解 M3U8 的下载原理,可以参考 👉 M3U8 下载教程:HLS 链接转存为 MP4。
安装方式
Windows 安装
- 前往 GitHub Releases 页面
- 下载最新版的
N_m3u8DL-RE_Beta_Win_x64_...zip - 解压缩,运行
N_m3u8DL-RE.exe(或添加到 PATH) - 不需要安装 .NET Runtime(已内嵌)
macOS 安装
# 下载 macOS 版本后解压
chmod +x N_m3u8DL-RE
./N_m3u8DL-RE "https://example.com/stream.m3u8"
或通过 Homebrew(若社区有提供配方):
brew install n_m3u8dl-re
Linux 安装
# 下载 Linux amd64 版本
wget https://github.com/nilaoda/N_m3u8DL-RE/releases/download/vX.X.X/N_m3u8DL-RE_Beta_Linux_x64.zip
unzip N_m3u8DL-RE_Beta_Linux_x64.zip
chmod +x N_m3u8DL-RE
基本使用方法
最简单的下载命令
N_m3u8DL-RE "https://example.com/stream.m3u8"
这一行就能自动完成:解析 M3U8 → 选最高画质 → 多线程下载 → 合并为 MP4。
指定输出文件名
N_m3u8DL-RE "https://example.com/stream.m3u8" --save-name "my_video" --save-dir "D:\Downloads"
指定画质
# 自动选最高画质(默认)
N_m3u8DL-RE "https://..." --select-video best
# 指定分辨率
N_m3u8DL-RE "https://..." --video-sort-tags "RESOLUTION:1280x720"
进阶使用:绕过常见限制
自定义 Referer 和 Headers
很多 CDN 会检查请求来源,这是最常用的绕过方式:
N_m3u8DL-RE "https://example.com/stream.m3u8" \
--header "Referer: https://example.com/" \
--header "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
带入 Cookie(登录后的流媒体)
N_m3u8DL-RE "https://example.com/stream.m3u8" \
--header "Cookie: session_id=abc123; token=xyz"
这对需要账号登录才能观看的链接特别有用,前提是 Cookie 是有效的。
自动处理 AES-128 加密
如果 M3U8 有 #EXT-X-KEY:METHOD=AES-128 加密,N_m3u8DL-RE 会自动处理,不需要额外设置。工具会自动去获取密钥并解密每个 TS 分片。
若密钥本身也需要验证,可以加上额外的 Key Header:
N_m3u8DL-RE "https://..." \
--key-text-file "key.txt" # 本地密钥文件
想了解 AES-128 加密的原理,可以参考 👉 M3U8 加密与 DRM 解析。
设置并行下载数量
# 默认通常是 16 个并行连接
N_m3u8DL-RE "https://..." --concurrent-download 32
⚠️ 注意:设置过高可能被服务器封锁,建议不要超过 32。
M3U8X 是什么?跟 N_m3u8DL-RE 有什么不同?
M3U8X 是另一个常见的 M3U8 下载工具,有提供图形界面(GUI),但适合对象不同。
功能比较表
| 功能 | N_m3u8DL-RE | M3U8X |
|---|---|---|
| 操作方式 | 命令行(CLI) | 图形界面(GUI)+ 命令行 |
| 跨平台 | ✅ Win/Mac/Linux | ⚠️ 主要是 Windows |
| 自定义 Header | ✅ 完整支持 | ⚠️ 有限支持 |
| AES-128 解密 | ✅ 自动 | ✅ 支持 |
| 速度(并行) | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 适合对象 | 技术用户 / 开发者 | 一般用户 |
| 开源 | ✅ GitHub | ❌ 闭源 |
| 免费 | ✅ | ✅ |
结论:如果你习惯命令行,N_m3u8DL-RE 功能更强;如果你想要图形界面,M3U8X 是不错的选择。
什么时候用工具下载,什么时候用在线工具?
| 场景 | 建议方案 |
|---|---|
| 快速测试链接能否播放 | M3U8Go 在线播放器 最方便 |
| 短片(30分钟内)下载 | HLS 浏览器下载工具 免安装 |
| 长片 / 需要自定义 Header | N_m3u8DL-RE 最稳 |
| 批量下载多个链接 | N_m3u8DL-RE 命令行脚本 |
| 不懂命令行的用户 | M3U8X(GUI) 或本站在线工具 |
常见问题 FAQ
N_m3u8DL-RE 是免费的吗?
是的,完全开源免费。授权条款为 MIT License,可以自由使用、修改和分发。
m3u8dl 跟 N_m3u8DL-RE 是同一个东西吗?
m3u8dl 通常是指 N_m3u8DL-RE 的俗称,或是指它的前身 m3u8DL-CLI(已停止维护)。建议下载 -RE 版本(GitHub nilaoda/N_m3u8DL-RE)。
为什么我的下载出现 403 错误?
403 代表服务器拒绝你的请求,通常是因为缺少正确的 Referer 或 Token。解决方法是加上 --header "Referer: 原始网页链接"。更多错误解析可以参考 👉 M3U8 常见错误修復。
N_m3u8DL-RE 可以下载 DRM 保护的链接吗?
不行。如 Netflix、Disney+ 等 DRM 保护内容,使用任何工具都无法下载。详情请看 👉 M3U8 加密与 DRM 解析。
下载速度很慢怎么办?
可以尝试增加 --concurrent-download 的数值,或使用代理服务器。详细加速方法请参考 👉 M3U8 下载速度慢解法。
下载后没有声音怎么办?
通常是音频格式不兼容(AC-3 vs AAC)。可以加上 --mux-after-done 让工具在合并时自动处理,或使用 FFmpeg 补转码。详见 👉 M3U8 转档没声音修复。
想立即测试您的 M3U8 链接吗?
🚀 立即测试 M3U8 在线播放器