N_m3u8DL-RE 下载 m3u8 实战：四条命令，从链接到成品 mp4

【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE

如果你只想把 m3u8 下载成自己机器上能直接播放的文件，N_m3u8DL-RE 就是为这个场景做的工具：把链接交给它，解析播放列表、并发拉取分片、合并、解密这些活它自己干，终端里跑一遍，成品就出来了。它是单文件的命令行程序，Windows、macOS、Linux 都能用，除了 m3u8（HLS，基于 HTTP 的切片视频协议）之外，还支持 mpd（DASH，动态自适应流）和 ism（微软 Smooth Streaming 协议）。

N_m3u8DL-RE 怎么安装，装完怎么验证能跑

最省事的路径是去项目 Releases 页面，挑出对应系统和架构的压缩包，解压后把可执行文件丢进 PATH 里。Arch Linux 用户可以直接走 AUR 装。想追最新改动的话，也可以拉源码自己编译：

git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE

装完第一件事，确认它确实能执行：

N_m3u8DL-RE --version

终端回一行版本号（形如N_m3u8DL-RE 0.6.0），说明环境没问题。

✅ 如果报错或者终端一片空白，先怀疑终端太老：旧版 Windows 自带终端不支持该程序的颜色输出，换成 PowerShell 或更新一点的终端再试。

m3u8 点播整片怎么下：一条命令解析、拉取、合并

前提：链接是完整视频、不需要登录态、浏览器直接打开能播放。

N_m3u8DL-RE "https://example.com/video/index.m3u8" --save-name 我的视频 --save-dir ./out -sv best -sa best -M format=mp4

-sv best挑清晰度最高的视频轨，-sa best挑最好的音轨，-M format=mp4表示音频视频原本是分开的、最后混进一个 mp4。进度条走完，./out 下会多出一个成品文件，文件名取自--save-name。连选流条件都懒得写的话，把-sv/-sa换成--auto-select，各类轨道它会自己挑最优。解析逻辑都在 流提取器源码 里，遇到奇怪的播放列表可以看那边。

m3u8 直播怎么从头录起，怎么到点自动停

前提：链接是当前正在播的直播流，你想从现在开始录、录够指定时长就收工。

N_m3u8DL-RE "https://example.com/live/index.m3u8" --save-name 直播节目 --live-real-time-merge --live-record-limit 00:30:00

--live-real-time-merge让它在下载的同时实时合并，磁盘上不会堆一堆没处理的分片；--live-record-limit 00:30:00是 HH:mm:ss 格式，到 30 分钟自动结束。流里夹着不想要的段落，可以用--ad-keyword按 URL 关键字丢掉对应分片；想在开播后先回补前几个小时的内容，加--live-catchup。录制相关的调度在 直播录制管理 里实现，中断后重跑同一条命令即可接着已落盘的进度继续。

加密 m3u8 的密钥从哪拿，怎么传给 --key

前提：分片是密文（常见的是 CENC（通用加密）或 AES-128），播放列表里只有分片地址、没有明码。密钥一般在浏览器开发者工具的 Network 面板里，找到返回密钥的那条请求，把 KID（密钥 ID）和 KEY（密钥内容）各复制一份，两段都是十六进制。

N_m3u8DL-RE "https://example.com/enc/index.m3u8" --save-name 解密后视频 --key "eb676abb:100b6c20"

--key的格式是KID:KEY，多组密钥就写多次；所有轨道共用一把 key 时，只填 KEY 部分也行。解密引擎默认 MP4DECRYPT，报错了就--decryption-engine FFMPEG换 ffmpeg。AES 与 ChaCha20 的实现位于 解密模块源码，文件解密依赖外部工具；密钥多到不想手敲，用--key-text-file传一个文件、它按 KID 查 KEY；分片太大想省临时空间，加--mp4-real-time-decryption边下边解。

m3u8 批量下载脚本怎么写

前提：一堆链接要逐个处理、手动复制粘贴太慢，把它们一行一条存进 urls.txt。

i=1 while read -r url; do N_m3u8DL-RE "$url" --save-dir ./out --save-name "batch_$(printf '%03d' $i)" i=$((i+1)) done < urls.txt

跑完后 urls.txt 里每一行对应 ./out 下一个独立文件，互不覆盖。更稳妥的做法是把--save-name换成--save-pattern "<SaveName>_<Resolution>"，文件名自动带上区分变量，多条流清晰度不同时也不会撞名。

⚠️ 批量任务会长时间占满带宽，怕影响别的任务就加-R 15M限到 15 Mbps，单位也可以写成100K这种 Kbps。

下载速度慢的时候，调哪几个参数

线程数默认 10，带宽富余就加--thread-count 16，如果发现分片报错变多再往回调；每个分片默认重试 7 次（--download-retry-count），录直播建议提到 10。服务器响应慢导致频繁超时的，把--http-request-timeout适当调大（默认 100 秒），别给太大，否则卡死都发现不了。

路由和网络类的：--custom-proxy http://127.0.0.1:8888指定本地代理；代理通了分片却 403，多半是请求头缺登录态，用-H "Cookie: xxx"补上、可写多次，有浏览器导出的 Netscape 格式 Cookie 文件时直接--cookies cookies.txt更省事。只想要某一段分片时，--custom-range 05:00-20:00按时间段只取中间部分，配--skip-download跳过拉取、直接进合并。

⚠️--del-after-done保持默认开启，别关：它负责完成后清理临时文件，关了会慢慢堆满磁盘。临时盘太慢的话，用--tmp-dir指到一块快盘。

常见问题：按症状找原因，一条命令修掉

命令没输出→ 终端版本旧，不支持该程序的输出格式 → 换 PowerShell 等新终端运行，或先加--no-ansi-color去掉颜色。

分片全部 403→ 请求头没带登录态或被站点风控 → 用-H "Cookie: ..."、-H "User-Agent: ..."补齐，或--cookies cookies.txt整体导入。

下载完文件打不开→ 加密流没给密钥，或 KID:KEY 格式不对 → 核对两段十六进制后重新--key "KID:KEY"，工具本身报错时再--decryption-binary-path指全路径。

合并阶段报 ffmpeg 错误→ 混流、转字幕都依赖 ffmpeg，但系统里找不到它 → 安装 ffmpeg 并放进 PATH，或--ffmpeg-binary-path指定可执行文件全路径。

直播录到一半缺分片→ 列表刷新间隔太长或网络抖动后没重试回来 →--live-wait-time调小刷新间隔，--download-retry-count调大重试次数。

多流文件名互相覆盖→ 保存名完全相同 →--save-pattern "<SaveName>_<Resolution>_<Language>"让文件名带上区分变量。

适合什么场景，不适合什么场景

纯命令行工具，没有图形界面，也不具备绕过平台级强 DRM 的通用手段，它最适合"手里有链接、要批量、要解密合并"这类需求。下载任何内容之前，确认自己对该内容拥有合法权限，把用途限制在个人学习研究范围内。

【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE