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-REN_m3u8DL-RE 是一款跨平台的流媒体下载器可以处理 MPDDASH 动态自适应协议、M3U8HLS 分片协议和 ISM微软平滑流三种格式覆盖点播下载与直播录制两大需求。它的亮点在于内置了多种解密引擎能直接处理 AES-128、CENC 乃至 ChaCha20 加密的加密视频而不是让你拿到一堆无法播放的分片文件。只要你习惯用命令行管理任务、想把在线视频存成本地文件这套工具就能派上用场。 从零到第一次成功安装、验证、第一条命令安装。Windows 和 macOS 用户直接到项目 Release 页面下载对应平台的预编译包即可Arch Linux 系发行版可以用 AUR 一条命令装好yay -Syu n-m3u8dl-re-bin如果你更喜欢源码编译也可以克隆仓库后自行构建.NET 项目源码主体在src/N_m3u8DL-RE/git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE验证。装完后先确认程序能正常运行N_m3u8DL-RE --help能看到完整的参数说明列表就说明安装成功。第一条下载命令。建议从一个公开的多码率测试流开始跑通全流程它会同时验证解析、分片下载和合并三个环节N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-name demo跑完后你会在输出目录看到demo开头的媒体文件默认还会生成一份解析元数据 json方便核对轨道信息。更多可测试的样例流整理在 TestStreams.md 中覆盖 DASH、HLS、MSS、加密和直播等类型。 核心使用场景四类高频任务直接套用加密点播一键解密遇到带 DRM数字版权保护密钥的 CENC 加密流时用--key传入密钥程序会调用内置解密引擎还原出明文。密钥格式为KID:KEYKID 是密钥标识KEY 是解密用的密钥本体通常都能从网页的授权响应里抓到N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd \ --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d \ -M formatmp4 --save-name cenc_demo--key多条轨道用不同密钥时可以重复传入多次所有轨道共用一把密钥时只填 KEY 也行-M formatmp4全部下完后把音视频混流进 MP4 容器保证能直接播放解密默认走 mp4decrypt 引擎解密相关实现位于src/N_m3u8DL-RE/Crypto/目录提示解密依赖第三方工具mp4decrypt、ffmpeg 等如果系统里找不到可用--decryption-binary-path指定可执行文件全路径。直播录制与实时合并录直播流时程序会循环刷新播放列表并持续追加新分片。加上实时合并选项后边录边拼成一个可播放的文件避免攒下几百个碎分片N_m3u8DL-RE https://cmafref.akamaized.net/cmaf/live-ull/2006350/akambr/out.mpd \ --live-real-time-merge \ --live-record-limit 00:10:00 \ --save-name live_demo--live-real-time-merge录制过程中实时合并分片--live-record-limit录满 10 分钟自动停止防止占满磁盘--live-wait-time可选手动指定列表刷新间隔默认 15 秒左右--live-pipe-mux可选通过管道加 ffmpeg 实时混流出 TS 文件警告网络不稳时不建议开--live-pipe-mux。管道内的读取由 ffmpeg 负责弱网环境下容易丢直播数据。多清晰度与音轨精准选择一个码率阶梯里往往躺着 360p 到 4K 的好几条视频轨、多语言音轨和字幕轨。用正则表达式式的选择器-sv选视频、-sa选音频、-ss选字幕可以精确锁定想要的组合N_m3u8DL-RE https://dash.akamaized.net/dash264/TestCases/2c/qualcomm/1/MultiResMPEG2.mpd \ -sv best -sa langen:forbest \ --save-pattern SaveName_Resolution \ --save-name multi_demo -mt -M formatmp4-sv best/-sv res3840*:codecshvc1:forbest选最佳视频或只挑 4K 且 HEVC 编码的轨-sa langen:forbest只挑英语音轨里质量最好的一条多轨同时保留可用-sa all--save-pattern文件名里嵌入Resolution等变量多条流并存时不会互相覆盖-mt音视频字幕并发下载多轨场景提速明显不确定选哪条时先用--auto-select让程序替你挑各类型的最佳轨道只下载部分内容的分片不想下完整集、只想抽某一段--custom-range支持按分片序号或按时间截取N_m3u8DL-RE http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8 \ --custom-range 05:00-20:00 --save-name partial_demo05:00-20:00只下载第 5 分钟到第 20 分钟的分片0-10按序号下载第 0 到 10 个分片共 11 个-99只下前 100 个分片适合快速抽样检查画质 常用参数速查含义、推荐值与适用场景参数含义推荐值适用场景--thread-count下载分片用的并发线程数默认等于 CPU 核数4~16大文件高速下载弱网反而可调小--download-retry-count单个分片失败后的重试次数默认 35~10网络波动、跨网下载--http-request-timeout单次 HTTP 请求超时秒数默认 10030~60慢速服务器直播场景可放宽-R/--max-speed限速单位 Mbps 或 Kbps如15M按需不想占满带宽、挂机录制-M/--mux-after-done全部完成后混流如formatmp4或formatmkv:muxermkvmerge视需求音视频分离的流想直接播放--save-dir/--tmp-dir成品输出目录 / 分片临时目录各自指向剩余空间大的盘临时盘与系统盘分离--save-name/--save-pattern固定文件名 / 带变量的命名模板批量下载用 pattern多轨下载避免文件名冲突--key解密密钥KID:KEY形式可重复传入从授权响应中提取CENC、AES 加密流--decryption-engine指定解密工具MP4DECRYPT、FFMPEG、SHAKA_PACKAGER默认 MP4DECRYPT某引擎解密失败时换引擎--live-record-limit直播录制时长上限HH:mm:ss按计划时长定时录节目--live-real-time-merge直播边录边合并开启直播录制--custom-range只下指定序号区间或时间区间的分片按需抽段、试看、补录-sv/-sa/-ss正则选择器挑视频 / 音频 / 字幕轨best起步多码率流精准取流-H/--header追加自定义请求头可多次传入抓包所得需要 Cookie、Referer 鉴权的站点--use-system-proxy/--custom-proxy走系统代理 / 指定代理地址代理可用时开启需要中转网络的流--auto-select自动挑各类型最佳轨道新手建议开不关心具体码率的场景--log-level日志级别DEBUG、INFO、WARN等排障时用DEBUG问题定位 高频问题排查三段式定位法问题一下载成功但视频无法播放或报错现象进度跑完 100%播放器打开却是黑屏、花屏或日志里出现解密相关报错。原因密钥格式没写对漏掉 KID 或写成了 Base64或该轨道用的加密方式需要换一个解密引擎。解决命令确认密钥写成KID:KEY冒号分隔并尝试切换引擎到 ffmpegN_m3u8DL-RE 你的URL --key KID:KEY --decryption-engine FFMPEG -M formatmp4问题二频繁超时、中断、分片下载失败现象日志反复出现超时或 404个别分片重试多次仍失败最终任务中止。原因默认重试 3 次、超时 100 秒的组合对弱网偏保守或者你所在的网络必须经代理才能访问源站。解决命令拉高重试与超时上限必要时显式走本地代理N_m3u8DL-RE 你的URL --download-retry-count 10 --http-request-timeout 60 --custom-proxy http://127.0.0.1:7890问题三解析失败、返回 403 或分片全部 404现象主链接能打开但程序一解析就报 403或分片下载全部 404。原因服务端要求 Cookie、Referer 等请求头或分片链接依赖主链接上的查询参数而这些默认不会带过去。解决命令把抓包得到的请求头透传并让分片继承主链接的查询参数N_m3u8DL-RE 你的URL -H Cookie: sid你的值 -H Referer: 你的域名 --append-url-params收尾记住三件事就能覆盖绝大多数需求先用 TestStreams.md 里的样例流验证环境再用--key加-M处理加密点播直播录制则依赖--live-real-time-merge加--live-record-limit。参数拿不准时跑一遍N_m3u8DL-RE --morehelp 参数名看官方详细说明比到处翻帖子更快。完整参数清单随时参考 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），仅供参考