☰
N_m3u8DL-RE 流媒体下载教程:从一条命令到加密解密与直播录制
2026/10/20 1:31:02 网站建设 项目流程

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

MPD、M3U8 这类链接右键另存为只会得到一堆乱码文本。N_m3u8DL-RE 是一个跨平台流媒体下载工具,一条命令处理 DASH、HLS、MSS 链接:自动选轨、加密分片自动解密、下完自动合并成完整视频。读完后你能自己构建并跑通第一条下载命令,还能录一场直播。

开始前的速览

项目说明
定位跨平台 DASH/HLS/MSS 流媒体下载器,点播、直播都支持
支持的协议与格式MPD、M3U8、ISM;AES、ChaCha20 等加密分片
适用平台Windows / Linux / macOS
许可证MIT

上手路径:安装并跑通第一次下载

Windows 上到 Releases 页面下载 zip 包,解压即用,无需安装。

Linux/macOS 需要先克隆源码,再用 dotnet 构建:

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

构建完成后会在项目的 bin 目录下生成 N_m3u8DL-RE 可执行文件,后面命令都直接用它运行;如果可执行文件不在当前目录,把路径替换成实际位置即可。构建报错时先确认 dotnet SDK 已安装。

第一条命令只放一个链接,其余全用默认值,程序自动选最高画质:

./N_m3u8DL-RE "https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd"

✅ 终端先打印解析出的音轨、字幕列表,再开始下载,完成后合并好的成片出现在当前目录。这条官方测试流带多音轨多字幕,一次跑通就能看清它的全部能力。想只预览它挑了哪些轨不下文件,加--skip-download,只解析不下载。

密钥从哪来

你在浏览器 F12 里抓到了 KID 和 KEY,想把这门加密课存下来。密钥一般在许可证请求的响应体里,KID 是 32 位十六进制的 Key ID。把两者按KID:KEY格式贴进--key:

./N_m3u8DL-RE "https://azclwds01.akamaized.net/4e8f6858-5d05-4e28-83ab-48c7a2b259e1/XVuosg_tab_hd.ism/Manifest" \ --key "e5114f87b3e54b9faca331e6e6d646a6:55c5d9f1cedfd018b75623f2565a1d29" \ -M format=mp4 --save-name "demo"

分片边下边解,最终得到demo.mp4。这条测试流约 90 秒,几十秒内下完。解密会调用 mp4decrypt 完成,密钥填错时错误就出在这一步,源码见解密逻辑。

直播怎么录

你只想留某场直播的前两个小时,录完还要能直接播。加--live-record-limit限时,--live-real-time-merge边录边合并:

./N_m3u8DL-RE "https://cmafref.akamaized.net/cmaf/live-ull/2006350/akambr/out.mpd" \ --live-real-time-merge --live-record-limit "2:00:00" --save-dir "./record"

录满两小时自动停止,实时合并成完整 MKV 存到./record,不用等播完再处理。不限时就去掉--live-record-limit,它会一直录到你按 Ctrl+C 停止。

多音轨多字幕怎么选

一条流里既有多种语言音频又有多种字幕,你只想要最高画质加英文配音。-sv/-sa/-ss是三个正则参数各挑各的,-M负责下完混流:

./N_m3u8DL-RE "https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd" \ -sv best -sa "lang=en:for=best" -ss all -M format=mp4

-sv best挑最佳视频,-sa lang=en:for=best挑最佳英文音轨,-ss all保留全部字幕。成片输出到当前目录,文件名自动带上语言标记,几条音频不会互相覆盖。想留多语言音轨就把for=best改成for=all。

最常用的参数速查

参数作用示例值什么时候需要它
--save-dir指定输出目录./downloads不想让文件堆在当前目录
--save-name指定成片名course给批量任务统一命名
-M下完把音视频混成一个文件format=mp4拿到的是分离的视频和音轨
--key传入解密密钥KID:KEY视频是加密的
-sv按条件挑视频轨res="1920*":for=best只想要某一档画质
--thread-count下载线程数16默认线程跑不满带宽
-H附加请求头,可多次使用"Referer: https://..."链接有防盗链校验
-R限速15M不想占满带宽

出错了先看这五条

⚠️ 对照下面五类先自查;遇到"解析失败"类报错,DASH、HLS、MSS 各有一个解析器,可按协议去解析源码里对应文件查。

  • 403 拒绝访问→ 缺浏览器侧的请求头 → 加-H "Referer: 来源页"和-H "Cookie: 登录态"补上
  • 解密失败→KID:KEY之间少了冒号或 KEY 不完整 → 核对 F12 抓包原文,KEY 必须是 32 位十六进制
  • 找不到 ffmpeg→ 混流依赖本机 ffmpeg 但不在 PATH → 装好后用--ffmpeg-binary-path指到可执行文件
  • 下载速度被网站掐住→ 单连接限速 → 加--thread-count 16起多线程
  • 成片不完整→ 中途断网丢了分片 → 用--custom-range 10-只补第 10 个分片之后的内容

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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询