N_m3u8DL-RE 实战教程:从第一条命令到直播录制,搞定 M3U8/MPD 流媒体下载

N_m3u8DL-RE 实战教程:从第一条命令到直播录制,搞定 M3U8/MPD 流媒体下载

【免费下载链接】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/MPD 清单地址,解析、分片下载、解密、合并全部自动完成,不需要你手动抓分片。
  • 多音轨不知道怎么挑:一条 DASH 流拆出十几条视频、音频、字幕轨,它内置正则筛选器,按分辨率、编码、语言、声道等字段精确挑轨。
  • 直播只能看一次:它原生支持直播录制,边播边存,录制时长、停止时机都可以提前写进命令里。
  • 视频被加密了:AES-128、CENC 这类常见加密,只要你拿到密钥,把参数传对,解密后直接产出可播放的文件。

三分钟跑通第一次下载

安装分平台各一句话:Windows 从 Release 页面下载对应版本解压,在终端里直接运行可执行文件(老版本 Windows 自带终端可能不兼容,换 cmder 运行即可);macOS 与 Linux 解压后授予执行权限,终端里运行;Arch 系 Linux 可以直接走包管理器:

yay -Syu n-m3u8dl-re-bin

然后是最简形态的一条命令:

N_m3u8DL-RE "https://example.com/video.m3u8"

回车之后,工具内部依次做四件事:

  1. 解析清单文件,列出所有可用的视频、音频、字幕轨道;
  2. 弹出交互选择框,让你勾选本次要保留的轨道;
  3. 多线程并行下载选中轨道的全部分片,失败自动重试(默认 7 次);
  4. 调用 ffmpeg 把视频、音频、字幕混流,输出一个完整的 MP4,并写入meta.json存档清单信息。

提示:不想在交互框里逐个点选时,加--auto-select,它会自动选最佳画质视频、每种语言里最好的音轨和全部字幕,一条命令走全自动。

按任务进阶

以下四个任务按使用频率排序,每个都给出可直接运行的完整命令。想深入了解实现机制的话,src/N_m3u8DL-RE/DownloadManager/目录是各下载流程的入口。

精确挑选音画字幕轨道

目标:在多轨道的 MPD/DASH 流里只拿指定规格,不浪费带宽和磁盘。

N_m3u8DL-RE "https://example.com/video.mpd" \ -sv res="3840*":codecs=hvc1 \ -sa lang=zh:for=best \ -ss name="中文":for=all \ -M format=mp4
  • -sv、-sa、-ss分别筛选视频、音频、字幕轨,res、codecs、lang、name、channels等字段用:组合,条件本身是正则表达式;
  • for=best / best2 / all决定取最优一条、前两条还是全部;
  • -M format=mp4指定最终容器,可选mp4、mkv、ts;
  • 手里已有的外挂字幕或额外音轨,用--mux-import path=zh.srt:lang=chi:name="简体中文"一并混进去。

提示:写正则前先跑一遍不加筛选参数的命令,在交互选择框里看清轨道实际长什么样,再决定条件怎么写,能少走不少弯路。

直播录制参数怎么配

目标:长时间直播完整录下来,中途断掉也保留已录部分。

N_m3u8DL-RE "https://example.com/live.m3u8" \ --live-real-time-merge \ --live-record-limit 03:00:00
  • --live-real-time-merge:分片边下载边实时合并进文件,录制中断时已有内容依然完整可播;
  • --live-record-limit HH:mm:ss:录制时长上限,到点自动停止退出;
  • --live-perform-as-vod:把直播清单当点播处理,适合"边播边生成清单"的 HLS 直播;
  • --live-pipe-mux:走管道把音视频实时喂给 ffmpeg 混流成 TS,体验更顺滑,但依赖 ffmpeg 从管道稳定读数据。

注意:弱网环境下优先--live-real-time-merge,不要开--live-pipe-mux,管道断流会直接丢帧丢数据。

加密流解密命令

目标:拿到密钥后,把 CENC/AES-128 加密流解密成正常 MP4。

N_m3u8DL-RE "https://example.com/encrypted.m3u8" \ --key 0123456789ABCDEF0123456789ABCDEF \ --decryption-engine MP4DECRYPT
  • --key支持单个 KEY 或KID:KEY成对传入,多个密钥就写多个--key;
  • --decryption-engine在MP4DECRYPT、SHAKA_PACKAGER、FFMPEG三选一,默认 MP4DECRYPT;
  • 特殊 HLS 场景还可以用--custom-hls-method、--custom-hls-key、--custom-hls-iv手动指定加密方式、密钥和 IV。

提示:源码src/N_m3u8DL-RE/Crypto/目录内置了 AES、ChaCha20 的实现,非常规加密也有兜底路径。解密功能请只用于你有权访问的内容。

批量下载与定时任务配置

目标:一组链接批处理,或让任务在固定时间点自动开跑。

N_m3u8DL-RE "https://example.com/video.m3u8" \ --save-dir ./videos \ --task-start-at 20250101080000 \ --no-log
  • --task-start-at格式为yyyyMMddHHmmss,到点之前任务保持等待;
  • --no-log关闭日志文件输出,配合--log-level ERROR只保留错误信息,日志更干净;
  • -R 15M限速,单位 Mbps 或 Kbps,挂在共享网络下防止占满带宽。

提示:批量下载时把 URL 和--save-name作为变量写进 shell 循环,再叠加--save-pattern "<SaveName>_<Resolution>_<Bandwidth>",整个系列的命名就能自动区分,不用事后手动整理。

参数速查表

参数作用典型用法/适用场景
"url"清单地址或本地文件所有任务的第一步
--auto-select自动选最佳视频、各语言最佳音频、全部字幕免手动勾选的全自动下载
--thread-count分片下载线程数,默认等于 CPU 核数加速大文件下载
-R 15M限速,Mbps/Kbps共享带宽下控速
-sv / -sa / -ss正则筛选视频/音频/字幕轨多轨道精确挑轨
--live-real-time-merge录制时实时合并分片长直播、怕中断的录制
--live-record-limit录制时长上限 HH:mm:ss定时停止、无人值守
--key传入解密密钥,支持 KID:KEYCENC/AES 加密流
--decryption-engine选择解密工具默认解密结果不满意时切换
-M format=mp4输出容器:mp4/mkv/ts指定成片格式
--save-dir / --save-name / --save-pattern存放目录、文件名、命名模板批量归档
-H追加请求头403 时伪装 Cookie/UA
--custom-proxy指定代理地址需代理才能访问的站点
--download-retry-count分片失败重试次数,默认 7网络波动大的环境
--task-start-at任务开始时间 yyyyMMddHHmmss定时无人值守下载
--append-url-params把输入 URL 的查询参数加到分片令牌挂在 URL 上的站点

排障手册

问:启动后提示找不到 ffmpeg,合并环节报错?原因:混流依赖 ffmpeg,但它不在 PATH 里。解决:安装 ffmpeg,或用--ffmpeg-binary-path指定完整路径。

问:分片请求全是 403?原因:站点校验了 Cookie 或 User-Agent。解决:加-H "Cookie: ..."、-H "User-Agent: ..."伪装请求头。

问:直播录制出现花屏、断流?原因:弱网下开了--live-pipe-mux,管道数据丢失。解决:关闭管道混流,改用--live-real-time-merge。

问:分片下载频繁失败、任务卡住?原因:网络波动或对端限速。解决:调大--download-retry-count、拉长--http-request-timeout(默认 100 秒),或降低--thread-count。

问:终端显示乱码或颜色异常?原因:老系统终端不支持 ANSI 颜色。解决:加--no-ansi-color;Windows 老版本建议换 cmder 运行。

开始动手

去项目 Release 页面取对应平台的版本解压即用,或者克隆源码自行构建:git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE后执行dotnet build。对某个参数不确定时,先查内置帮助N_m3u8DL-RE --help,再对单个参数用--morehelp 参数名看详细说明,完整文档见项目 README。跑通第一条命令之后,剩下的就是把参数按任务组合起来。

【免费下载链接】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),仅供参考

相关新闻

UniHacker 实测:三步完成 Unity 许可证验证绕过,免费打开任意工程

UniHacker 实测:三步完成 Unity 许可证验证绕过,免费打开任意工程

UniHacker 实测&#xff1a;三步完成 Unity 许可证验证绕过&#xff0c;免费打开任意工程 【免费下载链接】UniHacker 为Windows、MacOS、Linux和Docker修补所有版本的Unity3D和UnityHub 项目地址: https://gitcode.com/GitHub_Trending/un/UniHacker 凌晨一点&#xff…

2026/11/10 16:17:06 阅读更多 →
贾子猜想与 AI 智慧级别的自我定位| Kucius Conjecture and AI‘s Self-Positioning on the Wisdom Scale

贾子猜想与 AI 智慧级别的自我定位| Kucius Conjecture and AI‘s Self-Positioning on the Wisdom Scale

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/11/17 23:04:08 阅读更多 →
通达信行情拉取总是超时?用 mootdx 三步拿到 A 股数据

通达信行情拉取总是超时?用 mootdx 三步拿到 A 股数据

通达信行情拉取总是超时&#xff1f;用 mootdx 三步拿到 A 股数据 【免费下载链接】mootdx 通达信数据读取的一个简便使用封装 项目地址: https://gitcode.com/GitHub_Trending/mo/mootdx 上个月排查一个通达信日线脚本&#xff1a;第一轮报 ConnectionError: timed out…

2026/11/18 20:33:45 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年&#xff0c;我大部分时间都在跟浏览器标签页打交道&#xff0c;直到第一次把桌面应用跑起来&#xff0c;才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词&#xff0c;最开始是在某段时间频繁出现在同事的讨论里&#xff0c;一个用HTML…

2026/11/18 13:59:04 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档&#xff0c;主要面向智能锁安装人员、终端用户及售后维护者&#xff0c;帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件&#xff0c;大小4.37MB&#xff0c;内容结构清晰&#xff…

2026/11/18 15:33:23 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统&#xff0c;整车要求空载跑到8m/s&#xff0c;电机转速已经拉到额定点&#xff0c;驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令&#xff0c;转速纹丝不动&#xff0c;三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/18 17:05:28 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年&#xff0c;用它写过嵌入式驱动、做过游戏服务端&#xff0c;也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词&#xff0c;我其实挺感慨的——这门语言的难点从来不是语法多&#xff0c;而是知识点之间的耦合太深…

2026/11/18 14:33:19 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介&#xff1a;亚太天能T109滑盖智能锁产品说明书以PDF格式发布&#xff0c;适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开&#xff0c;先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能&#xff0c;再给出完整安装步骤&…

2026/11/18 17:05:28 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历&#xff1a;翻开源码注释、论文摘要或者一份专业报告&#xff0c;每个字都认识&#xff0c;连在一起却像天书。想找人聊聊&#xff0c;身边要么没人懂&#xff0c;要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型&#xff0c;几秒钟之后&a…

2026/11/18 14:13:08 阅读更多 →

日新闻

周新闻

月新闻