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-REm3u8 下载下来的视频总是一堆散片没法直接播mpd 下载只能拿到固定清晰度、没有得选流是加密的下完照样打不开N_m3u8DL-RE 是一款跨平台流媒体下载器支持 MPD / M3U8 / ISM 三种格式点播与直播DASH/HLS都能录一条命令即可完成下载、选流、解密和混流。最简的一条长这样N_m3u8DL-RE https://example.com/video.m3u8✅ 预期效果该链接对应的完整媒体文件落到当前目录并附带一份解析出的元数据 json。快速上手从零到第一次 m3u8 下载选对获取方式预编译包或源码编译两条路径并列不改源码就选第一条预编译包推荐到项目 Releases 页面挑选与你系统对应的最新发行包解压后把N_m3u8DL-RE可执行文件加入PATH即可直接使用。源码编译备选需要 .NET 10 SDK两条命令完成git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet publish src/N_m3u8DL-RE/N_m3u8DL-RE.csproj -c Release 编译产物在src/N_m3u8DL-RE/bin/Release/net10.0/publish/N_m3u8DL-RE自行放入 PATH。验证版本并跑通第一条最小 m3u8 下载命令先做一次版本自检N_m3u8DL-RE --version看到版本号加日期构建号如0.6.0 20261012的输出说明安装无误。接着用仓库 TestStreams.md 里给出的测试向量跑第一次下载参数压到最少N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-dir ./downloads✅ 预期效果downloads/中出现视频及其对应的音频、字幕轨道可直接打开播放。最高频的 3 个下载场景点播、直播、加密流点播m3u8 转 mp4 命令一次挑到最清晰目标从多清晰度、多音轨的主播放列表中只留最高视频和指定语言音轨产出可播放的 mp4。N_m3u8DL-RE https://example.com/master.m3u8 -sv best -sa langen:forbest --save-name 我的视频 -M formatmp4参数说明-sv best只保留分辨率最高的一条视频想锁定某档就写-sv res1920*-sa langen:forbest取最佳英文音轨想全部保留写-sa all-M formatmp4下载完成后自动把分离的音视频混流为 mp4换formatmkv即得 mkv⚠️ 易踩坑-M依赖 ffmpeg未安装会在混流阶段报错处理方式见下方常见问题。直播录制直播 m3u8 边播边存、到点自动停止目标实时录下正在播出的流录满 30 分钟自动停下不用人守着。N_m3u8DL-RE https://example.com/live.m3u8 --live-real-time-merge --live-record-limit 00:30:00 --save-name 直播录制参数说明--live-real-time-merge录制时实时合并录完不用手动再拼分片--live-record-limit 00:30:00到时长上限自动结束录制⚠️ 易踩坑网络不稳时不要加--live-pipe-mux管道混流容易丢直播数据想固定清单刷新间隔用--live-wait-time错过了开播可用--live-catchup从指定历史时间回看。加密流CENC/AES 解密参数 --key 顺序别带反目标加密流带上密钥下载得到的文件能正常播放。N_m3u8DL-RE https://example.com/encrypted.m3u8 --key 0123456789abcdef0123456789abcdef:89abcdef0123456789abcdef01234567 -M formatmp4参数说明--key格式为KID:KEYKID 在前、KEY 在后多条密钥就写多个--key--decryption-engine选择解密程序默认MP4DECRYPT可换FFMPEG或SHAKA_PACKAGER⚠️ 易踩坑KID 与 KEY 顺序写反或密钥位数不对都会出现下完打不开卡住时先换引擎再查密钥。进阶下载参数速查表下表是最值得调的一组参数完整清单见 README.md 的命令行参数章节。场景参数推荐值推荐理由多核宽带提速--thread-count16默认 108~32 稳妥网络不稳断连--download-retry-count8默认 7多试几轮只要部分片段--custom-range05:00-20:00仅下第 5~20 分钟省带宽-R15M限速 15Mbps超时控制--http-request-timeout60默认 100 秒线程数是提速主力custom-range 是省流量主力二者按需各调其一即可。常见问题花屏、403、超时与找不到 ffmpegQ1分片下完了文件却打不开、画面花屏A1现象是进度 100% 但回放失败原因基本是流本身加密或密钥顺序写反。修复带密钥重新下载卡住时换 FFMPEG 引擎。N_m3u8DL-RE https://example.com/video.m3u8 --key KID:KEY --decryption-engine FFMPEG -M formatmp4Q2提示无法解析 URL或下下来的是 HTML 页面A2现象是解析阶段报错或产物其实是个网页原因是链接缺 Referer、Cookie 等必要请求头。修复先用 curl 确认返回内容是 m3u8/mpd 而不是 HTML再补请求头。N_m3u8DL-RE https://example.com/video.m3u8 -H Referer: https://example.com -H User-Agent: Mozilla/5.0有浏览器导出的 Netscape 格式 Cookie 文件时用--cookies cookies.txt直接传入即可。Q3下载中途频繁中断、报超时A3现象是任务卡在某个分片、重试后仍超时原因是网络抖动线程数偏高会更明显。修复加大重试、调低线程必要时走代理。N_m3u8DL-RE https://example.com/video.m3u8 --download-retry-count 8 --thread-count 4 --custom-proxy http://127.0.0.1:7890Q4分片都下好了混流-M阶段却提示找不到 ffmpegA4现象是只有-M这一步报错原因是 ffmpeg 未安装或不在 PATH。修复用--ffmpeg-binary-path指向 ffmpeg 完整路径或者先不加-M把分片下下来后自行合并。N_m3u8DL-RE https://example.com/video.m3u8 --ffmpeg-binary-path /usr/local/bin/ffmpeg -M formatmp4动手前也可以先跑N_m3u8DL-RE doctor一次性检查系统环境与工具版本。收尾5 条一行命令小抄依次对应① 最小点播下载 ② 最佳流转 mp4 ③ 直播录 30 分钟 ④ 加密流解密 ⑤ 环境自检N_m3u8DL-RE URL --save-dir ./downloads N_m3u8DL-RE URL -sv best -sa langen:forbest -M formatmp4 N_m3u8DL-RE URL --live-real-time-merge --live-record-limit 00:30:00 N_m3u8DL-RE URL --key KID:KEY -M formatmp4 N_m3u8DL-RE doctor把URL换成你的 m3u8/mpd 链接即可直接复制执行。【免费下载链接】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），仅供参考