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.mpd、HLS.m3u8和 MSS.ism三种协议的点播与直播内容下载内置加密内容解密、多轨道选择、分片合并和直播实时合并等能力。你只需一条命令就能把在线流媒体完整保存到本地。本文面向新手和普通用户从安装到直播录制逐步讲清楚常用操作。浏览器只能看不能存先用它解决这三个场景普通下载器面对流媒体链接时通常只能抓到一个个无法直接播放的 .ts/.mp4 分片而且多清晰度选择、加密流、直播录制基本无能为力。N_m3u8DL-RE 针对的就是这些情况你遇到的问题它能做什么链接是 .m3u8 / .mpd / .ism 清单文件解析清单按清晰度选轨并自动合并成完整文件同一内容有多档视频、多语言音轨、多条字幕用正则表达式筛选轨道可一次下载多条内容是加密的AES-128、CENC 等提供密钥后自动调用 mp4decrypt / ffmpeg / shaka-packager 解密需要长时间录制直播支持边录边合并、限时录制、按时间点修正字幕 仓库中的 TestStreams.md 提供了一批公开测试流多音轨、加密、直播等适合装好后自我验证避免拿自己的需求流调试环境。三步跑通第一次下载第 1 步安装。Arch Linux 及衍生版可直接从 AUR 安装# 发行版 yay -Syu n-m3u8dl-re-bin # 开发版 yay -Syu n-m3u8dl-re-git其他系统建议下载预构建发布版或自行编译源码合并功能依赖 ffmpeg可选 mkvmerge需确保其在 PATH 中或通过参数指定路径。第 2 步执行最小命令。链接就是唯一必填参数# 最小用法一个链接 N_m3u8DL-RE 你的m3u8或mpd链接 # 指定保存目录与文件名 N_m3u8DL-RE 你的m3u8或mpd链接 --save-dir ~/Downloads --save-name myvideo第 3 步确认产物。下载完成后分片会被合并为完整文件解析出的元信息默认还会写出一份 JSON方便你核对轨道信息。多清晰度内容怎么选轨-sv / -sa / -ss 用法一个清单里往往同时存在 720p、1080p、4K 等多档视频和多语言音频。三个短参数负责筛选-sv视频、-sa音频、-ss字幕值可以是best、all也可以是键值:键值形式的条件多个条件之间按正则表达式匹配。# 最高清视频 最佳英语音轨 全部字幕 N_m3u8DL-RE 你的链接 -sv best -sa langen:forbest -ss all # 只要 4K HEVC 视频想要前 2 条最佳就把 forbest 写成 forbest2 N_m3u8DL-RE 你的链接 -sv res3840*:codecshvc1:forbest常用条件键含义示例res分辨率res3840*匹配 4Kcodecs编码codecshvc1匹配 HEVClang语言代码langja|en匹配日语或英语name轨道名称name中文for选择方式best/best2/worst/allplistDurMin播放列表时长下限plistDurMin1h20m30s如果你不想逐个挑选加--auto-select即可让程序对每类轨道自动选最佳。想排除某些轨道则用对应的-dv/-da/-dsdrop 系列规则与选择系列一致。更多写法可用--morehelp select-video在终端里查看。一次下多条轨道命名模板与并发下载-sv all这类全都要的写法会产出多个文件此时建议用--save-pattern给文件起出可区分的名字。模板支持变量SaveName、Resolution、Bandwidth、Language、Codecs、MediaType、Channels等。# 下载所有视频轨道文件名带上分辨率和码率 N_m3u8DL-RE 你的链接 -sv all --save-pattern SaveName_Resolution_Bandwidthkbps # 产出类似 video_1920x1080_5000000kbps.mp4若不加该参数程序在文件名冲突时也会用分辨率、带宽等元信息自动生成唯一名字不会简单追加.copy后缀。视频、音频、字幕默认串行下载加-mt可让已选轨道并发下载。直播流录制合并实操录制直播时最关心的两件事会不会录断、事后怎么合成一个文件。--live-real-time-merge让程序边录边合并随时可以中断--live-record-limit设置录制时长上限到点自动停止。# 录制直播并实时合并录满 2 小时自动停止 N_m3u8DL-RE 你的直播链接 --live-real-time-merge --live-record-limit 02:00:00相关参数补充说明一句话版--live-pipe-mux实时合并时经管道 ffmpeg 混流成 TS 文件⚠️ 网络不稳定时容易丢帧官方 README 明确建议弱网下不要开启--live-perform-as-vod把直播流当点播处理一次性拉完整个播放列表--live-wait-time/--live-take-count手动控制列表刷新间隔与首次抓取的分片数--live-fix-vtt-by-audio依据音频起始时间修正 VTT 字幕的时间轴。加密内容解密怎么配解密的核心是给对密钥。--key支持KID:KEY形式可多次指定若所有流共用一个 KEY直接写--key KEY即可密钥较多时可用--key-text-file指向文本文件程序按 KID 自动匹配。解密引擎由--decryption-engine选择FFMPEG / MP4DECRYPT / SHAKA_PACKAGER默认 MP4DECRYPT第三方程序不在 PATH 里时用--decryption-binary-path指定全路径。# 指定 KID 与 KEY 解密 N_m3u8DL-RE 你的加密链接 --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d对于密钥不在清单里、需要手动提供加密方式与 IV 的 HLS 流还有--custom-hls-methodAES_128、CENC、CHACHA20 等、--custom-hls-key、--custom-hls-iv三个参数值可以是文件、HEX 或 Base64。解密实现的入口代码在 src/N_m3u8DL-RE/Crypto/想了解各引擎差异可以顺着看。常用参数速查表参数作用示例--thread-count下载线程数默认等于本机 CPU 线程数--thread-count 16--http-request-timeout单次 HTTP 请求超时秒默认 100--http-request-timeout 120--download-retry-count分片失败重试次数默认 3--download-retry-count 5-H, --header追加自定义请求头可重复-H Cookie: xxx--custom-proxy指定代理默认走系统代理--custom-proxy http://127.0.0.1:8888-R限速支持 Mbps/Kbps-R 15M-M, --mux-after-done完成后混流分离的音视频-M formatmp4或formatmkv:muxermkvmerge--custom-range只下载部分分片支持序号区间或时间区间--custom-range 05:00-20:00--sub-format字幕输出格式 SRT 或 VTT--sub-format VTT--mux-import混流时引入外部字幕/音轨--mux-import pathzh.srt:langchi--ad-keyword按 URL 正则跳过广告分片--ad-keyword ad\|promo--task-start-at到指定时刻才开始任务--task-start-at 20251001080000命令行参数的完整定义见 src/N_m3u8DL-RE/CommandLine/CommandInvoker.cs下载与直播录制逻辑在 src/N_m3u8DL-RE/DownloadManager/。避坑与排障速查症状建议终端输出乱码、颜色不显示加--no-ansi-color旧版 Windows 自带终端可能整体不受支持可换用 cmder 运行下载慢调整--thread-count与 CPU 核心数匹配即可盲目调大意义不大或检查是否被限速-R影响合并步骤报错找不到 ffmpeg安装 ffmpeg或用--ffmpeg-binary-path指定可执行文件全路径直播实时混流丢帧关闭--live-pipe-mux改用普通实时合并抓到的分片里混有广告用--ad-keyword给出广告 URL 的关键字正则分片数量与预期不符程序默认会校验实际与预期分片数是否一致留意日志提示 两个参数很值得记住--help查看全部选项说明--morehelp 选项名查看某个复杂选项如select-video、custom-range、mux-after-done的详细帮助与示例。小结N_m3u8DL-RE 覆盖了从给个链接存下来到多轨选流、加密解密、直播限时录制的完整链路核心操作基本就是链接 几个短参数。遇到问题先跑一遍N_m3u8DL-RE --help确认当前版本参数再结合--morehelp与上方排障表定位大多数情况都能自行解决。【免费下载链接】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），仅供参考