6 步上手 N_m3u8DL-REM3U8/MPD 加密流下载与直播录制完整指南【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE把一条 M3U8 链接丢进浏览器你能看到视频用 curl 抓它下载下来是几十个.ts碎片播放器一个都打不开换个加密流播放器直接抛decryption failed。N_m3u8DL-RE 是一个跨平台的命令行下载器把 M3U8、MPD 或 ISM 链接交给它自动完成选流、下载、解密、合并最后落到一个能直接播放的 MP4 或 MKV 文件。README 里有完整参数文档官方测试流 可以拿来做第一次验证。⚡ 它替你解决了什么按你会碰到的场景来列点播下载给一个 M3U8/MPD 链接自动选最佳轨道、下载分片、合并输出。省去手动拼分片、手动调 ffmpeg。直播录制--live-real-time-merge边录边合并不用攒一堆碎片再处理--live-record-limit到点自动停。多音轨多字幕正则表达式挑流-sv/-sa/-ss三组参数控制只留你关心的轨道。加密流--key KID:KEY解 CENC--custom-hls-method--custom-hls-key解 HLS AES-128解密引擎可选 FFMPEG / MP4DECRYPT / SHAKA_PACKAGER。工具命令concat字节拼接、mergeFFmpeg 合并、mux音视频字幕混流、doctor环境自检不依赖下载流程。配置文件--config把常用参数固化成文件命令行优先级更高。源码入口主程序、解析器、工具命令。 装好它依赖.NET 10.0 运行时工程目标框架为net10.0见 N_m3u8DL-RE.csproj。没装就去微软官网下装完dotnet --version能看到 10.x 就对了。FFmpeg合并分片、混流、用 FFMPEG 引擎解密都要它。ffmpeg -version能跑就 OK跑不了就在下载命令里用--ffmpeg-binary-path指定可执行文件路径。mp4decrypt / shaka-packager只在用对应解密引擎时需要不强求。最省事的方式从 Releases 页下载当前平台的可执行文件解压即用不占 PATH 也行直接用绝对路径调。源码编译想跟最新提交或自己改参数时用git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build src/N_m3u8DL-RE.sln -c ReleaseArch Linux 系yay -Syu n-m3u8dl-re-bin装发行版-git后缀装开发版。PowerShell 用户加个 Tab 补全可执行文件要进 PATHN_m3u8DL-RE --generate-completion powershell | Out-String | Invoke-Expression之后输入N_m3u8DL-RE --sub-按 Tab 就能补参数名。 第一次成功跑通一条命令拿 TestStreams.md 里的公开测试流验证安装。这条 MPD 带多音轨多字幕能顺带检验选流和字幕N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --auto-select --save-dir ./out--auto-select让程序替你挑每种类型的最佳轨道省掉第一遍就要写正则的麻烦。跑完在./out里看视频、音轨、字幕各一个文件都能直接播放或挂载到播放器就算装好了。想更省心、把散开的轨道合成一个文件加一句-M mkvN_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --auto-select -M mkv --save-dir ./out 按任务来下载一条点播最小命令就一条 URL什么都不加N_m3u8DL-RE https://example.com/video.m3u8给输出起个名字、指定目录N_m3u8DL-RE https://example.com/course.m3u8 --save-name Python入门第3讲 --save-dir ./downloads只想下时间轴上的一段不用下完整片按分片起始时间筛选保留完整分片不做精确裁切N_m3u8DL-RE https://example.com/movie.m3u8 --custom-range 05:00-20:00多段点播含广告段、配置不一致的段默认会弹交互选段空格勾选、回车确认脚本里想跳过交互用--vod-drop-parts按编号排除。先列再选N_m3u8DL-RE URL --vod-list-parts N_m3u8DL-RE URL --vod-drop-parts 0,2-4录制一场直播基础录制录 30 分钟、边录边合并成单个文件N_m3u8DL-RE https://example.com/live.m3u8 --live-record-limit 00:30:00 --live-real-time-merge -M mkv--live-record-limit 00:30:00到点自动停不用担心录爆硬盘。--live-real-time-merge分片边下边拼不攒碎片。-M mkv全部工作完成后混流为 MKV得到一个能直接播的文件。漏掉了开播--live-catchup从一小时前开始回补再录 30 分钟N_m3u8DL-RE URL --live-catchup 01:00:00 --live-record-limit 00:30:00 --live-real-time-merge -M mkv也可以指定日期时间不带时区按本地时区算起点必须还在服务端回看窗口内N_m3u8DL-RE URL --live-catchup 2026-10-10T21:00:0008:00 --live-record-limit 00:30:00 --live-real-time-merge -M mkv两个常用调参--live-take-count 32 # 首次拉取的分片数默认 16 --live-idle-timeout 120 # 列表连续 120 秒无新分片时停录默认关闭挑清晰度和音轨-sv/-sa/-ss是选流三件套值都是正则子句用冒号分隔forbest表示每种语言留最佳的一条# 视频挑 1080p音频挑最佳英语 N_m3u8DL-RE URL -sv res1920x1080:forbest -sa langen:forbest # 4K HEVC N_m3u8DL-RE URL -sv res3840*:codecshvc1:forbest # 字幕只留名称含中文的 N_m3u8DL-RE URL -ss name中文:forall--morehelp select-video能查到rescodecsframechannelrangeurlperiodsegsMinbwMin这些子项的完整说明正则不会写的时候先跑这个。处理加密流两种最常见的情况CENCMPD 常见--key接受KID:KEY或直接给 KEY多个 KID 就重复写--key# KID 和 KEY 都已知 N_m3u8DL-RE https://example.com/encrypted.mpd --key e5114f87...:55c5d9f1... # 同一 KEY 对应多个 KID可以省略 KID N_m3u8DL-RE https://example.com/encrypted.mpd --key 55c5d9f1...KEY 太多不想写在命令行上用文件按行KID:KEY存好N_m3u8DL-RE https://example.com/protected.mpd --key-text-file ./keys.txtHLS AES-128M3U8 常见指定加密方式、KEY、IVKEY 可以是文件、HEX 或 Base64N_m3u8DL-RE https://example.com/enc.m3u8 \ --custom-hls-method AES_128 \ --custom-hls-key ./key.bin解 CENC 时想换引擎默认是 MP4DECRYPTN_m3u8DL-RE URL --key KID:KEY --decryption-engine FFMPEG需要给视频、音频分别指定 KEY用--custom-hls-scope VIDEO或AUDIO限定作用范围。批量与重复任务把常用的参数写进配置文件一次编辑、长期复用。程序默认读取Linux / macOS~/.config/N_m3u8DL-RE/config.confWindows%APPDATA%\N_m3u8DL-RE\config.conf配置文件沿用命令行参数语法支持#注释# 常用下载选项 -mt --thread-count 16 --auto-select --save-dir Downloads/Videos优先级是命令行 配置文件 内置默认值命令行能覆盖配置里的任何单项。想一次性指定别的配置文件--config ./my.conf这次完全不用配置--no-config。多个 URL 用 shell 循环就能串起来#!/usr/bin/env bash urls( https://example.com/lesson1.m3u8 https://example.com/lesson2.m3u8 ) for u in ${urls[]}; do N_m3u8DL-RE $u --save-dir ./downloads done 更快更稳更快--thread-count 16默认 10 线程宽带上调高收益明显先试 16别一味堆。-mt让选中的音频、视频、字幕轨道并发下载多轨道任务能省不少总时长。--del-after-done默认 true完成后清掉临时文件磁盘不留垃圾。更稳--download-retry-count 7默认 7单个分片失败自动重试直播遇到临时故障重试耗尽后仍会等待恢复不会直接中断录制。--http-request-timeout 100默认 100 秒单个 HTTP 请求的超时不限制总下载时长。直播未指定时会自动调整指定后就按你的值走。--custom-proxy http://127.0.0.1:8888走本地代理--use-system-proxy默认开启用系统代理。--interface eth1或本机 IP多网卡环境固定出口绑定失败会明确报错不会静默回退到其他网卡。 排错手册先跑一次doctor它会把 ffmpeg、mkvmerge、mp4decrypt、shaka-packager 是否装好、版本、路径一次性列出来配置路径也给出来能省一半排查时间N_m3u8DL-RE doctor N_m3u8DL-RE doctor --json doctor.json # 存档或贴给作者现象可能原因解法403 Forbidden服务器识别到非浏览器 UA-H User-Agent: Mozilla/5.0 ...伪装一下401 / 未登录需要 Cookie 才能访问浏览器导出 Netscape 格式 Cookie 文件--cookies ./cookies.txt合并 / 混流失败FFmpeg 不在 PATH 或版本过旧doctor确认版本--ffmpeg-binary-path /path/to/ffmpeg指定播放器报解密错误、花屏KEY 不匹配或 KID 对不上核对 KID换--decryption-engine FFMPEG再试HLS AES-128 解不出method / key / iv 任一写错对照--custom-hls-method、--custom-hls-key、--custom-hls-iv逐项核对直播中途没继续列表刷新间隔不匹配源节奏--live-wait-time 秒手动调--live-idle-timeout兜底停录分片明显缺失服务端跳过、或广告段被误下--ad-keyword匹配广告 URL 剔除--check-segments-count校验数量断网重连后想续上已下载分片默认跳过不重复拉重跑同一条命令即可已完成的分片会直接跳过输出文件名太长 / 重名自动名超长--save-name显式指定同名会附加短哈希要更细的现场--log-file-path ./log.txt --log-level DEBUG把日志落盘。UI 语言切中文--ui-language zh-CN。✅ 下一步先挑一条 TestStreams.md 里的公开流把上面「第一次成功」那一条命令原样跑一遍——能拿到能播放的文件后面所有参数才有参照物。常用参数写进配置文件之后每次只敲 URL。请只下载你拥有合法权限的内容遵守所在国家或地区的相关法律法规。【免费下载链接】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），仅供参考