N_m3u8DL-RE 下载速查：6 个高频任务命令 10 秒定位-平芜编程栈

N_m3u8DL-RE 下载速查：6 个高频任务命令 10 秒定位

【免费下载链接】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（HLS）、MPD（DASH）、ISM（MSS）三种格式，点播下载与直播录制都能覆盖，并内置 AES/ChaCha20 加密流解密。手里有流地址、只想直接拿到 N_m3u8DL-RE 下载命令的，看下面各节即可。

支持格式与能力覆盖

支持格式	核心能力	运行平台
M3U8 / HLS	点播下载、m3u8 直播录制、直播回看、AES-128 / ChaCha20 解密、多轨道选择	Windows / Linux / macOS（.NET 10 命令行程序）
MPD / DASH	点播下载、直播录制、多 Period 选段、多音轨多字幕	同上
ISM / MSS	点播下载、直播录制	同上

你的场景如果不在表内，可以直接放弃这篇速查；在的话，按任务往下找。

下载 m3u8 并输出为 mp4

下载并合并为 mp4

N_m3u8DL-RE "https://example.com/video.m3u8" --save-name "我的视频" --save-dir ./downloads -M format=mp4

第一个参数可以是 .m3u8 / .mpd / .ism 链接，也可以是本地保存的播放列表文件；--save-name指定输出文件名；--save-dir指定输出目录；-M format=mp4在全部下完后把分离的音视频混流成一个 mp4，混流器默认 ffmpeg。站点要求特定请求头时，追加-H "Cookie: sid=abc123"-H "User-Agent: iOS"逐个附加；Cookie 较多时改用--cookies cookies.txt读浏览器导出的文件。

按画质与语言选音轨

只下 4K，挑日语音轨与中文字幕

N_m3u8DL-RE "https://example.com/video.m3u8" -sv "res=3840*:for=best" -sa "lang=ja:for=best" -ss "name=中文:for=all"

-sv、-sa、-ss是视频、音频、字幕的正则选择器，res=匹配分辨率、lang=匹配语言、name=匹配名称；for=best表示多条命中时取最佳一条。不想逐条写选择器就加--auto-select，程序会对所有类型自动挑最佳轨道。

指定输出目录与容器格式

指定输出目录、临时目录并混流为 mkv

N_m3u8DL-RE "https://example.com/video.m3u8" --save-dir ./downloads --tmp-dir ./temp --sub-format SRT -M format=mkv

--save-dir决定成片落到哪；--tmp-dir指定临时文件目录，分片多、磁盘紧张时别让它占满系统盘；--sub-format SRT控制字幕输出格式，SRT 为默认，可换 VTT；-M format=mkv把容器换成 mkv，需要 mkvmerge 时写-M format=mkv:muxer=mkvmerge。

部分下载与限速

只下第 5 分钟到第 20 分钟

N_m3u8DL-RE "https://example.com/video.m3u8" --custom-range 05:00-20:00 --save-name "片段" --thread-count 4 --download-retry-count 5 -R 15M

--custom-range支持按分片序号或时间截取，时间格式为 MM:SS 或 HH:MM:SS，例如-99表示前 100 个分片、10-表示从第 10 个分片下到最后；--thread-count 4降低并发，网络波动大时比默认值 10 更稳；-R 15M限速 15Mbps（也支持 Kbps，如100K）。断线频发时把--download-retry-count调到 5~10。

录制直播不断流

录制一小时直播并实时合并

N_m3u8DL-RE "https://example.com/live.m3u8" --live-real-time-merge --live-record-limit 01:00:00 --live-wait-time 30 --save-name "直播回放"

📺--live-real-time-merge开启实时合并，录出来是完整文件而不是散片；--live-record-limit 01:00:00限定录制时长，不给则一直录到手动停止；--live-wait-time 30拉大播放列表刷新间隔，配合重试机制扛住短暂掉线。--live-pipe-mux是管道实时混流，对网络要求高，环境差时别开；想从某个历史时间点开始录，用--live-catchup "01:00:00"回看。

解密加密流

解密加密 m3u8 并输出成品

N_m3u8DL-RE "https://example.com/enc.m3u8" --key "9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d" --save-name "已解密" -M format=mp4

🔐--key的格式是KID:KEY，两者都是 32 位十六进制；整条流共用一个 KEY 时直接写--key KEY。密钥通常来自网页接口或从 manifest 提取（KID 有时就写在 MPD 里），密钥多的场景把文件传进去用--key-text-file keys.txt按 KID 自动查。解密默认走 mp4decrypt 引擎，没有该工具时用--decryption-engine FFMPEG切换。

参数速查

参数	作用	默认值	推荐场景值
`-H`/`--header`	附加 HTTP 请求头	无	缺登录态时补`Cookie`/`User-Agent`
`--cookies`	读 Netscape 格式 Cookie 文件	无	浏览器导出整份 Cookie
`-sv`/`-sa`/`-ss`	正则选择视频/音频/字幕	每类挑最佳	`best`、`res=3840*`、`lang=ja`
`--auto-select`	全类型自动选最佳轨道	False	不想手写选择器时
`-M`/`--mux-after-done`	完成后混流分离的音视频	不混流	`format=mp4`/`format=mkv`
`--save-dir`/`--tmp-dir`	输出目录 / 临时目录	当前目录 / 系统临时	`--tmp-dir`放空间大的盘
`--thread-count`	下载线程数	10	网络不稳时 4~8
`--download-retry-count`	分片失败重试次数	7	易断线时 5~10
`-R`/`--max-speed`	限速（Mbps 或 Kbps）	不限速	`15M`
`--custom-range`	只下载部分分片	全部	`05:00-20:00`、`-99`
`--live-record-limit`	直播录制时长上限	不限	`01:00:00`
`--live-real-time-merge`	直播实时合并	False	录制时开启
`--key`	解密密钥（KID:KEY 或单 KEY）	无	从接口或 manifest 提取
`--decryption-engine`	解密引擎	MP4DECRYPT	缺 mp4decrypt 时`FFMPEG`
`--save-pattern`	文件名模板	默认命名	`<SaveName>_<Resolution>`

排障：高频故障速查

现象：报无法解析 → 根因：地址实际是 HTML 页面或缺 Cookie/UA → 处理：curl -I "URL"确认返回的是播放列表，再补-H "Cookie: ..."重试
现象：下完的视频没有声音 → 根因：音轨未选中或未混流 → 处理：追加-sa "for=best" -M format=mp4重新下载
现象：下载慢、分片频繁中断 → 根因：并发过高、超时偏短 → 处理：--thread-count 4 --download-retry-count 7 --http-request-timeout 60
现象：解密后画面花屏或报错 → 根因：KID 不完整或密钥不匹配 → 处理：改用--key-text-file keys.txt让程序按 KID 自查
现象：新格式流解析失败 → 根因：程序版本过旧 → 处理：N_m3u8DL-RE --version核对版本，升级到最新构建再试