N_m3u8DL-RE 流媒体下载实操从零跑通 DASH/HLS/MSS 完整教程【免费下载链接】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 是跨平台流媒体下载工具支持 DASH、HLS、MSS 三种协议覆盖点播与直播也能处理加密流与直播录制。本文面向会用终端的用户从零跑通一次真实下载并覆盖选画质、解密、部分下载、命名规则等高频需求。 跑通第一次下载安装、运行、验证安装并检查依赖。Arch Linux 及其衍生版直接装yay -Syu n-m3u8dl-re-bin其他系统克隆 https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE 后用 .NET 10 SDK 编译。程序启动时会预检查 ffmpeg先确认它已安装且在 PATH 中再用自带 doctor 命令自检环境N_m3u8DL-RE doctor跑第一条命令。这条 DASH 样例来自项目测试流清单多音轨多字幕程序自动识别协议并进入交互式选流界面N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd不指定--save-dir时结果文件输出到当前工作目录。验证产物。任务结束后检查目录ls -lh应看到合并后的视频文件和 meta.json记录全部流信息--write-meta-json默认开启--no-log可关闭日志文件输出。 能力速查什么需求配什么参数能解决什么关键参数一句话说明选择画质/音频/字幕轨-sv -sa -ss按分辨率、编码、语言等正则条件筛选轨道解密 CENC/AES 加密流--key --decryption-engine下载后交给 mp4decrypt 或 ffmpeg 解密录制直播流--live-real-time-merge --live-record-limit边下边追新分片可实时合并并限制时长只下部分内容--custom-range按分片序号或时间区间截取点播内容下载后混流-M formatmp4分离的音视频自动合成 mp4/mkv 单文件命名与目录管理--save-dir --save-pattern模板变量避免文件名互相覆盖 高频场景实战选择最高画质想干什么多画质流里只下最高分辨率的那条视频轨。N_m3u8DL-RE https://dash.akamaized.net/dash264/TestCases/2c/qualcomm/1/MultiResMPEG2.mpd -sv best --save-dir ~/Videos --save-name MultiRes起作用的是-sv best把所有视频轨按带宽排序取最高的一条--save-name让输出文件名可预期。若只要 4K HEVC 轨就换成-sv res3840*:codecshvc1:forbest用正则把候选缩小到 4K HEVC 轨避免误选同分辨率的其他编码。完整筛选语法语言、帧率、声道、码率等看N_m3u8DL-RE --morehelp select-video。加密流下载完整步骤密钥怎么填想干什么下载加密 DASH 流下载完成后自动解密。N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d -sv best起作用的是--key采用 KID:KEY 形式程序下载完分片后把密钥交给解密程序处理。默认解密引擎是 MP4DECRYPT需要本机装有 mp4decrypt若本机只有 ffmpeg用--decryption-engine FFMPEG切换。注意所有轨道共用同一把 KEY 时直接写--key KEY即可无需 KID密钥来自文件时用--key-text-file。录制直播并限制时长想干什么把一路直播录 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 LiveDemo程序检测到所选流是直播后自动进入录制模式持续追取新分片直到 CtrlC 停止。--live-real-time-merge让分片在录制中实时合并进最终文件省去事后合并--live-record-limit 00:10:00把录制锁在 10 分钟内防止文件无限增长。⚠️ README 明确提醒网络环境不够稳定时不要开启--live-pipe-mux管道内数据读取由 ffmpeg 负责某些环境下容易丢失直播数据。若想补看过去的节目换成--live-catchup 01:00:00配合--live-record-limit从一小时前开始下载README「直播回看」一节。只下载部分内容想干什么先下几个分片验证链路再决定是否下全量。N_m3u8DL-RE https://dash.akamaized.net/dash264/TestCases/2c/qualcomm/1/MultiResMPEG2.mpd -sv best --custom-range 0-10起作用的是--custom-range 0-10只下载序号 0 到 10 共 11 个分片。其他写法10-从第 10 个分片开始往后下-99取前 100 个分片05:00-20:00按时间截取按分片起始时间筛选保留完整分片不精确裁切。注意该参数仅对点播生效直播不适用。命名与输出目录管理想干什么一次下视频加多条音轨各文件互不覆盖、落进指定目录。N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd -sv best -sa all --save-dir ~/Videos --save-name Demo --save-pattern SaveName_MediaType_Language--save-dir和--save-name决定文件落在哪、基础名是什么--save-pattern用变量展开文件名-sa all下全部音轨时各文件互不覆盖。模板还支持Resolution、Bandwidth、Codecs等变量区分大小写详见--morehelp save-pattern。注意过长的保存名和模板生成的文件名会自动缩短并附加短哈希以减少重名README 命令行参数一节。 慢、挂、播不了怎么办三个核心调优参数统一用法--thread-count改的是并发下载分片的线程数默认 10。带宽没跑满而服务器支持并发时调到 20默认值的 2 倍服务器限流或网络拥堵时反而调低。--http-request-timeout改的是单次 HTTP 请求超时秒默认 100。分片大、网速慢、超时频繁时调到 180给单请求更多时间调低只会让失败更快出现。--download-retry-count改的是单个分片下载异常后的重试次数默认 7。弱网下偶发 4xx/5xx 导致任务中断时调到 10降低失败概率设太高会让已失效的分片白白多等。现象可能原因处理办法启动即报找不到 ffmpeg系统未安装 ffmpeg 或不在 PATH安装 ffmpeg或用--ffmpeg-binary-path指定全路径加密流下载完成但无法播放未提供密钥或 KID:KEY 对应错误核对密钥来源后用--key KID:KEY重下或改用--key-text-file旧版 Windows 终端启动崩溃或乱码系统终端不支持本程序换用 cmder 等现代终端运行README 建议直播录制出现数据丢失弱网下开启了--live-pipe-mux关闭 pipe-mux仅用--live-real-time-merge实际分片数少于预期任务报错部分分片请求失败且重试不够调大--download-retry-count后重跑核对--check-segments-count结果 代码导览各模块职责src/N_m3u8DL-RE/Program.cs 主入口做 ffmpeg、解密工具等预检查完成流选择后按协议与直播属性分发到不同管理器。src/N_m3u8DL-RE/CommandLine/ 命令行参数定义与解析包括 -sv、--custom-range 等复合参数语法。src/N_m3u8DL-RE/DownloadManager/ 任务编排SimpleDownloadManager 负责点播SimpleLiveRecordManager2 与 HTTPLiveRecordManager 负责直播录制。src/N_m3u8DL-RE/Downloader/ 单个分片的下载与合并执行。src/N_m3u8DL-RE/Processor/ URL、Key、Content 三类处理器的扩展点二次开发可按站点插入自定义逻辑。src/N_m3u8DL-RE.Parser/Extractor/ DASH、HLS、MSS 的流提取器实现src/N_m3u8DL-RE.Parser/Mp4/ 处理 MP4 box 解析与字幕提取。src/N_m3u8DL-RE.Common/ 公共实体Playlist、MediaSegment、StreamSpec、HTTP 工具与日志。src/N_m3u8DL-RE.Tests/ 单元测试与测试资源用例可直接参考。 下一步N_m3u8DL-RE 把流媒体下载的主链路拆得职责清晰真实场景大多靠参数组合即可覆盖。运行N_m3u8DL-RE --morehelp select-video通读轨道筛选的完整语法。按 TestStreams.md 里的 DASH/HLS/MSS 测试流各跑一遍确认本机环境正常。批量任务把--save-pattern与--save-dir固化成脚本模板或写入~/.config/N_m3u8DL-RE/config.conf配置文件复用。【免费下载链接】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），仅供参考