N_m3u8DL-RE 实战手册M3U8/MPD 下载5 步从装到跑通【免费下载链接】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 是一款跨平台的流媒体下载器支持 MPD、M3U8、ISM 三种格式专门解决在线视频下下来是一堆分片、没法选清晰度、加密的还打不开这三类麻烦。它适合刚入门、只想一条命令跑通下载的新手也适合想批量囤直播、混流选音轨的普通用户。读完本文你可以从源码编译出可执行文件、跑通四个核心下载场景并且知道报错时第一步该查什么。环境准备编译出可执行文件N_m3u8DL-RE 是 .NET 程序编译前需要装好 .NET 10 SDK。Arch Linux 及衍生发行版可以直接从 AUR 安装 n-m3u8dl-re-bin 包无需自己编译其余平台照下面最短路径走。# 克隆源码并进入项目目录 git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE # 编译发布产物落在 bin/Release/net10.0/publish 目录下 dotnet publish src/N_m3u8DL-RE/N_m3u8DL-RE.csproj -c Release编译成功后可执行文件生成在src/N_m3u8DL-RE/bin/Release/net10.0/publish/里把它重命名丢进 PATH 就能直接敲N_m3u8DL-RE。下面的命令统一用全路径写法。# 跑一条版本命令确认编译产物能执行 src/N_m3u8DL-RE/bin/Release/net10.0/publish/N_m3u8DL-RE --version看到N_m3u8DL-RE 0.6.0 20261012输出版本号加日期构建号 成功。想先拿公开测试流练手从 TestStreams.md 里挑任意一条链接替换后面命令中的 URL 即可跑通。核心场景实操下载、选流、直播、解密存成可播放的 MP4如果你的需求是手里有一个 m3u8 或 mpd 点播链接想存成双击就播的文件# 下载并混流成 mp4 N_m3u8DL-RE https://example.com/video.m3u8 \ --save-name 我的视频 \ --save-dir ./downloads \ -M formatmp4跑完你会在 downloads 里看到一个 mp4直接播放就行不用再自己合并分片。 想要 mkv 容器就换成-M formatmkv混流程序也可指定如-M formatmkv:muxermkvmerge。只挑最高画质和指定音轨如果流里有多档分辨率、多条音轨你只想留最好的一条视频加一条指定语言的音频# 选最佳视频 最佳英文音轨存成 mp4 N_m3u8DL-RE https://example.com/master.m3u8 \ -sv best \ -sa langen:forbest \ -M formatmp4跑完你会得到一条分辨率最高、配英文音轨的 mp4其余档位根本不会下载。 想指定某档分辨率写-sv res1920*音轨全留写-sa all懒得挑就用--auto-select自动选所有类型的最佳轨道。直播边录边存实时合并如果你想把正在播的直播原样存下来、又不想干等它播完# 实时合并录制直播录满 30 分钟自动停 N_m3u8DL-RE https://example.com/live.m3u8 \ --live-real-time-merge \ --live-record-limit 00:30:00 \ --save-name 直播录制跑完你会得到一个边录边合并的直播文件到 30 分钟自动收工。 网络不稳就别加--live-pipe-mux管道方式容易丢帧刷新间隔可用--live-wait-time固定错过开场的节目用--live-catchup 01:00:00从一小时前回看。解密 CENC/AES 加密流如果流是加密的直接下下来的文件打不开# 带上 KID:KEY 密钥解密下载并混流成 mp4 N_m3u8DL-RE https://example.com/encrypted.m3u8 \ --key 0123456789abcdef0123456789abcdef:89abcdef0123456789abcdef01234567 \ --decryption-engine MP4DECRYPT \ -M formatmp4跑完你会得到一个已解密、能正常播放的 mp4。 密钥格式是 KID 在前、KEY 在后多条密钥就写多个--keyKEY 相同时也可直接写--key KEY默认 MP4DECRYPT 引擎不通时换--decryption-engine FFMPEG。参数调优速查线程、重试与限速最影响体验的是--thread-count默认 10带宽充裕且设备多核时建议调到 16其次是--download-retry-count默认 7它决定单个分片失败时的重试上限网络常抖动就值得动。参数推荐值/范围什么时候该动它--thread-count8~32推荐 16宽带 多核提速主力--download-retry-count3~20推荐 8网络不稳、分片频繁断连--custom-range如 05:00-20:00点播只要某几段省流量-R如 15MMbps 或 Kbps想限速、避免占满带宽完整参数见 README.md 的命令行参数章节个别选项还能用程序内置的--morehelp OPTION看详细用法。老版本 Windows 的系统自带终端可能跑不了本程序换个 cmder 之类的终端再试即可其余平台行为一致。高频报错自救4 条自查路径提示无法解析或拿到的不是媒体文件先用 curl 确认链接返回的是 m3u8/mpd而不是 HTML 页面检查是否缺 Referer 或 Cookie补上-H请求头重试N_m3u8DL-RE https://example.com/video.m3u8 -H Referer: https://example.com -H User-Agent: Mozilla/5.0文件下完了但打不开、花屏确认这条流是不是加密流检查--key顺序必须是 KID 在前、KEY 在后换解密引擎再试N_m3u8DL-RE https://example.com/video.m3u8 --key KID:KEY --decryption-engine FFMPEG -M formatmp4下载中途频繁中断、报超时调大重试--download-retry-count 8降线程--thread-count 4必要时走代理--custom-proxy http://127.0.0.1:7890N_m3u8DL-RE https://example.com/video.m3u8 --download-retry-count 8 --thread-count 4分片下完了混流-M时提示找不到 ffmpeg确认系统装了 ffmpeg 且在 PATH 里用N_m3u8DL-RE doctor可一键检查工具版本和环境用--ffmpeg-binary-path指到 ffmpeg 全路径或先不加-M把分片下下来再自己合并N_m3u8DL-RE https://example.com/video.m3u8 --ffmpeg-binary-path /usr/local/bin/ffmpeg -M formatmp4记住三点加密流带KID:KEY顺序的密钥选画质用-sv/-sa别整条瞎存直播加--live-real-time-merge边录边合。点播存 MP4、选流、直播录制、加密流解密四个场景覆盖了日常下载的大多数情况报错时先查密钥格式、请求头和 ffmpeg 环境。延伸阅读README.md 的完整参数列表、TestStreams.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），仅供参考