N_m3u8DL-RE 完整指南：流媒体下载与直播录制的正确打开方式

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

你大概经历过这样的时刻：视频网站里的 HLS 地址好不容易抓到了，普通下载器却只存下一堆零散的 .ts 分片，拼不起来、也放不了音；或者直播结束后，想回看刚才的片段，却发现什么都没留下来。N_m3u8DL-RE 就是为这类场景设计的：一款跨平台的现代流媒体下载工具，覆盖 MPD（DASH）、M3U8（HLS）与 ISM（MSS）三种协议，内置解密引擎，同时支持点播下载和直播录制。

🧩 核心能力速览

💡 一个容易被忽略的设计细节：FFmpeg 合并分片时默认走--ffmpeg-concat-mode LOCAL_HTTP，通过只监听本机的临时输入提供可随机读取的连续字节流，不生成合并中间文件，也不受分片数量带来的句柄和命令行长度限制。

📦 安装与准备

最推荐的方式：从项目发布页下载与你的系统对应的预编译版本，解压后把可执行文件加入PATH即可，无需任何额外依赖；Arch Linux 用户也可以直接用 AUR 包n-m3u8dl-re-bin。

# 备选：源码编译（需要 .NET 10 SDK） git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build src/N_m3u8DL-RE.sln -c Release

装好之后，如果不确定系统里 FFmpeg、mp4decrypt 等工具是否就位，先跑一条环境自检命令：

N_m3u8DL-RE doctor

它会列出当前环境与各依赖工具的状态，后续解密或合并失败时，可以先来这里对照排查。

⚡ 快速上手：一条命令跑通第一次下载

把地址直接丢给它，程序会自动分析流信息、选轨、下载并合并成完整文件：

N_m3u8DL-RE "https://example.com/video.m3u8"

下载完成后你会在当前目录得到合并好的媒体文件，以及一个记录解析信息的 JSON 文件。下面是加了几个常用参数的完整写法：

N_m3u8DL-RE "https://example.com/course.m3u8" \ -mt \ --save-name "Python数据分析入门" \ --save-dir "./downloads" \ --auto-select \ -M format=mp4

• -mt：音视频字幕各轨道并发下载，多轨道时明显提速；
• --save-name/--save-dir：控制文件名与输出目录，方便归档；
• --auto-select：自动为每种轨道选择最佳质量，省去手动选流；
• -M format=mp4：下载完成后自动把分离的音视频混流为 mp4。

🔐 加密流媒体的三种解密方式

很多课程和影视平台会对分片加密，N_m3u8DL-RE 内置解密流程，核心是给它正确的密钥：

# 1. 直接给密钥：KID:KEY 形式，KEY 相同时可直接给 KEY N_m3u8DL-RE "https://example.com/encrypted.mpd" --key "KID1:KEY1" # 2. 密钥较多时从文件加载，按 KID 自动匹配 N_m3u8DL-RE "https://example.com/protected.mpd" --key-text-file keys.txt # 3. 手动指定 HLS 加密方式、KEY 与 IV N_m3u8DL-RE "https://example.com/stream.m3u8" \ --custom-hls-method AES_128 \ --custom-hls-key "<HEX或Base64>" \ --custom-hls-iv "<HEX或Base64>"

--key和--key-text-file可重复、可混合使用；解密实际由 mp4decrypt / shaka-packager / FFmpeg 完成，可用--decryption-engine切换。

💡 如果解密后画面正常但音画不同步或整体花屏，多半是 IV 取错了，优先检查--custom-hls-iv，而不是换解密引擎。

📹 直播录制的时长控制与回看

直播录制是它的高频场景之一，下面两条命令分别覆盖"定时停"和"从历史回看"：

# 录 2 小时自动停止，并实时合并成完整文件 N_m3u8DL-RE "https://example.com/live.m3u8" \ --live-record-limit 02:00:00 \ --live-real-time-merge # 从一小时前开始回看，录 30 分钟后混流为 MKV N_m3u8DL-RE "https://example.com/live.m3u8" \ --live-catchup 01:00:00 \ --live-record-limit 00:30:00 \ --live-real-time-merge -M format=mkv

--live-record-limit格式为HH:mm:ss；--live-catchup既支持相对时长也支持绝对日期时间。

💡 回看要求清单能提供可靠的时间信息，且起点仍在服务端回看窗口内；按完整分片下载，边界可能略有偏差。

🎚️ 按分辨率、编码与语言精准选流

默认不指定时程序按启发式选流，想精确控制就用-sv/-sa/-ss的正则过滤器：

# 只要 1080p 视频 + AAC 音轨 N_m3u8DL-RE "https://example.com/movie.m3u8" \ -sv res="1920x1080" \ -sa codecs=mp4a # 只下载中文字幕，输出为 SRT N_m3u8DL-RE "https://example.com/movie.m3u8" --sub-only -ss name="中文"

过滤器支持res、codecs、lang、name、frame、bwMin/bwMax等多种属性，组合for=best可在每组语言里取最佳轨道。

💡 正则写法注意用引号包住值，比如res="3840*"；--sub-only只保留字幕轨道，配合--sub-format SRT|VTT控制输出格式。

🛠️ 进阶与调优

速度与线程：--thread-count默认 10，大文件可调高；-R可限速（如-R 15M）。

只下载一部分：--custom-range按分片序号或时间截取，格式示例--custom-range 05:00-20:00。

批量任务：把常用参数写进 shell 脚本循环即可，常用选项也可存到配置文件（Linux 下为~/.config/N_m3u8DL-RE/config.conf），优先级为命令行 > 配置文件 > 内置默认值：

for url in "${urls[@]}"; do N_m3u8DL-RE "$url" --save-dir ./downloads --del-after-done done

--del-after-done在任务完成后清理临时文件，默认即为开启，批量任务时值得显式写出来。

❓ 常见问题

下载时遇到 403 Forbidden？服务器识别出你不是浏览器，手动补上请求头和 Cookie 即可：

N_m3u8DL-RE "https://example.com/video.m3u8" \ -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/120.0.0.0" \ --cookies cookies.txt

下载完成的文件没有声音？通常是音轨没被选中或没参与混流，加--auto-select或显式指定-sa再跑一次。

FFmpeg 合并大量分片时报错或失败？改用二进制合并，不依赖 FFmpeg，适合 TS 这类可字节拼接的分片：

N_m3u8DL-RE "https://example.com/video.m3u8" --binary-merge

下载速度明显偏慢？先提高线程数并确认超时设置匹配你的网络：

N_m3u8DL-RE "https://example.com/video.m3u8" --thread-count 16 --http-request-timeout 30

🎬 写在最后

N_m3u8DL-RE 把"解析、解密、选流、合并、录制"这些原本分散的环节收拢进一条命令行，是目前处理 MPD/M3U8/ISM 流媒体最省心的工具之一。请仅下载你拥有合法权限的内容，尊重创作者与平台的版权。更多选项细节，可参考官方文档 README.md 与 README.en.md。

【免费下载链接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/简体中文/繁體中文.项目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE