一条命令搞定 M3U8 视频下载：N_m3u8DL-RE 完整上手手册-尧图网络科技

一条命令搞定 M3U8 视频下载：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 正是为这种时刻准备的流媒体下载工具——免费、开源、跨平台，一条命令就能把 MPD / M3U8 / ISM 格式的点播视频和直播流搬回本地硬盘。

先弄明白：它到底在帮你"搬"什么？

大部分视频网站不会直接把 MP4 甩给你，而是把视频切成上百个小分片，再配一张"目录清单"（M3U8、MPD 这类文件），播放器边读清单边按顺序播放。N_m3u8DL-RE 做的事，就是替你读懂这张清单，把分片一个个抓下来再合并成完整文件——相当于给你搭了一座从"只能在线看"通往"随时能回看"的桥。

它主要支持三种协议：

协议	常见后缀	典型场景
HLS	.m3u8	直播、在线点播（应用最广）
DASH	.mpd	高清平台、自适应码率
MSS	.ism/.ismc	微软系流媒体服务

Windows、macOS、Linux 通吃，界面自带简体中文、繁体中文和英文，几乎零门槛。

一句话小结：N_m3u8DL-RE 下载的核心能力，是把"清单+分片"的流媒体还原成一个能离线播放的完整视频文件。

把在线课程"存"下来：三分钟完成第一次下载

先把工具装好。Windows 用户去 Release 页面下载对应系统的压缩包解压即用；Arch Linux 用户更省事：

yay -Syu n-m3u8dl-re-bin

想尝鲜最新功能，也可以从源码自己构建：

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

装好后，最基础的用法短到不可思议：

N_m3u8DL-RE "你的视频链接"

是的，就这一行。不过想让下载体验更好，建议给命令加点"佐料"：

N_m3u8DL-RE "https://example.com/course.m3u8" \ --save-dir "./我的课程" \ --save-name "网络编程-第01讲" \ --thread-count 8

--save-dir：指定视频存进哪个文件夹；
--save-name：给视频起个一眼能认出来的名字，告别一堆乱码文件名；
--thread-count：下载线程数，默认已按你的 CPU 自动设置，带宽够大可适当调大，速度提升立竿见影。

小提醒：中途网络抖动别慌，--download-retry-count默认会自动重试 3 次，大多数情况根本轮不到你操心。

追直播却总错过：让直播自动变成录像

点播只是开胃菜，N_m3u8DL-RE 真正的看家本领是直播录制。深夜开打的比赛、不想熬夜蹲守的发布会，都可以让它"代班"：

N_m3u8DL-RE "直播地址" \ --live-real-time-merge \ --live-record-limit 02:00:00

--live-real-time-merge：边录边把分片实时合并，录完即是完整文件，不用等结束再统一处理；
--live-record-limit：设定录制时长上限，这里的02:00:00表示最多录 2 小时，免得整夜开机。

直播中途断流也不用紧张，程序会持续刷新播放列表并尝试接续拉取。录完这一场，你就悄悄拥有了一座私人"回放库"。

碰上加密视频：解密其实没那么吓人

有些视频源会加密，直接硬下回来只会得到一堆播放不了的碎片。N_m3u8DL-RE 内置了多种解密方案，你只需要把密钥喂给它：

N_m3u8DL-RE "加密视频链接" \ --key "KID:KEY" \ --decryption-engine FFMPEG

--key：按KID:KEY的格式提供解密密钥，有多个就多写几个--key；
--decryption-engine：指定解密引擎，支持 FFMPEG、MP4DECRYPT、SHAKA_PACKAGER，看你机器上装了哪个。

密钥内容比较长时，还可以存成文本文件，用--key-text-file指向路径。至于密钥本身去哪找，属于"各凭本事"的部分，但工具已经把"拿到密钥之后的全部流程"做成了开箱即用。

下载完不是终点：把输出文件安排得明明白白

能下下来只是及格，文件整理才见功力。N_m3u8DL-RE 提供命名模板，自动生成有规律的文件名：

N_m3u8DL-RE "视频链接" \ --save-pattern "<SaveName>_<Resolution>_<Bandwidth>" \ --ui-language zh-CN

<SaveName>、<Resolution>、<Bandwidth>都是内置变量，输出就会类似我的视频_1080p_5000kbps.mp4。常用的还有<Codecs>、<Language>、<Ext>，随便组合出你想要的格式。

排查问题时再打开详细日志：

N_m3u8DL-RE "视频链接" \ --log-level DEBUG \ --log-file-path "./下载日志.txt"

记不清某个参数怎么用？直接输--morehelp 参数名，程序会当场打印该参数的完整说明，比翻文档还快。

一张速查表：常见报错与避坑指南

现象	原因	解决办法
提示找不到 .NET 运行时	系统缺依赖	Ubuntu/Debian 执行`sudo apt install dotnet-runtime`；Windows 到官网装 .NET Runtime
报 FFmpeg 相关错误	混流或解密需要它	先跑`ffmpeg -version`确认，没有就`sudo apt install ffmpeg`
Linux 下提示无权限	程序或输出目录权限不够	给程序加执行权限，确保输出目录可写
分片频繁下载失败	网络波动	调大`--download-retry-count`，或改用`--binary-merge`降低资源占用

再补两个小贴士：低配设备建议--thread-count 2 --binary-merge，CPU 和内存压力小很多；想把分离的音视频合成一个文件，下载完加一句-M format=mp4即可。想深挖实现原理的朋友，仓库里src/N_m3u8DL-RE.Parser/和src/N_m3u8DL-RE/DownloadManager/是很好的起点。