★ FEATURED ARTICLE 如何快速完整下载 m3u8/mpd 流媒体N_m3u8DL-RE 新手实用指南【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE在浏览器里抓到一个 .m3u8 或 .mpd 链接直接拖进播放器却只看到一小段画面在动——你要的其实是完整的本地文件。N_m3u8DL-RE 是一款跨平台的命令行流媒体下载工具支持 m3u8HLS、mpdDASH、ismMSS三种协议能把整片下载、直播录制、加密流解密这三件事各用一条命令搞定。本文按先跑起来再按任务加深最后排错的路子把新手真正会用到的参数讲一遍。N_m3u8DL-RE 安装与第一次 m3u8 下载三步跑通第 1 步装好程序。从项目 Releases 页面下载与你系统、架构匹配的压缩包解压后得到一个独立可执行文件把它放进 PATH 即可在任意目录直接调用。Arch Linux 用户也可以用 AUR 里的包。想自己从源码构建的话git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE第 2 步验证安装。跑下面这条命令能打印出类似N_m3u8DL-RE 0.6.0的版本行就说明环境没问题N_m3u8DL-RE --version第 3 步下第一段视频。前提是这个链接不需要登录就能访问N_m3u8DL-RE https://example.com/video/index.m3u8 --save-name 我的视频 --save-dir ./out终端里进度条走完./out目录下就会多出成品文件文件名基于--save-name。如果一条命令什么输出都没有老版本 Windows 自带终端常见后面故障速查里有解法。挑流让工具只下你指定的视频、音轨和字幕一个流里往往挂着好几条视频轨、多条音轨和字幕轨选谁由-sv视频、-sa音频、-ss字幕三个参数说了算写法是条件:条件的组合# 最省事全部轨道自动挑最佳 N_m3u8DL-RE 链接 --auto-select # 只挑 1920 开头的分辨率里码率最高的那条 N_m3u8DL-RE 链接 -sv res1920*:forbest -sa best # 最佳英语音轨 最佳日语或英语音轨各来一条 N_m3u8DL-RE 链接 -sa langen|ja:forbest2常用条件的含义res按分辨率正则匹配如3840*选 4Kcodecs按编码匹配如hvc1是 HEVClang按语言代码匹配bwMin/bwMax按码率Kbps卡区间forbest/forbest2/forall控制每种语言取几条。拿不准就先用--auto-select再按需要收紧。点播分片下载只取整片中的一段或合并成 mp4只要中间一段内容。用--custom-range按分片序号或时间段截取时间格式是MM:SS或HH:MM:SS# 下载第 5 分钟到第 20 分钟 N_m3u8DL-RE 链接 --custom-range 05:00-20:00 # 下载第 10 号分片之后的全部内容 N_m3u8DL-RE 链接 --custom-range 10-按时间段筛选时保留的是完整分片不做精确裁切边界处可能多出一小段这是正常现象。音视频分离时合并成一个文件。很多流的画面和声音在两条轨道上用-M在收尾时混流N_m3u8DL-RE 链接 -sv best -sa best -M formatmp4-M还支持换混流工具比如--mux-import引入外部字幕、formatmkv:muxermkvmerge用 mkvmerge 出 MKV细节可跑--morehelp mux-after-done查看。同时下多条流会重名覆盖用命名模板把分辨率、语言写进文件名即可N_m3u8DL-RE 链接 -sv all -sa all \ --save-name myvid \ --save-pattern SaveName_Resolution_Language直播录制边播边存到点自动停正在播的流想录下来加两个参数就够了N_m3u8DL-RE 直播m3u8链接 --save-name 直播 \ --live-real-time-merge --live-record-limit 01:00:00--live-real-time-merge让分片下载完就即时合并不在磁盘上堆一整夜的碎片--live-record-limit按HH:mm:ss限制总时长到点自动结束。两个实用的进阶用法# 回看从一小时前的节目开始录 30 分钟 N_m3u8DL-RE 直播链接 --live-catchup 01:00:00 --live-record-limit 00:30:00 --live-real-time-merge -M formatmkv # 录到一半断了重新执行同一条命令即可续录断点由程序自己记回看起点必须还在服务端的回看窗口内且依赖清单提供可靠的时间信息边界按完整分片对齐可能有几秒偏差。解密加密流--key 传对格式就成AES-128、CENC 这类加密流的分片本身是密文浏览器开发者工具的网络请求里一般能抓到KID:KEY形式的密钥两段都是十六进制传给工具即可# 单组密钥 N_m3u8DL-RE 加密流链接 --save-name 解密后 --key eb676abb:100b6c20 # 多轨道多密钥写多次各 KEY 相同时直接给 KEY 也行 N_m3u8DL-RE 加密流链接 --key KID1:KEY1 --key KID2:KEY2密钥多到手软时改用文本文件按 KID 查 KEYN_m3u8DL-RE 加密流链接 --key-text-file keys.txt解密默认调用 mp4decrypt 完成遇到报错可以换引擎用--decryption-engine FFMPEG或SHAKA_PACKAGER切换工具没装进 PATH 时用--decryption-binary-path指全路径。体积很大的加密片建议加--mp4-real-time-decryption让分片下载时就解密省掉一整份密文中转文件。工具内置的 AES、ChaCha20 实现位于 src/N_m3u8DL-RE/Crypto/HLS 的密钥处理在 DefaultHLSKeyProcessor.cs。 音视频分离的加密流先加-mt让音视频并发下载整体耗时能明显缩短。下载速度与稳定性这几个参数最常被调按提速 → 抗抖动 → 控带宽的顺序认识它们--thread-count并发线程数默认 10。带宽富余可以往上加加到分片开始报错就退回来。--download-retry-count每个分片失败后的重试次数默认 7。网络不稳或录长直播时调大更稳。--http-request-timeout单次 HTTP 请求的超时秒数默认 100。服务器响应慢导致超时失败时调大分片直播不指定时程序会自动调整。-R 15M限速单位 Mbps/Kbps如15M、100K。想给别的任务留带宽时启用排查速度慢时也别忘了它。--tmp-dir临时文件目录指向空间大、读写快的盘--del-after-done完成后清理临时文件默认开启建议保持。多网卡机器可以用--interface指定出口网卡代理场景用--custom-proxy http://127.0.0.1:8888。 调参建议一次只动一个参数先加线程、再调超时、最后才碰代理出问题时才能快速定位是哪一步引入的。同一套参数要反复用时别每次手敲——把常用选项写进 UTF-8 配置文件Linux/macOS 在~/.config/N_m3u8DL-RE/config.confWindows 在%APPDATA%\N_m3u8DL-RE\config.conf启动时自动读取命令行参数优先于配置# config.conf 示例# 开头为注释 --auto-select --thread-count 16 --save-dir Downloads/My Videos批量处理一长串链接脚本循环跑同一命令即可while read -r url; do N_m3u8DL-RE $url --save-dir ./out --save-name vid_$(date %s) done urls.txt下载出问题时按症状对号入座终端没有任何输出→ 老版本 Windows 自带终端不支持该程序的输出格式 → 换 PowerShell 或 cmder 等现代终端再跑。分片全部 403→ 请求里缺登录态或 UA 被风控 → 从浏览器复制 Cookie 和 User-Agent用-H Cookie: xxx -H User-Agent: xxx逐条带上也可以用--cookies cookies.txt直接读浏览器导出的 Netscape 格式 Cookie 文件。下载成功但文件打不开→ 加密流没给密钥、或KID:KEY格式不对两段都必须是十六进制→ 核对--key内容确认解密引擎对应工具已安装必要时用--decryption-binary-path指全路径。合并阶段报 ffmpeg 相关错误→ 混流、字幕处理依赖 ffmpeg 但系统里找不到 → 安装 ffmpeg 并放进 PATH或用--ffmpeg-binary-path指定可执行文件全路径。速度远低于带宽上限→ 先确认没设-R限速再调--thread-count仍不行则怀疑服务器对分片做了串行化。直播录到一半缺分片→ 刷新间隔太长或网络抖动后没恢复过来 → 用--live-wait-time调小刷新间隔同时把--download-retry-count调到 10 以上。排查前建议先跑一次N_m3u8DL-RE doctor它会检查工具版本和系统环境很多找不到 ffmpeg之类的问题一眼就能确认。选型一句话你手里有 m3u8/mpd/ism 链接、要整片或要录制、可能要解密N_m3u8DL-RE 一条命令就能闭环但它是纯命令行工具没有图形界面也不具备绕开平台级强 DRM 的通用能力。下载前请确认你对内容拥有合法权限仅用于学习和技术研究遵守所在地法律法规。【免费下载链接】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），仅供参考
阅读完成 · 觉得有帮助？
