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 是一款跨平台的 DASH/HLS/MSS 流媒体下载工具它负责解析 MPD、M3U8、ISM 清单把点播视频和直播流保存为本地文件并内置 CENC、AES-128、ChaCha20 等加密内容的解密能力。界面提供简中、繁中、英文三种语言Windows 与 Linux 均可运行。下面按装好、下载、解密、录直播的顺序带你把最常用的几条路径走通。 怎么把程序装好并跑通第一条命令获取可执行文件有两条路到项目 Releases 页面下载预编译包解压即用或者克隆源码自己构建。下面这条命令完成克隆与构建git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE dotnet build src/N_m3u8DL-RE.sln构建成功后可执行文件就在输出目录里。仓库自带一份公共测试流清单见 TestStreams.md从中挑一条 HLS 流来验证安装是否成功N_m3u8DL-RE http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8 --save-name oceans参数很直白第一个参数是播放列表链接--save-name oceans指定输出文件名。程序会先列出清单里可用的轨道再下载视频、音频分片并自动合并最终得到 oceans.mp4 和一份元信息 json。注意旧版 Windows 的自带终端可能无法完整显示程序输出建议换用第三方终端运行。Arch Linux 系用户可以从 AUR 直接安装n-m3u8dl-re-bin发行版或n-m3u8dl-re-git开发版省去手工构建步骤。 流媒体点播下载一条命令拿成本地文件手头已有 MPD 或 M3U8 链接时最省事的写法是让程序自己挑轨道N_m3u8DL-RE 链接 --save-name 我的视频 --auto-select--auto-select会自动挑选最佳视频、音频、字幕轨道--save-name给出输出文件名其余不用管。想手动控制轨道时用-sv、-sa、-ss按正则挑选视频、音频、字幕。下面这条命令取 1920 级别中码率最高的一条视频N_m3u8DL-RE 链接 -sv res1920*:forbest其中res1920*匹配所有以 1920 开头的分辨率forbest表示只保留最优的一条音频、字幕的写法与它一致。同时保存多条轨道时给--save-pattern加上Resolution、Language等变量每条轨道会生成互不冲突的文件名。这一场景常用的输出与性能参数--save-dir— 指定输出目录如--save-dir D:\Videos--tmp-dir— 临时分片目录如--tmp-dir C:\Temp--thread-count— 下载线程数默认 10如--thread-count 8-R— 限速单位 Kbps 或 Mbps如-R 15M-H— 为请求附加请求头如-H User-Agent: iOS-M— 全部完成后混流分离的音视频如-M formatmp4--log-level— 日志级别可选 DEBUG/INFO/WARN/ERROR/OFF 加密流解密密钥参数怎么填已经拿到密钥的加密流把密钥随命令一起传入即可N_m3u8DL-RE 加密链接 --key KID:KEY --save-name 解密后的视频--key有两种写法KID:KEY成对给出密钥 ID 与密钥如果所有轨道共用同一个密钥直接传KEY就行。多个 KID 就重复传多次--key密钥条数很多时可以改用--key-text-file指向一份 KID-KEY 映射文件程序按 KID 查找对应密钥。解密默认由 mp4decrypt 执行引擎名 MP4DECRYPT--decryption-engine可切换为 FFMPEG 或 SHAKA_PACKAGER。遇到清单没写清加密方式的自定义 HLS AES-128还能用--custom-hls-key和--custom-hls-iv分别指定密钥与 IV两者都接受 HEX、Base64 或文件路径三种形式。这一场景常用的参数--key— 解密密钥KID:KEY成对或纯KEY--key-text-file— KID-KEY 映射文件--decryption-engine— 解密引擎MP4DECRYPT默认/ FFMPEG / SHAKA_PACKAGER--custom-hls-key/--custom-hls-iv— 自定义 HLS 的密钥与 IV支持 HEX、Base64、文件 直播录制录多久自动停、怎么边录边合对持续开播的直播流想录到固定时长就停用--live-record-limit指定 HH:mm:ss 格式的时长N_m3u8DL-RE 直播链接 --live-record-limit 01:00:00--live-record-limit 01:00:00表示录制 1 小时后自动停止。两个可选的实时能力加--live-real-time-merge可以在录制过程中边录边合并省掉事后的二次合并--live-pipe-mux更进一步把分片通过管道交给 ffmpeg 实时混出 TS 文件。警告--live-pipe-mux依赖管道传输网络不稳时容易丢失直播数据不确定的网络环境请关掉它改用普通实时合并。其余常用直播参数--live-take-count— 首次获取的分片数量默认 16--live-wait-time— 手动设置直播列表刷新间隔秒--live-idle-timeout— 列表连续指定秒数无新分片时停止录制默认关闭 想看源码一条命令经过哪些模块读源码时跟着一条命令的数据流走最顺。你敲下一条下载命令后程序依次经过五个阶段入口与参数解析从 Program.cs 启动加载配置文件与命令行参数CommandInvoker判断是打印帮助还是开始任务解析实现在 CommandLine/。清单解析StreamExtractor按内容类型在 Parser 工程里挑选解析器——M3U8 走 HLSExtractorMPD 走 DASHExtractor2ISM 走 MSSExtractor——输出轨道列表、分片列表与解密信息入口在 Parser 工程各解析器位于 Extractor/。下载编排点播任务交给 SimpleDownloadManager 分片并发下载直播录制交给 HTTPLiveRecordManager 轮询清单并追加新分片统一在 DownloadManager/ 里调度。解密CENC、AES-128、ChaCha20 等由进程内实现与 mp4decrypt 等第三方工具协作完成代码在 Crypto/。合并与混流分片拼成完整文件后调用 ffmpeg 或 mkvmerge 输出 mp4/mkv核心逻辑在 MergeUtil.cs。️ 常见问题显示乱、速度慢、解密失败Windows 终端下进度条和颜色显示错乱怎么办旧版 Windows 自带终端不支持程序使用的输出方式换 cmder 等第三方终端或加--no-ansi-color去掉颜色。下载速度偏低先查什么先提高--thread-count看并发是否用满再用-R限速观察真实带宽如果经常超时调大--http-request-timeout。报 403 或分片拉取失败多半是平台在校验请求头用-H传入需要的头如果分片 URL 必须带上原链接的查询参数启用--append-url-params。解密失败怎么排查先核对 KID 与密钥是否一一对应仍不行就换一家引擎试试--decryption-engine FFMPEG。直播录制丢数据如果开着--live-pipe-mux先怀疑它——管道模式在网络不稳时容易丢数据关掉改用实时合并即可。⚖️ 合规提醒与小结注意请只下载自己有权访问的内容并遵守所在地区的法律法规项目以 LICENSE 中声明的 MIT License 开源提供。点播下载、解密、直播录制是 N_m3u8DL-RE 使用频率最高的三条路径本文覆盖了它们各自的核心参数。完整参数以运行--help的输出和 README.md 为准版本更新到项目 Releases 页面获取遇到问题和改进建议到项目 Issue 区反馈。【免费下载链接】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），仅供参考