N_m3u8DL-RE 完整实战指南m3u8/mpd 流媒体一键下载、直播录制与解密【免费下载链接】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 是一款跨平台的流媒体下载工具支持 m3u8HLS、mpdDASH、ismMSS三种协议一条命令完成解析、并发下载、合并与解密。照本文操作你可以把一个播放列表链接变成本地可播放的 mp4 或 mkv 文件。一、先看它适不适合你N_m3u8DL-RE 是一个单文件命令行程序没有图形界面。它解决的问题是你手里有一个 m3u8 或 mpd 链接想把它变成本地文件手动抓分片不现实。它适合有明确链接、想要批量、想要解密的场景不适合需要可视化操作的用户。适配清单适合 ✓不适合 ✗手里有 m3u8 / mpd / ism 链接要存成本地文件需要图形界面或批量管理后台有直播流要边播边录或定时停止平台级强 DRMWidevine、FairPlay 等音视频分离要选流、合并、转字幕完全不懂命令行操作二、三分钟跑起来安装 N_m3u8DL-RE 并验证从项目 Releases 页面下载与你系统和架构对应的压缩包解压后是一个独立可执行文件放进 PATH 即可。Arch Linux 用户可用 AUR 包n-m3u8dl-re-bin。若要从源码构建git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE安装后运行验证命令预期输出一行版本号如N_m3u8DL-RE 0.6.0 20261012N_m3u8DL-RE --version✅ 看到版本号即安装成功。老版本 Windows 自带终端可能无法显示输出换用 PowerShell 或 cmder 再跑。三、照着场景做4 个高频任务场景 1下载一个完整的点播视频适用情况你有一个可直接访问的 m3u8 或 mpd 链接不需要登录态要下整片。N_m3u8DL-RE m3u8或mpd链接 --save-name 名称 --save-dir ./out把m3u8或mpd链接换成你的实际 URL名称换成想要的文件名。关键参数速解--save-name成品文件名主体省略时按流信息自动命名--save-dir输出目录省略时为当前目录默认自动选最佳轨道并合并成可播放文件预期结果跑完在./out下得到一个合并好的成品文件进度条走完且文件可播放。场景 2多流里挑质量音频视频合并成一个文件适用情况一条链接下有多档分辨率和多条音轨你只要 1080p 视频加一条音轨最后合进一个 mp4。N_m3u8DL-RE 链接 -sv best -sa best --save-name 名称 -M formatmp4关键参数速解-sv best选最佳视频轨也可写正则如-sv res1920*只要 1080p-sa best选最佳音轨-sa langen:forbest只要英语轨-ss name中文:forall按名称选字幕轨-M formatmp4音视频分离时下载完成后混流成 mp4也可formatmkv:muxermkvmerge--sub-format SRT字幕输出格式默认 SRT可改 VTT预期结果得到一个 mp4内含你选定的视频、音频和字幕。场景 3直播边播边录到时自动停适用情况一个正在直播的 m3u8 流要从头录起并限制时长或从历史时间点回看。N_m3u8DL-RE 直播m3u8链接 --save-name 直播 --live-real-time-merge --live-record-limit 01:00:00回看一小时前的节目并只下载 30 分钟N_m3u8DL-RE 直播链接 --live-catchup 01:00:00 --live-record-limit 00:30:00 --live-real-time-merge -M mkv关键参数速解--live-record-limit HH:mm:ss录制时长上限到点自动结束--live-real-time-merge边下边合不把分片堆在临时目录--live-catchup 01:00:00从一小时前的历史内容开始下载要求清单提供时间信息且在服务端回看窗口内--live-take-count 16首次获取的分片数默认 16IPTV 场景直接传入频道列表文件如N_m3u8DL-RE channels.m3u --live-record-limit 00:03:00预期结果程序按列表刷新间隔持续录制录满设定时长后停止并输出成品。中断后重跑原命令即可续录。场景 4加密流带上密钥下载解密适用情况视频用了 AES-128 或 CENC 加密播放列表里只有密文分片。密钥一般在浏览器开发者工具的网络请求里能抓到格式是KID:KEY两段都是十六进制。N_m3u8DL-RE 加密流链接 --save-name 名称 --key eb676abb:100b6c20关键参数速解--key KID:KEY传入密钥可重复多次对应多组密钥各轨 KEY 相同时只写 KEY 部分--key-text-file 文件从文件按 KID 查 KEY适合多轨道多密钥--decryption-engine FFMPEG默认 MP4DECRYPT报错时可换 FFMPEG 或 SHAKA_PACKAGER--decryption-binary-path 全路径解密工具不在 PATH 时指定路径--mp4-real-time-decryption分片实时解密大文件可省临时空间预期结果得到解密合并后的可播放文件密钥缺失或格式不对时会在解密阶段报错。场景 5只下视频中的一段适用情况完整视频很长你只要中间一段内容或断点续传时只补剩余分片。N_m3u8DL-RE 链接 --custom-range 05:00-20:00 --save-name 名称关键参数速解--custom-range 05:00-20:00按时间只下第 5 到 20 分钟时间按分片起始时间筛选保留完整分片不做精确裁切--custom-range 10-按分片序号从第 10 片下到最后适合补下剩余分片--custom-range -99只下前 100 片--skip-download跳过已有分片直接合并配序号范围用于补全后收尾预期结果得到该时间段对应的成片文件名规则与其他场景一致。四、参数一页速查下载控制参数作用什么时候用--thread-count N下载线程数默认 10带宽富余时调高提速--download-retry-count N每个分片失败后的重试次数默认 7网络波动大、录直播--http-request-timeout N单次请求超时秒数默认 100服务器响应慢导致频繁超时-R 15M限速单位 Mbps/Kbps如 15M、100K要给别的任务留带宽--save-pattern SaveName_Resolution文件名模板支持Resolution、Language、Bandwidth等变量同时下多条流避免重名--tmp-dir 路径临时文件目录默认盘空间不足时换盘质量选择参数作用什么时候用-sv/-sa/-ss按正则选视频/音频/字幕如res1920*、langen:forbest只要 1080p、只要中文轨--auto-select所有轨道自动选最佳不想写任何筛选条件--sub-format SRT或VTT字幕输出格式默认 SRT播放器只认某种字幕-M formatmkv结束后混流容器也可muxermkvmerge音频视频要合进一个文件解密参数作用什么时候用--key KID:KEY传入解密密钥可重复多次抓到了密钥就要用--key-text-file 路径从文件按 KID 查 KEY多轨道多密钥手敲太累--decryption-engine FFMPEG选择外部解密工具默认 MP4DECRYPT默认引擎报错时换一个--decryption-binary-path 路径解密工具全路径工具没装进 PATH--mp4-real-time-decryption分片实时解密大文件想省临时空间网络与登录态参数作用什么时候用--custom-proxy http://127.0.0.1:8888指定请求代理走本地代理加速或绕路--use-system-proxy使用系统代理默认开启一般不用动-H Cookie: xxx追加请求头可写多次站点需要登录态或特定 UA--cookies cookies.txt读取浏览器导出的 Netscape 格式 Cookie 文件登录态头太多逐条写-H太繁琐--interface eth1指定出口网卡或本机 IP多网卡机器要约束出口五、速度与稳定性调优每条建议固定三段调什么、为什么、观察什么。⚠️ 顺序上先加线程再调超时最后才动代理每次只改一个参数。调--thread-count 16→ 默认 10 线程对高带宽可能不够 → 观察总速度是否上升、是否出现分片报错报错多再降回来。调--http-request-timeout 60→ 服务器响应慢时默认 100 秒会拖慢整体节奏 → 观察超时重连次数是否减少注意分片直播未指定时会自动调整。调--download-retry-count 10→ 网络抖动时默认 7 次重试可能不够 → 观察直播录制中重试耗尽提示是否消失。调--tmp-dir到大空间快盘保持--del-after-done默认开启→ 临时分片写满会中断下载 → 观察临时目录占用是否在完成后清零不要关这个开关。调--custom-proxy→ 直连 403 或拉流慢时走代理 → 观察分片状态码代理通了但 403 说明还缺-H登录态见第六节。六、出问题先对照这里症状可能原因解决办法命令没有任何输出老版本 Windows 自带终端不支持该程序输出格式换 PowerShell 新版终端或 cmder 再跑速度远低于带宽上限单连接限速、线程数偏低或误设了-R限速先确认没设-R再调--thread-count仍不行就检查分片是否被服务器串行化下载成功但文件打不开加密流没给密钥或--key格式不对KID 和 KEY 两段都要十六进制核对密钥格式用--decryption-binary-path指全路径必要时换--decryption-engine合并阶段报 ffmpeg 相关错误混流和转字幕依赖 ffmpeg但系统里找不到安装 ffmpeg 并保证在 PATH 里或用--ffmpeg-binary-path指定可执行文件全路径同时下多条流文件互相覆盖多条流保存名相同加--save-pattern SaveName_Resolution_Language让文件名带区分变量分片全部 403 拉不下来请求头缺登录态或被风控从浏览器复制 Cookie 和 User-Agent用-H逐条加上或改用--cookies文件七、能力边界与合规擅长m3u8、mpd、ism 三种协议的点播与直播音视频分离选流、合并、字幕转换AES-128 与 CENC 类解密核心加密实现见 src/N_m3u8DL-RE/Crypto/解析器见 src/N_m3u8DL-RE.Parser/分片管理见 src/N_m3u8DL-RE/DownloadManager/。不擅长平台级强 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），仅供参考