N_m3u8DL-RE 使用教程从安装到完成流媒体下载只需 4 步【免费下载链接】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 流媒体下载器适合需要课程离线下载、直播录制、管理多音轨字幕的用户。全文按任务推进先装好并验证再跑通第一次下载然后按场景配参数最后教你自己排查问题。01 动手前的准备环境与安装这一节让你确认系统满足要求并在 10 分钟内拿到可运行的程序。程序覆盖Windows、Linux、macOS三个平台。直接从官方发布渠道下载对应平台的发行版即可使用——官方发布构建采用 AOT 静态编译一般无需额外安装 .NET 运行时。如果你要自行构建源码项目 目标框架为.NET 10各csproj中TargetFramework为net10.0需要先安装 .NET 10 SDKgit clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE/src dotnet build N_m3u8DL-RE.slnArch Linux 系可从 AUR 安装n-m3u8dl-re-bin。安装是否成功用版本命令验证N_m3u8DL-RE --version N_m3u8DL-RE --help能打印出版本号和完整参数列表说明安装正常--help的输出本身就是一份官方参数手册后文会用到的参数都可以在这里找到。02 首战5 分钟跑通最小任务这一节给你一条可运行的最小命令外加一个不实际下载文件的干跑技巧。最小下载只需要一个链接加一个文件名N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-name test这个链接来自仓库的 TestStreams.md是一条公开的多音轨多字幕 mpd 测试流适合本地复现问题。程序会先解析清单、打印出所有可选的视频、音频、字幕轨道再按本机 CPU 线程数并发拉取分片分片异常默认自动重试 3 次最后合并输出。干跑验证只想看解析出的轨道、不想真下载时加--skip-download跳过下载步骤N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-name test --skip-download这是排查轨道选不准类问题的第一步先确认程序看到了什么再决定怎么选。03 实战场景最常用的三种用法这一节覆盖点播、直播、加密流三个高频需求每个场景给出可直接套用的命令。3.1 保存在线课程只要最高画质需求拿到一个 m3u8 链接想要一个成品 mp4不想手动分辨哪条轨是 1080p。N_m3u8DL-RE 课程m3u8链接 --save-name Python实战课程 --auto-select -M formatmp4关键参数--auto-select为所有类型自动挑选最佳轨道免去手写正则-M formatmp4所有分片下载完成后调用 ffmpeg 把分离的音视频混流为 mp4 容器--save-name指定成品文件名输出目录默认为当前目录可用--save-dir另指。预期结果得到单个Python实战课程.mp4而非一堆分离的 m4s/m4a 片段。3.2 录制直播边录边合并需求输入直播 m3u8 或 mpd 链接希望文件边下边成型且录满 3 小时自动停。N_m3u8DL-RE 直播链接 --save-name 技术大会 --live-real-time-merge --live-record-limit 03:00:00 --thread-count 8关键参数--live-real-time-merge分片下载时实时合并进成品文件录到一半也能播放已录部分--live-record-limit 03:00:00HH:mm:ss格式的时长上限到点自动结束--thread-count 8显式指定 8 个下载线程默认值是本机 CPU 线程数网络好时可调大。预期结果3 小时后自动停止并输出成品。注意默认的--live-keep-segments保留分片不要关网络波动丢数据时还能靠分片重拼。3.3 下载加密流并指定音画质量需求平台提供了KID:KEY格式的密钥希望挑最佳视频轨和音频轨字幕转成通用格式。N_m3u8DL-RE 加密流链接 --key KID值:KEY值 -sv best -sa best --sub-format SRT关键参数--key接受KID1:KEY1或纯KEY多组密钥就重复传参解密默认交给 mp4decrypt 完成-sv best/-sa best轨道选择参数支持正则与forbest等命名值组合完整语法可运行--morehelp select-video在程序内查看--sub-format SRT字幕输出为 SRT另一选项是VTT默认即 SRT。预期结果解密后的音视频 SRT 字幕文件。若流本身还有加密方式问题见 05 节解密条目。04 参数速查一张表配好你的任务这一节把常用参数按用途分组遇到具体任务先查表再回 README 核对细节。分组参数适用情况输出--save-name/--save-dir指定成品文件名与保存目录输出--save-pattern SaveName_Resolution一次下多条同类型流按分辨率等变量避免重名输出-M formatmp4或formatmkv:muxermkvmerge完成后把分离音视频混流为指定容器输出--sub-format SRT字幕转通用格式选择--auto-select不想手动挑轨选择-sv best、-sa langen:forbest按分辨率、语言、编码正则精确挑轨选择-ss all配--sub-only只取字幕网络--thread-count按带宽调并发默认 CPU 线程数网络--http-request-timeout 60弱网调超时默认 100 秒网络--custom-proxy http://127.0.0.1:8888需走指定代理默认走系统代理网络-R 15M限制下载速度加密--key KID:KEY流需要外部密钥加密--decryption-engine FFMPEG在 MP4DECRYPT、FFMPEG、SHAKA_PACKAGER 间切换解密程序直播--live-real-time-merge/--live-record-limit实时合并与限时长录制诊断--log-level DEBUG出问题看详细日志诊断--skip-download只看解析结果不下载高级语法自查N_m3u8DL-RE --morehelp mux-after-done、--morehelp select-video、--morehelp custom-range等可查任意选项的分隔符式完整语法。05 避坑清单症状 → 原因 → 解法这一节把最常见的四类故障整理成速查表对号入座即可。症状可能原因解法下载慢、频繁超时重试线程数偏低弱网下 100 秒超时仍不够调大--thread-count调大--http-request-timeout给--download-retry-count默认 3加预算需要代理时加--custom-proxy解密失败或花屏密钥格式不对应为KID:KEY多组重复传参默认 mp4decrypt 缺失或不匹配核对--key格式换--decryption-engine FFMPEG或SHAKA_PACKAGER确认对应程序在 PATH 中或用--decryption-binary-path指定全路径HLS 加密方式判断错误时用--custom-hls-method如AES_128、CHACHA20、SAMPLE_AES手动指定平台兼容问题旧版 Windows 自带终端不支持改用 cmder 执行macOS 若自构建需先装 .NET 运行时终端颜色异常用--no-ansi-color关闭彩色输出音视频不在一起、想合并下载的是分离的音视频轨-M formatmp4混流需引入外部字幕或音轨时用--mux-import path...:lang...:name...语法见--morehelp mux-import另外录制直播想零延迟混流时可用--live-pipe-mux但 README 明确提醒管道读数据由 ffmpeg 负责网络不稳时容易丢直播数据弱网环境不建议开启。06 底层视角它内部是一条什么流水线这一节用一句话建立全局心智模型按数据流定位问题环节就能快速缩小排查范围。整条流水线是解析清单 → 并发下载分片 → 解密如需→ 合并混流输出。对应源码目录解析入口在 src/N_m3u8DL-RE.Parser/StreamExtractor.cs它根据清单内容自动识别 m3u8/mpd/ism 并分发给Extractor/下各自的解析器任务调度在 src/N_m3u8DL-RE/DownloadManager/多线程拉片由SimpleDownloader.cs执行解密逻辑在 src/N_m3u8DL-RE/Crypto/合并混流由 src/N_m3u8DL-RE/Util/MergeUtil.cs 等完成。所以排查时先看报错出在哪一环轨道识别错查解析--skip-download看解析输出、--log-level DEBUG分片拉不到查网络超时、重试、代理花屏查解密引擎与密钥文件拆散查混流-M。07 边界与下一步这一节说明使用边界并给你一条可立即执行的动作。合规边界本工具基于MIT License开源见 LICENSE仅用于学习和技术研究。请只下载你拥有合法权限的内容遵守所在地区法律法规与平台服务条款任何侵权用途后果自负。想深入源码建议沿数据流读入口StreamExtractor.cs→ src/N_m3u8DL-RE/DownloadManager/ 看调度 → src/N_m3u8DL-RE/Config/ 看命令行参数如何映射到运行配置。功能验证可跑 src/N_m3u8DL-RE.Tests/ 里的解析器与工具类测试dotnet test各格式的公开测试流清单在 TestStreams.md。下一步现在就用 02 节那条--skip-download命令跑通安装验证确认轨道列表正确后去掉该参数完成你的第一次真实下载再把常用参数组合成自己的速查清单按场景直接套用。【免费下载链接】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），仅供参考 N_m3u8DL-RE 使用教程：从安装到完成流媒体下载只需 4 步
N_m3u8DL-RE 使用教程从安装到完成流媒体下载只需 4 步【免费下载链接】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 流媒体下载器适合需要课程离线下载、直播录制、管理多音轨字幕的用户。全文按任务推进先装好并验证再跑通第一次下载然后按场景配参数最后教你自己排查问题。01 动手前的准备环境与安装这一节让你确认系统满足要求并在 10 分钟内拿到可运行的程序。程序覆盖Windows、Linux、macOS三个平台。直接从官方发布渠道下载对应平台的发行版即可使用——官方发布构建采用 AOT 静态编译一般无需额外安装 .NET 运行时。如果你要自行构建源码项目 目标框架为.NET 10各csproj中TargetFramework为net10.0需要先安装 .NET 10 SDKgit clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE/src dotnet build N_m3u8DL-RE.slnArch Linux 系可从 AUR 安装n-m3u8dl-re-bin。安装是否成功用版本命令验证N_m3u8DL-RE --version N_m3u8DL-RE --help能打印出版本号和完整参数列表说明安装正常--help的输出本身就是一份官方参数手册后文会用到的参数都可以在这里找到。02 首战5 分钟跑通最小任务这一节给你一条可运行的最小命令外加一个不实际下载文件的干跑技巧。最小下载只需要一个链接加一个文件名N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-name test这个链接来自仓库的 TestStreams.md是一条公开的多音轨多字幕 mpd 测试流适合本地复现问题。程序会先解析清单、打印出所有可选的视频、音频、字幕轨道再按本机 CPU 线程数并发拉取分片分片异常默认自动重试 3 次最后合并输出。干跑验证只想看解析出的轨道、不想真下载时加--skip-download跳过下载步骤N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-name test --skip-download这是排查轨道选不准类问题的第一步先确认程序看到了什么再决定怎么选。03 实战场景最常用的三种用法这一节覆盖点播、直播、加密流三个高频需求每个场景给出可直接套用的命令。3.1 保存在线课程只要最高画质需求拿到一个 m3u8 链接想要一个成品 mp4不想手动分辨哪条轨是 1080p。N_m3u8DL-RE 课程m3u8链接 --save-name Python实战课程 --auto-select -M formatmp4关键参数--auto-select为所有类型自动挑选最佳轨道免去手写正则-M formatmp4所有分片下载完成后调用 ffmpeg 把分离的音视频混流为 mp4 容器--save-name指定成品文件名输出目录默认为当前目录可用--save-dir另指。预期结果得到单个Python实战课程.mp4而非一堆分离的 m4s/m4a 片段。3.2 录制直播边录边合并需求输入直播 m3u8 或 mpd 链接希望文件边下边成型且录满 3 小时自动停。N_m3u8DL-RE 直播链接 --save-name 技术大会 --live-real-time-merge --live-record-limit 03:00:00 --thread-count 8关键参数--live-real-time-merge分片下载时实时合并进成品文件录到一半也能播放已录部分--live-record-limit 03:00:00HH:mm:ss格式的时长上限到点自动结束--thread-count 8显式指定 8 个下载线程默认值是本机 CPU 线程数网络好时可调大。预期结果3 小时后自动停止并输出成品。注意默认的--live-keep-segments保留分片不要关网络波动丢数据时还能靠分片重拼。3.3 下载加密流并指定音画质量需求平台提供了KID:KEY格式的密钥希望挑最佳视频轨和音频轨字幕转成通用格式。N_m3u8DL-RE 加密流链接 --key KID值:KEY值 -sv best -sa best --sub-format SRT关键参数--key接受KID1:KEY1或纯KEY多组密钥就重复传参解密默认交给 mp4decrypt 完成-sv best/-sa best轨道选择参数支持正则与forbest等命名值组合完整语法可运行--morehelp select-video在程序内查看--sub-format SRT字幕输出为 SRT另一选项是VTT默认即 SRT。预期结果解密后的音视频 SRT 字幕文件。若流本身还有加密方式问题见 05 节解密条目。04 参数速查一张表配好你的任务这一节把常用参数按用途分组遇到具体任务先查表再回 README 核对细节。分组参数适用情况输出--save-name/--save-dir指定成品文件名与保存目录输出--save-pattern SaveName_Resolution一次下多条同类型流按分辨率等变量避免重名输出-M formatmp4或formatmkv:muxermkvmerge完成后把分离音视频混流为指定容器输出--sub-format SRT字幕转通用格式选择--auto-select不想手动挑轨选择-sv best、-sa langen:forbest按分辨率、语言、编码正则精确挑轨选择-ss all配--sub-only只取字幕网络--thread-count按带宽调并发默认 CPU 线程数网络--http-request-timeout 60弱网调超时默认 100 秒网络--custom-proxy http://127.0.0.1:8888需走指定代理默认走系统代理网络-R 15M限制下载速度加密--key KID:KEY流需要外部密钥加密--decryption-engine FFMPEG在 MP4DECRYPT、FFMPEG、SHAKA_PACKAGER 间切换解密程序直播--live-real-time-merge/--live-record-limit实时合并与限时长录制诊断--log-level DEBUG出问题看详细日志诊断--skip-download只看解析结果不下载高级语法自查N_m3u8DL-RE --morehelp mux-after-done、--morehelp select-video、--morehelp custom-range等可查任意选项的分隔符式完整语法。05 避坑清单症状 → 原因 → 解法这一节把最常见的四类故障整理成速查表对号入座即可。症状可能原因解法下载慢、频繁超时重试线程数偏低弱网下 100 秒超时仍不够调大--thread-count调大--http-request-timeout给--download-retry-count默认 3加预算需要代理时加--custom-proxy解密失败或花屏密钥格式不对应为KID:KEY多组重复传参默认 mp4decrypt 缺失或不匹配核对--key格式换--decryption-engine FFMPEG或SHAKA_PACKAGER确认对应程序在 PATH 中或用--decryption-binary-path指定全路径HLS 加密方式判断错误时用--custom-hls-method如AES_128、CHACHA20、SAMPLE_AES手动指定平台兼容问题旧版 Windows 自带终端不支持改用 cmder 执行macOS 若自构建需先装 .NET 运行时终端颜色异常用--no-ansi-color关闭彩色输出音视频不在一起、想合并下载的是分离的音视频轨-M formatmp4混流需引入外部字幕或音轨时用--mux-import path...:lang...:name...语法见--morehelp mux-import另外录制直播想零延迟混流时可用--live-pipe-mux但 README 明确提醒管道读数据由 ffmpeg 负责网络不稳时容易丢直播数据弱网环境不建议开启。06 底层视角它内部是一条什么流水线这一节用一句话建立全局心智模型按数据流定位问题环节就能快速缩小排查范围。整条流水线是解析清单 → 并发下载分片 → 解密如需→ 合并混流输出。对应源码目录解析入口在 src/N_m3u8DL-RE.Parser/StreamExtractor.cs它根据清单内容自动识别 m3u8/mpd/ism 并分发给Extractor/下各自的解析器任务调度在 src/N_m3u8DL-RE/DownloadManager/多线程拉片由SimpleDownloader.cs执行解密逻辑在 src/N_m3u8DL-RE/Crypto/合并混流由 src/N_m3u8DL-RE/Util/MergeUtil.cs 等完成。所以排查时先看报错出在哪一环轨道识别错查解析--skip-download看解析输出、--log-level DEBUG分片拉不到查网络超时、重试、代理花屏查解密引擎与密钥文件拆散查混流-M。07 边界与下一步这一节说明使用边界并给你一条可立即执行的动作。合规边界本工具基于MIT License开源见 LICENSE仅用于学习和技术研究。请只下载你拥有合法权限的内容遵守所在地区法律法规与平台服务条款任何侵权用途后果自负。想深入源码建议沿数据流读入口StreamExtractor.cs→ src/N_m3u8DL-RE/DownloadManager/ 看调度 → src/N_m3u8DL-RE/Config/ 看命令行参数如何映射到运行配置。功能验证可跑 src/N_m3u8DL-RE.Tests/ 里的解析器与工具类测试dotnet test各格式的公开测试流清单在 TestStreams.md。下一步现在就用 02 节那条--skip-download命令跑通安装验证确认轨道列表正确后去掉该参数完成你的第一次真实下载再把常用参数组合成自己的速查清单按场景直接套用。【免费下载链接】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），仅供参考