MPD/M3U8 流媒体下载与直播录制实战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你手上有几条 4K 直播链接要录一整晚加密的 MPD 点播下不动HLS 流里混着多路音轨和字幕不知道怎么挑——这类需求通用下载器往往力不从心。N_m3u8DL-RE 是一个跨平台的流媒体下载与直播录制工具专门处理 MPD、M3U8、ISM 三类协议把解析、选流、下载、解密、混流串成一条可配置的流水线。能力边界适合谁不适合谁先说清楚它能做什么避免期待错位能做DASH/HLS/MSS 点播下载、DASH/HLS 直播录制、CENC/AES/ChaCha20 等加密流解密、音视频字幕轨道筛选、下载后 FFmpeg/mkvmerge 混流、外部媒体文件字幕/音轨注入。不能做网页视频解析只认 manifest/playlist 地址不爬 HTML、W3C Cenc-Widevine/FairPlay 这类浏览器级 DRM 的在线破解它做的是拿到 key 之后的离线解密。适合谁拿到过 MPD/M3U8/ISM 直链、想批量控制分辨率/语言/编码的开发者与中级用户不适合只想要贴个网页地址就出 MP4的场景。一句话边界你手里有 manifest 链接和加密流的key剩下交给它。三分钟跑通获取、构建与第一条命令项目基于 .NET 10.0C# 13源码结构见 src/N_m3u8DL-RE.sln。获取并构建git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build -c Release产物在src/N_m3u8DL-RE/bin/Release/net10.0/。Linux 上直接跑Windows 用.\N_m3u8DL-RE.exe。最小可运行命令挑一条测试流项目自带 TestStreams.md 可参考# 多音轨多字幕的 DASH 点播 .\N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd \ --save-name demo \ -sv best -sa all -ss all \ -M formatmp4参数含义-sv best选最佳视频-sa all收全部音轨-ss all收全部字幕-M formatmp4下完把分轨混成一个 MP4。跑通这条后面所有玩法都是在这个骨架上加参数。读懂代码结构四个项目如何分工把下载流程拆成几个可替换的环节后代码分成四个项目各管一段src/ ├── N_m3u8DL-RE/ # 入口参数解析、下载调度、解密、混流 ├── N_m3u8DL-RE.Common/ # 共享实体(Playlist/StreamSpec)、日志、HTTP 工具 ├── N_m3u8DL-RE.Parser/ # 协议解析HLS/DASH/MSS/LiveTS 提取器 MP4 box 处理 └── N_m3u8DL-RE.Tests/ # 单元测试与样例 manifest入口层Program.cs 启动时探测终端、加载请求头、检查互斥选项然后按输入类型分发给点播管理器或直播录制管理器DownloadManager/ 下的SimpleDownloadManager/SimpleLiveRecordManager2。解析层StreamExtractor.cs 是协议门卫——拉回原始文本后靠特征判断走哪个提取器以#EXTM3U开头进 HLS含MPD…/MPD进 DASH含SmoothStreamingMedia进 MSS特殊占位串进 LiveTS。识别后把分片、轨道、加密信息填进StreamSpec。解密层Crypto/ 内置 AES/ChaCha20 纯 C# 实现用于不依赖外部程序的场景CENC 类 MP4 解密则走外部工具默认 mp4decrypt。扩展层Processor/ 是内容处理器钩子可针对特定站点在解析前后改写 manifest如DemoProcessor演示如何按 URL 特征拦截处理。轨道怎么选正则表达式选视频、音频与字幕选流是这个工具区别于一把梭下载的核心。-sv/-sa/-ss三个选项接收键正则形式的条件用:分隔再配for决定取法best/bestN/worst/all。条件键含义示例res分辨率正则res3840*匹配 4Kcodecs编码codecshvc1只留 HEVClang语言langja\|en日或英name描述名name中文plistDurMin播放列表时长下限plistDurMin1h20m30sfor选择方式forbest/forall/forbest2# 4K HEVC 的最佳视频 英语最佳音轨 全部中文字幕 .\N_m3u8DL-RE stream.mpd \ -sv res3840*:codecshvc1:forbest \ -sa langen:forbest \ -ss name中文:forall对应地-dv/-da/-ds是反向选项按同样正则把不想要的轨剔除——适合全部收下再排掉广告轨/坏轨的用法。选流阶段只决定下哪些真正下载由后续调度负责所以选错最多是白下不会损坏文件。场景一高清点播与分片裁剪下载完整点播下载 命名模板 指定范围.\N_m3u8DL-RE https://dash.akamaized.net/dash264/TestCases/2c/qualcomm/1/MultiResMPEG2.mpd \ --save-name movie \ --save-pattern SaveName_Resolution_Bandwidthkbps \ -sv best -sa best \ --custom-range 05:00-20:00 \ -M formatmp4--save-pattern用变量拼文件名多轨下载时避免重名支持SaveName Resolution Bandwidth Language Codecs等变量。--custom-range只下部分分片0-10前 11 片、10-第 10 片起、-99前 100 片、05:00-20:00按时间。适合大文件断点续传或只要片段时省流量。需要把 URL 上的签名参数带给分片时加--append-url-params部分站点如 kakao 必需。场景二DRM 加密流解密与密钥管理拿到 key 之后的离线解密。先用--keyKID:KEY格式传入密钥再指定解密引擎.\N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd \ --save-name cenc_test \ --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d \ --decryption-engine MP4DECRYPT \ -M formatmp4引擎参数值特点mp4decryptMP4DECRYPT默认纯 MP4 CENC 解密速度快FFmpegFFMPEG兼容性最好HLS/其他封装也能扛Shaka PackagerSHAKA_PACKAGER适合多码流/特殊 CENC 场景密钥很多时改用密钥文件--key-text-file keys.txt文件里按KID:KEY一行一个程序按当前分片 KID 自动匹配。HLS 加密想完全自己掌控时用--custom-hls-methodAES_128|CENC|CHACHA20|…--custom-hls-key--custom-hls-iv显式指定绕过自动探测。--mp4-real-time-decryption边下边解 MP4 分片省掉下完再批量解的临时文件峰值大文件时磁盘更友好。场景三长时直播录制与实时混流直播录制核心是轮询 playlist 增量落盘。基础命令.\N_m3u8DL-RE https://cmafref.akamaized.net/cmaf/live-ull/2006350/akambr/out.mpd \ --save-name live \ --live-record-limit 02:00:00 \ --live-take-count 32 \ --live-wait-time 5 \ --live-real-time-merge--live-record-limit HH:mm:ss录满即停适合定时任务。--live-take-count首次抓取的片数默认 16网络抖动大时调高到 32–64 能减少起步丢片。--live-wait-time列表刷新间隔秒值太小对服务器压力大、太大可能漏片5 秒左右较稳。--live-real-time-merge实时合并避免分片堆积--live-keep-segments默认开保留分片便于事后排查。--live-pipe-mux通过管道 FFmpeg 把音视频实时混成 TS适合边录边看/边推。⚠️ 官方提示网络不稳时别开它管道读取由 FFmpeg 负责弱网下易丢数据。想把直播当点播一次性拉完加--live-perform-as-vod。进阶调优并发、网络与参数速查表参数默认值推荐值说明--thread-count本机 CPU 线程数4–16并发下载线程弱网别拉满-mt/--concurrent-download关开音视频字幕并发拉省总时长-R不限速如10M限速单位 Mbps/Kbps防占满带宽--download-retry-count35单分片失败重试弱网调高--http-request-timeout100 秒30请求超时弱网可降以减少卡死等待--use-system-proxy开—关则忽略系统代理--custom-proxy无http://127.0.0.1:8888指定代理# 弱网 高重试 限并发 .\N_m3u8DL-RE stream.mpd --thread-count 8 --download-retry-count 5 \ --http-request-timeout 30 -mt -R 10M \ -H User-Agent: Mozilla/5.0 -H Referer: https://example.com-H可重复用于补 Cookie/Referer/Origin 等鉴权头。日志排障时加--log-file-path ./log.txt配合--log-level DEBUG事后可查完整请求轨迹。排错手册现象、原因与解法现象可能原因解法下载慢/频繁超时线程过少、超时设置不合理、弱网-mt开并发--thread-count 8--http-request-timeout 30弱网降并发解密后花屏/全黑key 缺失或 KID 不匹配、引擎不对核对--key KID:KEY是否对应分片 KID换--decryption-engine FFMPEGHLS 用--custom-hls-*显式指定合并失败/输出损坏磁盘满、FFmpeg/mkvmerge 路径错、分片被临时删检查--save-dir空间--ffmpeg-binary-path指定程序关--del-after-done留临时文件排查试--binary-merge二进制合并直播中断/漏片刷新间隔不当、管道混流遇弱网提高--live-take-count32–64、调--live-wait-time5–10 秒弱网禁用--live-pipe-mux改传统合并选不到想要的轨正则没匹配上、for取值不当先用--morehelp select-video看可用字段-sv res*1080*:forall放宽条件验证老 Windows 终端跑不起来系统终端不支持换 cmder 运行或--force-ansi-console强制 ANSI排障顺序建议先确认版本最新 → 看--log-file-path日志 → 对照上表定位。多数问题在日志里能看到具体哪一步解析/下载/解密/合并失败。常见问答 FAQ它支持网页视频吗不支持。输入必须是 MPD/M3U8/ISM manifest 地址或file:本地文件。网页要先自己提取出 manifest 直链。没有 key 能解 DRM 吗不能。它做的是有 key 后的解密key 需要你自己从业务侧拿到--key或密钥文件。它不做浏览器级 DRM 的在线破解。为什么建议先-sa all -ss all再挑先全量拉下来看实际有哪些轨再用正则精确选能避免以为有英文字幕其实叫eng-desc这类漏选。大文件会不会占爆磁盘会先下分片再合并峰值接近 2 倍成片大小。用--mp4-real-time-decryption加密流或--live-real-time-merge直播把下完再处理变成边下边处理能显著压低峰值。能定时/批量跑吗能。--task-start-at yyyyMMddHHmmss可推迟任务开始多条 manifest 各自起一条命令即可配合--save-pattern避免命名冲突。N_m3u8DL-RE 的价值在于把协议差异 加密差异 输出差异三件事都收敛成命令行参数让你用一套心智模型覆盖点播、直播和 DRM 流。下一步建议拿一条你手头的真实链接从上面的三分钟跑通命令开始逐步替换成自己的选流与解密参数跑通第一条再谈调优。【免费下载链接】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），仅供参考
MPD/M3U8 流媒体下载与直播录制实战：N_m3u8DL-RE 完整配置指南
MPD/M3U8 流媒体下载与直播录制实战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你手上有几条 4K 直播链接要录一整晚加密的 MPD 点播下不动HLS 流里混着多路音轨和字幕不知道怎么挑——这类需求通用下载器往往力不从心。N_m3u8DL-RE 是一个跨平台的流媒体下载与直播录制工具专门处理 MPD、M3U8、ISM 三类协议把解析、选流、下载、解密、混流串成一条可配置的流水线。能力边界适合谁不适合谁先说清楚它能做什么避免期待错位能做DASH/HLS/MSS 点播下载、DASH/HLS 直播录制、CENC/AES/ChaCha20 等加密流解密、音视频字幕轨道筛选、下载后 FFmpeg/mkvmerge 混流、外部媒体文件字幕/音轨注入。不能做网页视频解析只认 manifest/playlist 地址不爬 HTML、W3C Cenc-Widevine/FairPlay 这类浏览器级 DRM 的在线破解它做的是拿到 key 之后的离线解密。适合谁拿到过 MPD/M3U8/ISM 直链、想批量控制分辨率/语言/编码的开发者与中级用户不适合只想要贴个网页地址就出 MP4的场景。一句话边界你手里有 manifest 链接和加密流的key剩下交给它。三分钟跑通获取、构建与第一条命令项目基于 .NET 10.0C# 13源码结构见 src/N_m3u8DL-RE.sln。获取并构建git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build -c Release产物在src/N_m3u8DL-RE/bin/Release/net10.0/。Linux 上直接跑Windows 用.\N_m3u8DL-RE.exe。最小可运行命令挑一条测试流项目自带 TestStreams.md 可参考# 多音轨多字幕的 DASH 点播 .\N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd \ --save-name demo \ -sv best -sa all -ss all \ -M formatmp4参数含义-sv best选最佳视频-sa all收全部音轨-ss all收全部字幕-M formatmp4下完把分轨混成一个 MP4。跑通这条后面所有玩法都是在这个骨架上加参数。读懂代码结构四个项目如何分工把下载流程拆成几个可替换的环节后代码分成四个项目各管一段src/ ├── N_m3u8DL-RE/ # 入口参数解析、下载调度、解密、混流 ├── N_m3u8DL-RE.Common/ # 共享实体(Playlist/StreamSpec)、日志、HTTP 工具 ├── N_m3u8DL-RE.Parser/ # 协议解析HLS/DASH/MSS/LiveTS 提取器 MP4 box 处理 └── N_m3u8DL-RE.Tests/ # 单元测试与样例 manifest入口层Program.cs 启动时探测终端、加载请求头、检查互斥选项然后按输入类型分发给点播管理器或直播录制管理器DownloadManager/ 下的SimpleDownloadManager/SimpleLiveRecordManager2。解析层StreamExtractor.cs 是协议门卫——拉回原始文本后靠特征判断走哪个提取器以#EXTM3U开头进 HLS含MPD…/MPD进 DASH含SmoothStreamingMedia进 MSS特殊占位串进 LiveTS。识别后把分片、轨道、加密信息填进StreamSpec。解密层Crypto/ 内置 AES/ChaCha20 纯 C# 实现用于不依赖外部程序的场景CENC 类 MP4 解密则走外部工具默认 mp4decrypt。扩展层Processor/ 是内容处理器钩子可针对特定站点在解析前后改写 manifest如DemoProcessor演示如何按 URL 特征拦截处理。轨道怎么选正则表达式选视频、音频与字幕选流是这个工具区别于一把梭下载的核心。-sv/-sa/-ss三个选项接收键正则形式的条件用:分隔再配for决定取法best/bestN/worst/all。条件键含义示例res分辨率正则res3840*匹配 4Kcodecs编码codecshvc1只留 HEVClang语言langja\|en日或英name描述名name中文plistDurMin播放列表时长下限plistDurMin1h20m30sfor选择方式forbest/forall/forbest2# 4K HEVC 的最佳视频 英语最佳音轨 全部中文字幕 .\N_m3u8DL-RE stream.mpd \ -sv res3840*:codecshvc1:forbest \ -sa langen:forbest \ -ss name中文:forall对应地-dv/-da/-ds是反向选项按同样正则把不想要的轨剔除——适合全部收下再排掉广告轨/坏轨的用法。选流阶段只决定下哪些真正下载由后续调度负责所以选错最多是白下不会损坏文件。场景一高清点播与分片裁剪下载完整点播下载 命名模板 指定范围.\N_m3u8DL-RE https://dash.akamaized.net/dash264/TestCases/2c/qualcomm/1/MultiResMPEG2.mpd \ --save-name movie \ --save-pattern SaveName_Resolution_Bandwidthkbps \ -sv best -sa best \ --custom-range 05:00-20:00 \ -M formatmp4--save-pattern用变量拼文件名多轨下载时避免重名支持SaveName Resolution Bandwidth Language Codecs等变量。--custom-range只下部分分片0-10前 11 片、10-第 10 片起、-99前 100 片、05:00-20:00按时间。适合大文件断点续传或只要片段时省流量。需要把 URL 上的签名参数带给分片时加--append-url-params部分站点如 kakao 必需。场景二DRM 加密流解密与密钥管理拿到 key 之后的离线解密。先用--keyKID:KEY格式传入密钥再指定解密引擎.\N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd \ --save-name cenc_test \ --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d \ --decryption-engine MP4DECRYPT \ -M formatmp4引擎参数值特点mp4decryptMP4DECRYPT默认纯 MP4 CENC 解密速度快FFmpegFFMPEG兼容性最好HLS/其他封装也能扛Shaka PackagerSHAKA_PACKAGER适合多码流/特殊 CENC 场景密钥很多时改用密钥文件--key-text-file keys.txt文件里按KID:KEY一行一个程序按当前分片 KID 自动匹配。HLS 加密想完全自己掌控时用--custom-hls-methodAES_128|CENC|CHACHA20|…--custom-hls-key--custom-hls-iv显式指定绕过自动探测。--mp4-real-time-decryption边下边解 MP4 分片省掉下完再批量解的临时文件峰值大文件时磁盘更友好。场景三长时直播录制与实时混流直播录制核心是轮询 playlist 增量落盘。基础命令.\N_m3u8DL-RE https://cmafref.akamaized.net/cmaf/live-ull/2006350/akambr/out.mpd \ --save-name live \ --live-record-limit 02:00:00 \ --live-take-count 32 \ --live-wait-time 5 \ --live-real-time-merge--live-record-limit HH:mm:ss录满即停适合定时任务。--live-take-count首次抓取的片数默认 16网络抖动大时调高到 32–64 能减少起步丢片。--live-wait-time列表刷新间隔秒值太小对服务器压力大、太大可能漏片5 秒左右较稳。--live-real-time-merge实时合并避免分片堆积--live-keep-segments默认开保留分片便于事后排查。--live-pipe-mux通过管道 FFmpeg 把音视频实时混成 TS适合边录边看/边推。⚠️ 官方提示网络不稳时别开它管道读取由 FFmpeg 负责弱网下易丢数据。想把直播当点播一次性拉完加--live-perform-as-vod。进阶调优并发、网络与参数速查表参数默认值推荐值说明--thread-count本机 CPU 线程数4–16并发下载线程弱网别拉满-mt/--concurrent-download关开音视频字幕并发拉省总时长-R不限速如10M限速单位 Mbps/Kbps防占满带宽--download-retry-count35单分片失败重试弱网调高--http-request-timeout100 秒30请求超时弱网可降以减少卡死等待--use-system-proxy开—关则忽略系统代理--custom-proxy无http://127.0.0.1:8888指定代理# 弱网 高重试 限并发 .\N_m3u8DL-RE stream.mpd --thread-count 8 --download-retry-count 5 \ --http-request-timeout 30 -mt -R 10M \ -H User-Agent: Mozilla/5.0 -H Referer: https://example.com-H可重复用于补 Cookie/Referer/Origin 等鉴权头。日志排障时加--log-file-path ./log.txt配合--log-level DEBUG事后可查完整请求轨迹。排错手册现象、原因与解法现象可能原因解法下载慢/频繁超时线程过少、超时设置不合理、弱网-mt开并发--thread-count 8--http-request-timeout 30弱网降并发解密后花屏/全黑key 缺失或 KID 不匹配、引擎不对核对--key KID:KEY是否对应分片 KID换--decryption-engine FFMPEGHLS 用--custom-hls-*显式指定合并失败/输出损坏磁盘满、FFmpeg/mkvmerge 路径错、分片被临时删检查--save-dir空间--ffmpeg-binary-path指定程序关--del-after-done留临时文件排查试--binary-merge二进制合并直播中断/漏片刷新间隔不当、管道混流遇弱网提高--live-take-count32–64、调--live-wait-time5–10 秒弱网禁用--live-pipe-mux改传统合并选不到想要的轨正则没匹配上、for取值不当先用--morehelp select-video看可用字段-sv res*1080*:forall放宽条件验证老 Windows 终端跑不起来系统终端不支持换 cmder 运行或--force-ansi-console强制 ANSI排障顺序建议先确认版本最新 → 看--log-file-path日志 → 对照上表定位。多数问题在日志里能看到具体哪一步解析/下载/解密/合并失败。常见问答 FAQ它支持网页视频吗不支持。输入必须是 MPD/M3U8/ISM manifest 地址或file:本地文件。网页要先自己提取出 manifest 直链。没有 key 能解 DRM 吗不能。它做的是有 key 后的解密key 需要你自己从业务侧拿到--key或密钥文件。它不做浏览器级 DRM 的在线破解。为什么建议先-sa all -ss all再挑先全量拉下来看实际有哪些轨再用正则精确选能避免以为有英文字幕其实叫eng-desc这类漏选。大文件会不会占爆磁盘会先下分片再合并峰值接近 2 倍成片大小。用--mp4-real-time-decryption加密流或--live-real-time-merge直播把下完再处理变成边下边处理能显著压低峰值。能定时/批量跑吗能。--task-start-at yyyyMMddHHmmss可推迟任务开始多条 manifest 各自起一条命令即可配合--save-pattern避免命名冲突。N_m3u8DL-RE 的价值在于把协议差异 加密差异 输出差异三件事都收敛成命令行参数让你用一套心智模型覆盖点播、直播和 DRM 流。下一步建议拿一条你手头的真实链接从上面的三分钟跑通命令开始逐步替换成自己的选流与解密参数跑通第一条再谈调优。【免费下载链接】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），仅供参考
