N_m3u8DL-RE 教程m3u8 下载与 HLS/DASH 解密从清单链接到完整 MP4【免费下载链接】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 清单.mpd / .m3u8 / .ism解析、下载、解密并合并为可直接播放的文件。它主要面向三类需求m3u8 加密视频下载、m3u8 直播录制定时停止、多轨音视频的 m3u8 多线程下载。适合命令行用户、运维脚本与批量归档场景。能力总览N_m3u8DL-RE 同时支持点播与直播协议与解密能力覆盖如下维度与传统单一协议下载工具的差异在表中给出。维度传统下载工具N_m3u8DL-RE适合谁协议支持通常仅单一协议DASH.mpd、HLS.m3u8、MSS.ism点播 直播多平台、多协议的内容来源解密能力需外挂解密工具内置 AES_128 / CHACHA20 等可切换 FFMPEG / MP4DECRYPT / SHAKA_PACKAGER 三种引擎需下载加密流媒体的用户直播录制多为碎片文件定时停止、回看、实时合并、管道混流直播与 IPTV 归档平台覆盖常限 WindowsWindows / Linux / macOS.NET 10.0跨平台团队自动化手动为主配置文件、PowerShell 补全、选段交互、定时启动脚本与批量任务最小可用路径获取程序。源码编译需要 .NET 10.0 SDKArch Linux 也可经 AUR 获取n-m3u8dl-re-bin。git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build src/N_m3u8DL-RE.sln -c Release编译完成后得到可执行文件若终端报编码或 ANSI 错误可在支持 ANSI 的终端如 Windows 的 cmder中运行。环境自检。doctor检查 FFmpeg 等外部工具与系统环境是否可用。N_m3u8DL-RE doctor预期看到各外部工具的版本与状态合并或混流环节依赖 FFmpeg缺失时此处会明确提示。下载第一个完整视频。下面这条命令解析清单、选择轨道并合并输出N_m3u8DL-RE https://example.com/video.m3u8 --auto-select --save-name demo --save-dir ./out预期结果./out下生成已合并、可播放的媒体文件分片默认在完成后清理--del-after-done默认开启。四项核心能力m3u8 加密流解密HLS 与 DASH 的加密内容依赖密钥。清单自带密钥信息时程序自动处理清单未给出或需要手动指定密钥时用--key传入可重复书写以覆盖多条轨道。N_m3u8DL-RE https://example.com/enc.m3u8 --key 0a5b...c8:51...f3 --decryption-engine FFMPEG预期结果分片解密后合并为明文文件引擎缺省为 MP4DECRYPT可切换为 FFMPEG 或 SHAKA_PACKAGER。参数作用取值 / 示例--key指定解密密钥可重复书写KID:KEY或共用时直接KEY--key-text-file从文件按 KID 检索 KEY文本文件不建议特大文件--decryption-engine选择解密所用第三方程序FFMPEG / MP4DECRYPT / SHAKA_PACKAGER默认 MP4DECRYPT--custom-hls-method指定 HLS 加密方式AES_128 / AES_128_ECB / CENC / CHACHA20 / SAMPLE_AES 等解密实现位于 src/N_m3u8DL-RE/Crypto/ 与 src/N_m3u8DL-RE/Util/MP4DecryptUtil.cs。直播流录制m3u8 直播录制定时停止用--live-record-limit格式HH:mm:ss--live-catchup可从回看时长或日期时间开始。N_m3u8DL-RE https://example.com/live.m3u8 --live-record-limit 02:00:00 --live-real-time-merge -M mkv预期结果录制 2 小时后自动停止并实时合并混流为 MKV。参数作用示例--live-record-limit录制时长上限到点停止00:30:00--live-real-time-merge录制时实时合并开关--live-catchup从历史时长或日期时间开始01:00:00或2026-10-10T21:00:0008:00--live-idle-timeout连续无新分片 N 秒后停止默认关闭60--live-take-count首次抓取分片数默认 1616录制管理实现位于 src/N_m3u8DL-RE/DownloadManager/。音画轨选择-sv/-sa/-ss按正则选择视频、音频、字幕轨-dv/-da/-ds去除res匹配分辨率、codecs匹配编码、forbest取最佳。N_m3u8DL-RE https://example.com/movie.m3u8 -sv res1920*:forbest -sa langen:forbest预期结果仅下载 1920 分辨率最佳视频与最佳英文音轨。子键含义示例res按分辨率正则1920*、3840*codecs按编码正则hvc1、avc1、mp4abwMin / bwMax码率区间Kbps800/1000lang按语言正则en、zhfor每语言取 best[n] / worst[n] / allbest、all更多子键见--morehelp select-video实现位于 src/N_m3u8DL-RE/Entity/StreamFilter.cs。批量任务常用选项可写入配置文件Linux/macOS~/.config/N_m3u8DL-RE/config.confWindows%APPDATA%\N_m3u8DL-RE\config.conf优先级为 命令行 配置文件 内置默认值。N_m3u8DL-RE https://example.com/video.m3u8 --config custom.conf --custom-range 05:00-20:00预期结果读取custom.conf的默认选项仅下载第 5 到 20 分钟对应的完整分片。参数作用示例--config/--no-config读取指定配置 / 不读取配置custom.conf--custom-range仅下载部分分片0-10、05:00-20:00--task-start-at指定时间后才开始yyyyMMddHHmmss--del-after-done完成后删除临时文件默认开启开关批量下载 IPTV 时直接把频道列表作为输入N_m3u8DL-RE channels.m3u --live-record-limit 00:03:00并按-sv name...:forall同时录制多个频道。排错手册报错现象常见原因一条修复命令403 Forbidden请求缺少 UA / Cookie 被拦截N_m3u8DL-RE URL -H User-Agent: Mozilla/5.0 --cookies cookies.txt视频无声轨音频轨道未被选中N_m3u8DL-RE URL --auto-selectm3u8 多线程下载慢线程数或超时不当N_m3u8DL-RE URL --thread-count 16 -mt --http-request-timeout 60需要定位失败点日志级别不足N_m3u8DL-RE URL --log-level DEBUG --log-file-path download.log403 多由服务器校验请求头或会话引起--cookies读取浏览器导出的 Netscape 格式 Cookie 文件按域名、路径、HTTPS 与有效期匹配。资源调优--thread-count默认 10、--http-request-timeout默认 100 秒、--download-retry-count默认 7。按机器规格分两档调整参数低配机器高配机器--thread-count416并发下载-mt关闭开启音、视、字幕并发--http-request-timeout60缩短以快速失败120放宽以应对弱网--download-retry-count310--tmp-dir指向剩余空间最大的磁盘指向 SSD 目录直播录制默认会在临时网络故障重试耗尽后继续等待恢复故直播场景下超时参数主要约束分片连续无数据的时间而非总时长。边界与合规以下场景 N_m3u8DL-RE 不适合建议改用对应工具或方式非流媒体直链单个mp4/mp3等直链文件直接用常规 HTTP 下载客户端即可。系统级 DRMWidevine、FairPlay、PlayReady工具仅处理清单内声明的 AES_128 / CHACHA20 等密钥不含 DRM 授权流程。必须浏览器环境取址的平台地址需在浏览器会话中获取时工具无法自动完成需先手动取得清单链接再传入。请遵守所在地法律法规仅下载拥有合法权限的内容本工具按 MIT 协议原样提供使用责任由使用者承担。参数与行为的准确描述以 README.md 为准核心实现见 src/N_m3u8DL-RE/、解析器 src/N_m3u8DL-RE.Parser/ 与公共层 src/N_m3u8DL-RE.Common/。从一条 m3u8 链接开始先跑通最小可用路径再按章节逐项加参数。【免费下载链接】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），仅供参考