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-REM3U8 下载完是一堆分片、MPD 拿到手却加密打不开、多档画质不知道该留哪条——这三个痛点基本就是 N_m3u8DL-RE 的全部用武之地。它是一个跨平台的流媒体下载器M3U8、MPD、ISM 三种格式点播、直播、加密流都归一条命令行处理混流和解密也都内置。怎么跑起来.NET 10 下的三步验证环境只有一个硬要求本机装好 .NET 10 SDK。整个过程分三步克隆仓库并编译发布产物落在 publish 目录git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet publish src/N_m3u8DL-RE/N_m3u8DL-RE.csproj -c Release运行版本号验证输出带日期版本号的一行即编译成功src/N_m3u8DL-RE/bin/Release/net10.0/publish/N_m3u8DL-RE --version把 publish 目录下的可执行文件改名、加入 PATH后续示例里直接敲N_m3u8DL-RE即可。老版本 Windows 的默认终端可能跑不了它这不是程序的问题换 cmder 之类的终端再试即可其余平台行为一致。M3U8 与 MPD 下载的四个场景实战没有现成素材的话仓库自带的 TestStreams.md 列了一批公开测试流覆盖多音轨、直播、加密等类型可以直接拿链接替换下面示例里的 example.com 练手。点播视频下载完直接得到可播放 mp4【场景】拿到一条 m3u8 点播链接目标是产出一个双击就能播的单文件 mp4。这条命令下载全部选中轨道结束后自动做混流把分离下载的音视频拼进同一个可播放文件N_m3u8DL-RE https://example.com/vod/index.m3u8 \ -M formatmp4 \ --save-name demo \ --save-dir ./out参数速查-M即--mux-after-done指定混流的目标容器把formatmp4换成formatmkv就是 mkv 输出--save-name和--save-dir分别控制文件名与输出目录。选流只留最高画质和英文音轨【场景】源里有多档分辨率、多条音轨只想各留一条最优的。-sv、-sa按正则挑选视频流和音频流N_m3u8DL-RE https://example.com/vod/master.m3u8 \ -sv best \ -sa langen:forbest \ --save-name hq参数速查best表示每种语言保留分辨率最高的一条想锁定 1080p 写-sv res1920*音轨想全留写-sa all。直播录制边播边存录满 30 分钟即停【场景】正在播的直播要存下来文件边录边合并到点自动收工。--live-real-time-merge开启实时合并--live-record-limit是录制时长上限N_m3u8DL-RE https://example.com/live.m3u8 \ --live-real-time-merge \ --live-record-limit 00:30:00 \ --save-name live-rec⚠️ 参数速查网络不稳时别加--live-pipe-mux管道混流丢帧概率更高刷新间隔想固定就写--live-wait-time 10即每 10 秒拉一次播放列表。加密流KID:KEY 一步解密【场景】流是 CENC 或 AES 加密的CENC 是 MP4 里常见的 DRM 加密方案原始分片直接放打不开必须喂密钥。--key接收KID:KEY格式——KID 是密钥 ID、KEY 是密钥本体KID 在前多条密钥就写多个--keyN_m3u8DL-RE https://example.com/enc/index.m3u8 \ --key 0123456789abcdef0123456789abcdef:89abcdef0123456789abcdef01234567 \ --decryption-engine MP4DECRYPT \ -M formatmp4参数速查--decryption-engine选择实际执行解密的第三方程序默认 MP4DECRYPT卡住时换成FFMPEG再试一次。调优速查6 个直接影响速度与稳定的参数默认值开箱可用10 线程、每分片重试 7 次、超时 100 秒出现下面的情况再动表里的项参数推荐值什么时候用--thread-count168~32 区间带宽富裕且多核机器提速主力默认 10--download-retry-count8网络不稳、频繁断连默认 7--http-request-timeout60频繁断连时缩短超时失败更快触发重试默认 100-R15M限速 15Mbps避免下载占满带宽--custom-range05:00-20:00只要第 5 到 20 分钟的内容其余不下载--live-wait-time10直播列表刷新间隔固定为 10 秒报错速查四类高频问题对照着改动手排查前先用 curl 确认链接返回的真是 m3u8/mpd 清单而不是 HTML 页面很多解析失败本质是请求头没给对N_m3u8DL-RE https://example.com/vod/index.m3u8 \ -H Referer: https://example.com \ -H User-Agent: Mozilla/5.0症状大概率原因一句话解法提示无法解析 URL、拿到的是网页链接需要特定 Referer 或 Cookie补-H请求头或用--cookies cookies.txt给 Netscape 格式 Cookie 文件文件下完但打不开、花屏加密流没解密或 KID:KEY 写反了确认 KID 在前再换--decryption-engine FFMPEG试下载中途频繁超时、断连网络抖动、重试次数不够--download-retry-count 8 --thread-count 4有代理就加--custom-proxy http://127.0.0.1:7890混流阶段提示找不到 ffmpegffmpeg 没装或不在 PATH--ffmpeg-binary-path指向全路径例如 /usr/local/bin/ffmpegffmpeg 路径问题的完整写法N_m3u8DL-RE https://example.com/vod/index.m3u8 \ --ffmpeg-binary-path /usr/local/bin/ffmpeg \ -M formatmp4收尾日常最高频的就是这四个-sv/-sa选流、-M混流、--key给解密密钥、--thread-count与--download-retry-count控速度和稳定其余参数用到时再查 README.md 的命令行章节即可。【免费下载链接】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），仅供参考