N_m3u8DL-RE 快速上手指南：8 条命令从装好到出片，覆盖 m3u8/DASH 下载、选轨、解密、直播录制-拓冰网站定制

N_m3u8DL-RE 快速上手指南：8 条命令从装好到出片，覆盖 m3u8/DASH 下载、选轨、解密、直播录制

【免费下载链接】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（DASH）或 ISM（MSS）链接，解析轨道、并发拉分片、解密、合并它都替你做完，产出的是能直接播放的完整文件。这篇教程带你从装好工具拿到第一个成片，再把常见场景一个个跑通，卡住时也知道往哪儿查。

你想做什么	跳去哪一节
装好并下出第一个文件	装好并验证环境
多码率多音轨流，只留要的那几轨	挑轨道、只下字幕怎么配
流是加密的，但手里有密钥	加密流配 key 解密
直播录够固定时长自动停	直播定时录制怎么设

如果你的需求只是本地格式转换、剪辑，或者手上只有直链文件，这工具帮不上你。

装好并验证环境

这一节的终点，是你手里多出一个能播放的视频文件。

按系统三选一，装完就验证，别急着下：

# Arch 及其衍生版 yay -Syu n-m3u8dl-re-bin

Windows 去项目 Releases 页拿对应平台的压缩包，解压后直接跑N_m3u8DL-RE.exe。想从源码自己构建的：

git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE && dotnet build

装完先确认环境没问题：

N_m3u8DL-RE --version N_m3u8DL-RE --help

版本号和一整套参数列表都能完整打印，安装才算到位；报错就先修安装，后面别急着做。

环境通了，跑第一条下载。我从官方测试流清单里挑了一条无加密、多音轨多字幕的流：

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

看到什么算对：分片下完，输出目录生成一个合并视频，点开能播，旁边还会多一份同名.json（解析信息，可删）。没拿到文件，闭环就不算走完，回到上面重来。

只给链接，拿整个文件

这一节做完，凡是"给我一个链接、我要文件"的活儿，都不用再加参数。

场景：流里有几档清晰度、几路音轨，我都不挑，整个存下来就行。

N_m3u8DL-RE "你的视频链接" --save-dir ./videos

参数	作用
不加任何选轨参数	自动挑最佳视频、音频、字幕轨，完成后自动合并
`--auto-select`	强制为所有类型选最佳轨，轨道拿不准时加
`--save-dir`	指定输出目录，缺省是当前位置

成功长什么样：输出目录里的合并文件点开能播，临时分片没残留。

挑轨道、只下字幕怎么配

读完这节，你再不用盯着八档码率全下，只要哪路拿哪路。

场景："流里有 8 档码率、3 路音轨、2 套字幕，我只要 4K + 英语音 + 中文字幕。"

N_m3u8DL-RE "视频链接" -sv 'res="3840*":codecs=hvc1:for=best' -sa 'lang=en:for=best' -ss 'lang=zh:for=all'

参数	作用
`-sv`	筛视频轨：3840 宽度（4K）且 HEVC 编码
`-sa`	筛音轨：只要英语
`-ss`	筛字幕轨：中文的全要
`for=best`/`for=all`	best 取最匹配的一条，all 匹配全拿

正则写不出来就先挂--auto-select让程序代选。只想要字幕、音视频一律不拉的，命令更短：

N_m3u8DL-RE "https://devstreaming-cdn.apple.com/videos/streaming/examples/bipbop_adv_example_hevc/master.m3u8" --sub-only --sub-format SRT

参数	作用
`--sub-only`	只挑字幕轨，音视频完全跳过
`--sub-format SRT`	输出 SRT（可换 VTT），时间轴自动修正默认开启

成功长什么样：输出目录里出现.srt，挂进播放器对一下时间点能对上。

加密流配 key 解密

过了这一节，带 DRM 的流不再卡你，差的可能就是一把密钥。

场景："流是加密的，KID 和 KEY 我都有，想解密存下来。"

N_m3u8DL-RE "https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd" --key "9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d"

参数	作用
`--key KID:KEY`	冒号前是密钥 ID，冒号后是密钥本体；多组密钥就传多个`--key`
`--decryption-engine FFMPEG`	默认引擎失败时换 ffmpeg 引擎

成功长什么样：解密合并后的文件能正常播放，不花屏、不静音。

直播定时录制怎么设

这一节之后，程序自己掐点录、录满自己停，你不用守屏。

场景："直播要开两小时，录够就停，别让我一直挂着。"

N_m3u8DL-RE "直播链接" --live-perform-as-vod --live-record-limit 02:00:00 --save-name live

参数	作用
`--live-perform-as-vod`	按点播逻辑处理直播流
`--live-record-limit`	格式`HH:mm:ss`，录满即停
`--live-real-time-merge`	可选，边录边拼出完整文件

成功长什么样：到设定时长程序自行退出，输出目录里是一份完整录像。

机制速查：选轨、解密、合并

把三张表看完，任意参数组合你自己能拼出来；完整参数列表在 README 里。

选轨的for取值（-sv/-sa/-ss通用）：

取值	行为
`best`（默认）	只留最匹配的一条
`best2`	留最匹配的两条
`all`	匹配的全留
`worst`	留最弱的一条，测试对比用

前面的res、codecs、lang、ch都是正则，|表示"或"，例如lang="ja|en"匹配日语或英语。完整规则跑N_m3u8DL-RE --morehelp select-video看。

三种解密引擎选其一：

引擎	调用的工具	什么时候选
`MP4DECRYPT`（默认）	mp4decrypt	速度最快
`FFMPEG`	ffmpeg	兼容性最好，手头有 ffmpeg 就选它
`SHAKA_PACKAGER`	shaka-packager	功能最全

选哪个就把哪个放进 PATH，或者用--decryption-binary-path/--ffmpeg-binary-path指全路径。

三种合并方式：

方式	原理	什么时候用
默认	调 ffmpeg 合并，产出可直接播放的文件	标准情况
`--binary-merge`	纯二进制拼接，不依赖 ffmpeg	fMP4/CMAF 分片
`--skip-merge`	完全不合并，只留分片	想留分片备份

分离的音视频想混进指定容器，再加-M format=mp4或-M format=mkv:muxer=mkvmerge。

下载卡住怎么排查

动手改参数前，先跑一遍N_m3u8DL-RE --version确认是最新版，不少坑新版已经修了。

现象	大概率原因	一行修复
分片反复失败，任务卡住	网络不稳，或默认 100 秒超时太短	`--download-retry-count 5 --http-request-timeout 300`
解密失败，或文件下完打不开	只填了密钥，漏了 KID	`--key KID:KEY`；仍不行加`--decryption-engine FFMPEG`
合并阶段提示找不到 ffmpeg	ffmpeg 没装或不在 PATH	`--ffmpeg-binary-path "全路径"`；绕开用`--binary-merge`
速度慢，任务拖很久	线程开太多互相挤	`--thread-count 4 --http-request-timeout 300`
老版本 Windows 终端无响应或乱码	旧终端不支持本程序	换 cmder 运行

收尾

先跑测试流：从 TestStreams.md 挑一条无加密多轨流跑通首条命令，安装和环境一次验完。
再学选轨：跑一遍N_m3u8DL-RE --morehelp select-video，把-sv/-sa/-ss的精细规则吃透，别再全靠--auto-select代选。
卡住先查表：对照排障表按现象定位，八成问题不用翻源码。

最后一句底线：只下载你拥有合法权限的内容。

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

资讯详情

N_m3u8DL-RE 快速上手指南：8 条命令从装好到出片，覆盖 m3u8/DASH 下载、选轨、解密、直播录制