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
N_m3u8DL-RE 是一款跨平台命令行流媒体下载工具，专门处理 DASH、HLS、MSS 三种协议的点播和直播链接，也就是你常看到的 MPD、M3U8、ISM 文件。它把轨道识别、分片下载、音视频合并、解密和字幕抓取串成一条命令，不写代码的人也能把在线视频存成本地文件。
定位与适用场景
它解决的是"视频只能在网页里播，存不下来"这类具体问题：
- 网课和教程只有 m3u8 切片：浏览器直接另存会拿不到完整文件，把播放链接丢给它，就能拿到一个能直接播放的完整媒体文件。
- 想录一段时间直播：直播流不断刷新，普通下载器抓不全，它支持以录制方式持续取分片，还能限制录制时长。
- 下下来的文件放不了：不少流本身带加密，裸下是坏文件，它内置了解密环节，配上密钥后输出才是可播放的。
界面提供英语、简体中文、繁体中文三种语言，用哪个看习惯。
安装与首次运行
按平台选一条最短路径，装完都能用同一条命令验证。
Windows：解压即用
去官方发布渠道拿到最新 Release 压缩包，解压后直接运行里面的可执行文件，没有安装步骤。注意一点：老版本 Windows 自带的终端可能带不动这个程序，换个终端（例如 cmder）再跑即可。
Arch Linux：一条命令装好
Arch 及其衍生发行版可以从 AUR 装，稳定版和开发版二选一：
# 稳定版 yay -Syu n-m3u8dl-re-bin验证能不能跑通
拿一个测试链接跑下面这条命令，能生成文件就说明环境正常：
./N_m3u8DL-RE "视频链接地址" -o "保存文件名.mp4"命令行参数在 README.md 里有完整列表，测试流地址可参考 TestStreams.md。
进阶用法
按你想做的事来选参数，下面每组都能直接拼到主命令后面。
只下中间一段
不想全片下载时，用--custom-range按时间或分片序号截取。要第 5 分钟到第 20 分钟，就是下面这样；同时用--thread-count调线程数改善速度：
# 下载第5分钟到20分钟 --custom-range 05:00-20:00 # 把下载线程数设为 8 --thread-count 8自动挑最高画质
加--auto-select让它自动挑各类型最佳轨道；想更精确时用-sv、-sa按分辨率、编码、语言挑，比如只要 4K HEVC 视频、只要英语音轨。
顺带把字幕抓下来
字幕默认按 SRT 输出，用--sub-only只取字幕轨道，--sub-format在 SRT 和 VTT 之间切换，配合-ss可以按名称筛中文等特定字幕。
加密流先解密再合并
加密流要提供密钥，用--key按KID:KEY格式传入，多个就重复写；--decryption-engine指定底层解密程序。音视频分离的文件可用-M（--mux-after-done）在最后合并成 mp4 或 mkv 单文件：
# 传密钥，格式 KID:KEY --key KID1:KEY1 # 完成后合并为 mp4 -M format=mp4常见坑与解决办法
下载速度上不去。线程数默认等于本机 CPU 核数，跑不满或跑太快都有可能，先用--thread-count手动调到合适的值；分片偶发失败靠--download-retry-count（默认 3 次）自动重试，网络不稳时可以再加大。
文件下完却放不了。通常是两种原因：一是流本身加密但没给密钥，输出是坏文件，补上--key重新下；二是音视频是分离的两个文件，加-M在收尾时合并。
老 Windows 终端里报错或显示异常。原因是系统自带终端不支持程序用到的 ANSI 输出，换 cmder 之类的现代终端即可，也可以用--force-ansi-console/--no-ansi-color调整显示行为。
录直播中途丢数据。若开了实时管道混流（live-pipe-mux），管道读取由 ffmpeg 负责，网络一抖就容易出现丢帧，网络不够稳时别开这个选项。
实用建议
- 跑之前先看一眼
--version和--help，参数以当前版本为准，遇到新选项用--morehelp <选项名>查详细说明。 - 批量下载就写个简单循环脚本，把多个链接依次喂给同一条命令，比手动一条条敲省事。
- 大文件先指定
--save-dir和--tmp-dir到空间充足的盘，避免中途写满。
要跟进新功能和修复，留意官方 Release 页面提供的最新自动构建版本即可。
【免费下载链接】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），仅供参考
