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-REN_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回车之后工具内部依次做四件事解析清单文件列出所有可用的视频、音频、字幕轨道弹出交互选择框让你勾选本次要保留的轨道多线程并行下载选中轨道的全部分片失败自动重试默认 7 次调用 ffmpeg 把视频、音频、字幕混流输出一个完整的 MP4并写入meta.json存档清单信息。提示不想在交互框里逐个点选时加--auto-select它会自动选最佳画质视频、每种语言里最好的音轨和全部字幕一条命令走全自动。按任务进阶以下四个任务按使用频率排序每个都给出可直接运行的完整命令。想深入了解实现机制的话src/N_m3u8DL-RE/DownloadManager/目录是各下载流程的入口。精确挑选音画字幕轨道目标在多轨道的 MPD/DASH 流里只拿指定规格不浪费带宽和磁盘。N_m3u8DL-RE https://example.com/video.mpd \ -sv res3840*:codecshvc1 \ -sa langzh:forbest \ -ss name中文:forall \ -M formatmp4-sv、-sa、-ss分别筛选视频、音频、字幕轨res、codecs、lang、name、channels等字段用:组合条件本身是正则表达式forbest / best2 / all决定取最优一条、前两条还是全部-M formatmp4指定最终容器可选mp4、mkv、ts手里已有的外挂字幕或额外音轨用--mux-import pathzh.srt:langchi: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 formatmp4输出容器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-colorWindows 老版本建议换 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），仅供参考