N_m3u8DL-RE 上手指南4 条命令把 MPD/M3U8/ISM 流下载成能播的视频【免费下载链接】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 这类在线流下下来是一堆分片没法播、多档清晰度选不了、加密文件打不开的麻烦一条命令就能完成选流、下载、解密和混流。本文面向刚接触它的新手和普通用户所有命令都可以复制粘贴直接跑环境要求只有一台装着 .NET 10 SDK 的电脑。它的核心能力大致是下载 DASHMPD、HLSM3U8、Smooth StreamingISM三种流格式点播、直播都能录直播支持回看catchup和定时自动停止用正则表达式选视频/音频/字幕轨道按分辨率、码率、语言筛解密 CENC / AES 加密流MP4DECRYPT / FFMPEG / SHAKA_PACKAGER 三引擎可换把分离的音视频混流成 mp4 / mkv下完即可播放附带 concat / merge / mux 三个工具命令已有分片也能单独处理环境准备从源码编译 N_m3u8DL-RE 并验证程序用 C# 编写需要安装 .NET 10 SDK。三步拿到可执行文件# 克隆源码并进入目录 git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE # 编译发布产物生成在 publish 目录下 dotnet publish src/N_m3u8DL-RE/N_m3u8DL-RE.csproj -c Release # 验证版本能打印版本号即成功 src/N_m3u8DL-RE/bin/Release/net10.0/publish/N_m3u8DL-RE --version看到类似N_m3u8DL-RE 0.6.0 20261012的版本字符串说明编译成功、环境就绪。下文统一把这个可执行文件简写为N_m3u8DL-RE你也可以把它改名后加入 PATH之后直接敲命令即可。 老版本 Windows 自带终端可能跑不起来本程序换 cmder 这类终端再执行即可。先跑通第一条命令用公开测试流验证整条链路第一次用先拿一条不加密的公开测试流确认解析 → 下载 → 合并 → 能播整条链路没问题# 下载仓库测试流列表里的一条 DASH 明文测试流 N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-name FirstStream预期产物当前目录下生成一个名为 FirstStream 的单个视频文件日志显示分片全部完成播放器能正常打开——这就是成功。更多可以直接练手的测试流链接见 TestStreams.md。按场景取用把点播流存成单个 MP4当你拿到一个点播链接想存成能双击播放的视频时# 下载并混流为 mp4指定输出目录和文件名 N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd \ --save-name MyStream \ --save-dir ./downloads \ -M formatmp4跑完在 downloads 目录里得到一个 .mp4直接播放即可。 想要 mkv 容器就把-M formatmp4换成-M formatmkv想用 mkvmerge 混流则写-M formatmkv:muxermkvmerge。只下最清晰那一路视频和指定音轨当流里有多档分辨率、多条音轨你只想留最好的那一套时# 用 -sv best 选最佳视频轨其余轨道不下载 N_m3u8DL-RE https://devstreaming-cdn.apple.com/videos/streaming/examples/bipbop_adv_example_hevc/master.m3u8 \ -sv best \ --save-name HiQuality \ -M formatmp4产物是分辨率最高的一路视频其他清晰度直接跳过。 指定分辨率档位写-sv res1920*要保留音轨就加-sa langen:forbest选最佳英文音轨图省事也可以直接加--auto-select让它自动选所有类型的最佳轨道。边播边合地录直播当你要保存正在播出的直播、又不想干等它播完时# 录制时实时合并分片录满 10 分钟自动停止 N_m3u8DL-RE https://cmafref.akamaized.net/cmaf/live-ull/2006350/akambr/out.mpd \ --live-real-time-merge \ --live-record-limit 00:10:00 \ --save-name LiveRecording--live-real-time-merge让你在录制过程中分片持续合并进文件--live-record-limit 00:10:00到时间自动收工不用手动 CtrlC。 网络不稳时别加--live-pipe-mux管道方式实时混流容易丢分片想手动固定刷新间隔用--live-wait-time。解密下载加密流当流是 CENC 或 AES 加密、不带密钥下下来就是废文件时# 带 KID:KEY 密钥用默认 mp4decrypt 引擎解密 N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd \ --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d \ --save-name DecryptedStream \ -M formatmp4跑完你会得到一个已解密、能正常播放的 mp4。 密钥格式固定是KID:KEYKID 在前多条密钥就重复写多个--key默认 MP4DECRYPT 引擎不顺时用--decryption-engine FFMPEG换引擎再试。参数速查最影响体验的 5 个参数参数推荐值什么时候用--thread-count16默认 10带宽宽裕、多核机器想压缩下载耗时--download-retry-count12默认 7网络不稳、分片频繁断连--http-request-timeout60默认 100 秒源站响应慢想快速失败或放宽等待--custom-range05:00-20:00点播只要某几段按时间只下对应分片-R15M限速避免下载占满整条带宽大部分默认值不用动线程数、重试次数、超时都有合理内置值。分片多又只想要一小段时优先想到--custom-range按时间截取保留完整分片不做精确裁切别把整部片子下下来。完整参数清单见 README.md 的命令行参数章节。出错了先自查现象解析出来的是 HTML 页面或直接提示 URL 无法解析原因源站要求特定请求头程序没拿到真正的播放清单。用 curl 确认该链接实际返回的是 m3u8/mpd 而不是 HTML加-H Referer: ...、-H User-Agent: ...重试Cookie 较多时从浏览器导出 Netscape 格式文件用--cookies cookies.txt传入验证带请求头重跑同一命令能看到正常的流列表和选流信息即解决。现象文件下完了但打不开或花屏原因流本身加密而没带密钥或--key里 KID:KEY 顺序写反。确认这条流是否为 CENC / AES 加密核对密钥顺序KID 在前、KEY 在后换解密引擎--decryption-engine FFMPEG再跑验证N_m3u8DL-RE doctor检查解密工具是否装好重跑后打开文件播放确认。现象下载中途频繁超时、中断原因网络抖动默认 7 次重试扛不住。调大--download-retry-count 12降并发--thread-count 4有代理就挂上--custom-proxy http://127.0.0.1:7890验证跑完后程序默认核对已下分片数与预期数量--check-segments-count日志显示一致即可信。现象分片下完了-M 混流时报找不到 ffmpeg原因混流依赖 ffmpeg它没装或不在 PATH 里。安装 ffmpeg 并加入 PATH或用--ffmpeg-binary-path /usr/local/bin/ffmpeg直接指到全路径不想依赖它就先不加-M下完分片再用内置工具命令concat/merge合并验证终端里ffmpeg -version能打印版本信息再重跑混流命令。记住这几点就够密钥格式固定KID:KEYKID 在前、KEY 在后顺序反了就是花屏最常调的三个参数--thread-count、--download-retry-count、--custom-range环境或工具链拿不准时先跑N_m3u8DL-RE doctor自检一遍【免费下载链接】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），仅供参考
