N_m3u8DL-RE m3u8 下载完整教程7 个命令从安装跑通到直播定时录制【免费下载链接】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 下载工具同时支持 MPDDASH、m3u8HLS和 ISMMSS三种清单。你把链接丢给它它替你做完解析轨道、多线程拉分片、解密和合并这些脏活产出能直接放进播放器的完整媒体文件。需要把点播流存成文件、或者录一段固定时长的直播这篇就是你的操作手册只是想下单个 mp4 直链的人可以关掉了。跑通安装、验证、下第一条流按平台装一种即可。Arch 及其衍生版有 AUR 包该源非作者维护# Arch Linux 及其衍生版安装稳定版 yay -Syu n-m3u8dl-re-bin # 想尝鲜开发版用这个 yay -Syu n-m3u8dl-re-gitWindows 没有包管理器捷径到项目 Releases 页拿对应平台的压缩包解压后直接运行里面的N_m3u8DL-RE.exe。老版本 Windows 自带终端跑不动本程序遇到无响应或乱码就换 cmder 执行。想从源码构建的话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判定标准很具体--version打印出形如N_m3u8DL-RE (Beta version) 20251027的版本号--help完整列出--save-dir、--key这类全部参数。两条都能正常打印才算装对打印不出来先解决安装问题别往下走。验证通过就跑第一条真实下载。我从官方测试流清单 TestStreams.md 里挑了一条无加密、多音轨多字幕的流N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-name demo✅ 成功信号终端里分片进度走完输出目录出现合并好的媒体文件旁边还有一份同名.json解析信息--write-meta-json默认开启可留可删。只给链接零配置存下完整文件你卡在哪手上只有一个链接想拿到整个视频不想研究任何参数。N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd参数作用无自动为视频、音频、字幕各挑一条最佳轨完成后自动合并--auto-select显式强制为所有类型选最佳轨拿不准轨道时加它更稳✅ 判定输出目录里的合并文件双击能播画面声音俱全。文件名冲突时程序会用流的分辨率、带宽等元数据自动生成唯一文件名不会简单加.copy后缀。多码率流只留 4K 和指定语言的轨你卡在哪流里码率从 240p 排到 4K音频还有七八种语言全下下来浪费带宽只想要4K 视频 英语音频。N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd -sv res1920*:forbest -sa langen:forbest -ss forall这条命令里-sv res3840*:codecshvc1就是4K 且 HEVC 编码的写法官方示例原文上面换成1920*是为了让你在这条 1080p 测试流上能直接跑通条件语法完全一样。参数作用-sv用正则筛视频轨条件可组合res、codecs、lang、ch等-sa筛音轨langen即只要英语-ss筛字幕轨forbest/forallbest 只取最匹配的一条all 把匹配的留下✅ 判定输出目录里只出现你命中的轨道对应文件筛不中的码率压根不发请求——带宽就省在这一步。正则写不出来就先加--auto-select让程序代选。只下字幕并指定 SRT 格式你卡在哪视频不用重新下只想把 m3u8 里的字幕抠出来转成播放器通用的 SRT。N_m3u8DL-RE https://devstreaming-cdn.apple.com/videos/streaming/examples/bipbop_adv_example_hevc/master.m3u8 --sub-only --sub-format SRT这条用的是官方清单里的高级 HLSfMP4 VTT示例流。参数作用--sub-only只选取字幕轨道音视频完全不拉--sub-format SRT字幕输出类型可选SRT默认或VTT--auto-subtitle-fix时间轴修正默认 True一般不用动✅ 判定输出目录出现.srt文件挂到播放器里对一下台词时间点不整体偏移就算成功。只要中间一段按时间裁剪下载你卡在哪两小时的片子只关心其中 15 分钟不想下完整片再剪。N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --custom-range 05:00-20:00--custom-range的四种写法摘自--morehelp custom-range写法含义05:00-20:00时间段第 5 分钟到第 20 分钟的内容0-10分片序号下[0,10]共 11 个分片-99前 100 个分片10-从第 10 个分片开始往后的全部✅ 判定下载比完整片快得多产出的文件放进播放器看时长应只有约 15 分钟。加密流如何配 key 解密保存你卡在哪流是 CENC 加密的下完是一堆打不开的二进制需要把密钥配进去。N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d这条测试流的 KID:KEY 组合来自 TestStreams.md 里的官方标注可直接复制。参数作用--key KID:KEY冒号前是密钥 ID冒号后是密钥本体多组密钥就传多个--key所有轨共用一个 KEY 时也可只写--key KEY--decryption-engine FFMPEG解密引擎默认MP4DECRYPT失败时可换FFMPEG或SHAKA_PACKAGER--decryption-binary-path指定 mp4decrypt 全路径不在 PATH 里时用✅ 判定解密合并后的文件能正常播放不花屏、不静音。如果你的流是 HLS AES 加密对应的是另一组参数--custom-hls-method指定加密方式如AES_128加--custom-hls-key/--custom-hls-iv接受文件、HEX 或 Base64。直播流录制固定时长后自动停你卡在哪想把直播录一段时间就自动收尾不想人守着。N_m3u8DL-RE https://cmafref.akamaized.net/cmaf/live-ull/2006350/akambr/out.mpd --live-perform-as-vod --live-record-limit 00:30:00 --save-name live第一条链接是官方清单里的 CMAF 直播示例。参数作用--live-perform-as-vod按点播逻辑处理直播流--live-record-limit录制时长上限格式HH:mm:ss录满即停--live-real-time-merge可选边录边拼成完整文件--live-pipe-mux可选通过管道 ffmpeg 实时混流到 TS 文件README 明确提示网络不稳时别开管道读数据容易丢帧✅ 判定到设定时长后程序自行退出输出目录里是一个完整的直播录像文件。批量下载一份链接清单你卡在哪手里有一份地址清单想挨个下完并统一落到一个目录。存成batch.sh执行#!/bin/bash URLS( https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8 ) mkdir -p ./videos for url in ${URLS[]}; do N_m3u8DL-RE $url --save-dir ./videos --auto-select --thread-count 8 done两个链接都出自官方测试流清单一个无加密 MPD一个 HLS AES 加密流顺手把解密链路也验了。参数作用--save-dir输出目录统一收敛产物--auto-select每条流自动选最佳轨--thread-count下载线程数默认是本机 CPU 线程数✅ 判定./videos里两条流各自的合并文件都齐了。想给多个同类轨道避免重名还可以加--save-pattern SaveName_Resolution之类的命名模板。核心机制速查三张表记住参数就不用再翻文档了完整列表在 README.md。轨道选择规则-sv/-sa/-ss通用-dv/-da/-ds是反向剔除for 取值行为best默认只留最匹配的一条best2留最匹配的两条如-sa langja\|en:forbest2all匹配的全留worst留最弱的一条测试对比用res、codecs、lang、ch等条件都是正则\|表示或例如langja\|en匹配日语或英语。三种解密引擎引擎调用的工具怎么选MP4DECRYPT默认mp4decrypt速度最快默认就用FFMPEGffmpeg兼容性最好手头有 ffmpeg 最省事SHAKA_PACKAGERshaka-packager功能最全工具放 PATH 里即可或用--decryption-binary-path/--ffmpeg-binary-path指全路径。三种合并方式方式原理何时用默认调 ffmpeg 合并标准情况--binary-merge纯二进制拼接不依赖 ffmpegfMP4/CMAF 分片--skip-merge不合并只留分片想留分片备份分离的音视频想混进指定容器追加-M formatmp4或-M formatmkv:muxermkvmerge详情跑--morehelp mux-after-done看。排障现象对应修复分片反复失败、任务卡住——多半是网络不稳或默认 100 秒超时不够直接加参数重跑N_m3u8DL-RE 链接 --download-retry-count 5 --http-request-timeout 300解密失败或文件下完打不开——先检查--key是不是完整KID:KEY格式只填 KEY 时仅限所有轨共用同一密钥的场景仍不行就换引擎N_m3u8DL-RE 链接 --key KID:KEY --decryption-engine FFMPEG合并阶段提示找不到 ffmpeg——指全路径或者干脆绕开 ffmpegN_m3u8DL-RE 链接 --ffmpeg-binary-path C:\Tools\ffmpeg.exe # 或者 N_m3u8DL-RE 链接 --binary-merge下载速度上不去——线程开太多互相挤调低--thread-count同时把--http-request-timeout加大。老版本 Windows 终端无响应或乱码——旧终端不支持本程序换 cmder 运行。动手修之前先N_m3u8DL-RE --version确认版本很多坑新版已经修了。收尾下一步清单拿 TestStreams.md 里第一条无加密流把上面的验证命令完整跑一遍安装、网络、解密链路一次验完跑通后执行N_m3u8DL-RE --morehelp select-video把-sv/-sa/-ss的完整条件学一遍之后就不用一直靠--auto-select代选卡住先对照排障一节逐条执行修复命令仍无解再带着--version结果去项目 Issues 查同类问题。本项目基于 MIT License 开源仅限学习和技术研究用途只下载你拥有合法权限的流媒体内容一切法律后果由使用者自行承担。【免费下载链接】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），仅供参考