N_m3u8DL-RE 从 0 到 1DASH/HLS 流媒体下载的完整配方、参数清单与故障排查【免费下载链接】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 是一款跨平台的 DASH/HLS/MSS 流媒体下载工具面向想把在线课程存档、想录直播、想管理多音轨字幕的你。DASH清单文件是 mpd和 HLS清单文件是 m3u8是两种最常见的流媒体协议你把链接丢给它它负责解析出视频、音频、字幕轨道拉完分片再合并成成品文件。本文按四步讲五分钟跑通、三个需求的参数配方、参数速查表、出问题怎么查。五分钟跑通拿到工具跑通第一单工具从官方发布渠道下载对应平台的发行版或者克隆源码自己构建git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE代码基于 .NET系统里要有对应平台的 .NET 运行时。拿到可执行文件后最小化命令就是链接 输出名下面这条同时拿项目 TestStreams.md 里的公开测试流验证安装N_m3u8DL-RE http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8 --save-name demo跑完输出目录里出现合并好的成品说明解析、下载、合并三环节都正常。--save-name决定输出文件的基础名不改的话程序会按自己的规则起名。还有个省事技巧只想看解析出哪些轨道、不实际下载就在同一条命令上加--skip-download程序解析完清单就停适合先摸清一个陌生链接里有什么再决定怎么下。命令跑通只是第一步接下来下载什么、下载成什么样全由参数决定。按三个真实需求来配点播挑画质、直播定时录、加密流喂密钥。三个真实需求的参数配方点播挑轨、直播定时、加密解密点播保存一次挑两档画质文件不打架你想达到的效果一个课程 m3u8 里同时挂着 1080p 和 720p两档都要且文件名能区分。N_m3u8DL-RE 课程m3u8链接 -sv res1920*|1280*:forall -sa best --save-name 实战课 --save-pattern SaveName_Resolution -M formatmp4-sv res1920*|1280*:forall按分辨率正则把两档画质都选中forall表示匹配的全部要不带它时默认 best 只挑一条最好的。-sa best音频轨自动挑最佳不用你判断哪条码率高。--save-name 实战课输出基础名。--save-pattern SaveName_Resolution文件名追加分辨率变量两档文件各叫各的不写它同类型多轨道容易撞名。-M formatmp4所有工作完成时把分离的音视频混流进 mp4 容器拿到手就是能直接播放的成品。挑完轨下一个需求是时间直播往往不在你现在这个点想按表开播再录怎么配直播定时录制到点开播录够就收你想达到的效果晚八点的大会九点准时开始录录满两小时自动结束不用人盯着。N_m3u8DL-RE 直播链接 --save-name 技术大会 --live-real-time-merge --task-start-at 20260921090000 --live-record-limit 02:00:00 --thread-count 8--task-start-at 20260921090000到这个时间yyyyMMddHHmmss 十六位之前不开始执行任务是定时录制的开关马上录就不用它。--live-record-limit 02:00:00录满两小时自动收尾格式 HH:mm:ss。--live-real-time-merge分片下载时实时合并进成品文件默认是关的不加则等录完再统一合并。--thread-count 8显式指定 8 个拉分片线程不调则按本机 CPU 线程数走。这里有个风险点要提醒想进一步省盘可以换--live-pipe-mux通过管道加 ffmpeg 实时混流进 TS 文件但项目 README 明确说网络不稳时别开它管道数据由 ffmpeg 读容易丢直播数据。默认情况下--live-keep-segments会保留分片等于留了份备份丢数据还能重拼建议别动它。定时和画质都解决了最后一种麻烦是链接本身是加密的怎么把密钥递进去加密流解密喂对密钥边下边解你想达到的效果清单里标着需要密钥的加密流下载的同时就解密不二次返工。N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d -sv best --mp4-real-time-decryption--key KID:KEYKID 是密钥标识KEY 是密钥本体都是十六进制串上面这条是项目 TestStreams.md 里自带密钥的测试流密钥就在文档同一行抄下来就能跑通解密全流程。多个 KID 对应不同密钥时重复传--key若所有 KID 共用一把密钥只写 KEY 也行。-sv best只取最佳视频轨音频轨用-sa同理追加。--mp4-real-time-decryptionMP4 分片边下边解默认关着不加它解密就落在下载完成后由 mp4decrypt 等第三方工具统一批处理。三条配方下来用上的参数不到十个剩下的按动手频率分三档用哪档查哪档。参数速查每次必写、看情况调、知道有就行必备档每次都要写参数作用什么时候需要动它--save-name输出文件基础名每次都要不改则由程序自动命名--save-dir输出目录不想落在当前目录时-sv/-sa/-ss正则挑视频、音频、字幕轨或写 best/all多轨道流必须收一收否则全下--key解密密钥KID:KEY 或纯 KEY流是加密的才用常调档看环境定参数作用什么时候需要动它--thread-count下载线程数默认 CPU 线程数嫌慢就调大--http-request-timeout单次 HTTP 超时秒数弱网频繁超时默认 100 秒--download-retry-count单分片异常重试次数网络抖动多时加预算默认 3 次--custom-proxy指定请求代理目标站必须走代理默认用系统代理-R限速单位 Mbps 或 Kbps如 15M、100K不想占满带宽时--sub-format字幕输出为 SRT通用字幕格式或 VTTWeb 字幕格式想换字幕类型默认 SRT-M完成时混流分离的音视频要 mp4/mkv 成品而非散文件少碰档不报错就别动参数作用什么时候需要动它--decryption-engine选解密用的第三方程序默认 MP4DECRYPT 不够时换 FFMPEG 或 SHAKA_PACKAGER--mp4-real-time-decryptionMP4 分片实时解密想免掉下载后的二次解密--live-pipe-mux管道加 ffmpeg 实时混流进 TS想省盘但弱网下有丢数据风险--log-level日志级别排查时开 DEBUG 看细节默认 INFO--no-ansi-color关闭终端彩色输出颜色显示乱码时--append-url-params把输入链接的参数带到分片上个别站点如 kakao.com不带上就 403参数都对了真跑起来也可能翻车。别翻长文档对着症状找行就行。出问题了怎么办下载慢、解密失败、音画分离先查什么症状先查什么对应参数动作下载慢是不是线程太少或请求一直在超时长调大--thread-count日志里超时重试多就把--http-request-timeout调大并给--download-retry-count加预算解密失败密钥格式对不对解密程序在不在 PATH核对--key是否 KID:KEY 格式程序找不到就用--decryption-binary-path指全路径或--decryption-engine FFMPEG换引擎HLS 加密方式判错时加--custom-hls-method如 AES_128、CHACHA20、SAMPLE_AES手动指定老 Windows 终端报错或颜色乱码系统终端不支持本程序换 cmder 跑乱码就加--no-ansi-colorArch 系发行版可走 AUR 的 n-m3u8dl-re-bin音画分成两个文件完成时没指定混流加-M formatmp4或-M formatmkv:muxermkvmerge想引入外部字幕或音轨用--mux-import pathxx.srt:langchi:name中文字幕每个参数想深入了解语法运行--morehelp 参数名在程序内直接看比如--morehelp select-video会把正则挑选的完整写法列给你。读源码比读博客更靠谱按数据流走三处就够。解析入口是src/N_m3u8DL-RE.Parser/StreamExtractor.cs同目录Extractor/放着 DASH、HLS、MSS 各自解析器Processor/管内容地址和密钥处理。任务调度在src/N_m3u8DL-RE/DownloadManager/点播走 SimpleDownloadManager直播录制走 SimpleLiveRecordManager2真正的多线程拉分片在Downloader/SimpleDownloader.cs。命令行参数如何变成运行配置看CommandLine/加Config/里的 DownloaderConfig。边界问题必须说清本工具基于MIT 协议开源仅限学习与技术研究只下载你拥有合法权限的流媒体内容遵守所在地区法律法规与平台服务条款侵权后果与工具无关。三步自检清单用 TestStreams.md 里的测试流加--skip-download跑一遍轨道列表正常打出安装就没问题。拿真实链接只带--save-name做最小化下载成品落在输出目录才算跑通。卡住时按速查表 → 排查表的顺序加参数慢查线程和超时解密失败查密钥格式和引擎。三步走完N_m3u8DL-RE 就已经是你手边的日常工具了。【免费下载链接】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），仅供参考
