N_m3u8DL-RE 完整教程：快速上手 M3U8 流媒体下载，附常用参数速查表

N_m3u8DL-RE 完整教程快速上手 M3U8 流媒体下载附常用参数速查表【免费下载链接】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 是一款免费、跨平台的 m3u8 流媒体下载工具支持 HLSm3u8、DASHmpd、MSSism三大协议。它把在线视频拆开的成百上千个分片重新解析、并发下载、解密、合并最终直接输出一个可播放的完整视频文件。本文按装好 → 下第一个视频 → 挑轨道 → 解加密 → 录直播的顺序把最常用的五件事讲清楚。N_m3u8DL-RE 安装步骤两种方式拿到工具先说一个环境坑较低版本的 Windows 自带终端可能跑不了这个程序遇到乱码或闪退时换 cmder 这类现代终端运行即可。方式一克隆源码git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE拉取最新源码本地构建后即可使用适合想跟进最新功能的用户。方式二Arch Linux 直接从 AUR 装yay -Syu n-m3u8dl-re-bin一条命令装好稳定版想追开发版就换成n-m3u8dl-re-git。装好后在终端里敲N_m3u8DL-RE --help能看到完整的参数列表。程序按模块划分协议解析在src/N_m3u8DL-RE.Parser/下载调度在src/N_m3u8DL-RE/DownloadManager/解密相关在src/N_m3u8DL-RE/Crypto/排查问题时可以按这个目录找对应代码。M3U8 下载首次运行一条命令完成解析与合并拿到一个 m3u8 链接最小可用的命令长这样N_m3u8DL-RE https://example.com/video.m3u8 --save-dir ./downloads --save-name my_video这条命令会自动完成四件事解析播放清单、多线程下载全部分片线程数默认等于本机 CPU 线程数、合并分片、保存到./downloads目录。首次使用想练手的话可以直接从项目自带的 TestStreams.md 里挑一个公开测试流里面有点播和直播、明文和加密的完整清单。轨道选择只下你要的清晰度和语言多码率流里通常有好几档清晰度、好几条音轨全下既慢又占空间。用正则过滤就行N_m3u8DL-RE movie.mpd -sv best -sa langen:forbest -M formatmp4-sv best选码率最高的视频轨-sa langen:forbest选最佳英语音轨-M formatmp4表示下载完把分离的音视频混流成 mp4。懒得写正则时加一个--auto-select就能让程序自动挑选每种类型的最佳轨道。 如果同时下多档清晰度比如 1080p 和 720p加--save-pattern SaveName_Resolution把分辨率写进文件名输出会变成video_1920x1080.mp4这样的形式不会互相覆盖。另一个实用参数是--custom-range写05:00-20:00表示只下第 5 分钟到第 20 分钟的内容写10-表示从第 10 个分片开始下到底给长课程按章节保存特别合适。加密 M3U8 下载方法把密钥交出去很多流用了 AES-128、CENC 这类加密分片本身是密文必须提供密钥才能还原。拿到 KID 和 KEY 之后N_m3u8DL-RE encrypted.m3u8 --key eb676abbcb345e96bbcf616630f1a3da:100b6c20940f779a4589152b57d2dacb参数格式是KID:KEY当所有分片共用同一个 KEY 时也可以只填 KEY 本身。解密实际由第三方程序完成默认调用 mp4decrypt需要时用--decryption-engine切换为 FFMPEG 或 SHAKA_PACKAGER。遇到加密流时按这张清单排查确认密钥格式--key KID1:KEY1成对填写多个密钥写多个--key密钥多且长时存成文本文件后用--key-text-file让程序按 KID 自动查播放清单没写加密方式时用--custom-hls-method手动指定可选 AES_128、CENC、CHACHA20 等解密失败先确认 KID 与 KEY 是否配错对再换解密引擎试试HLS 直播录制方法实时合并与时长限制直播没有完整文件可下N_m3u8DL-RE 的录制逻辑是持续抓新分片、边录边拼N_m3u8DL-RE live.m3u8 --live-real-time-merge --live-record-limit 02:00:00 --tmp-dir ./temp--live-real-time-merge让分片下载的同时实时合并成可播放文件--live-record-limit 02:00:00录满 2 小时自动停止--tmp-dir指定临时分片的存放位置。⚠️ 还有更激进的--live-pipe-mux通过 ffmpeg 管道把数据实时混流进 TS 文件但管道读取对网络波动敏感网络不稳时容易丢数据不建议默认开启。另外录制默认会保留原始分片--live-keep-segments默认为真合并出错时还能回炉重造配合--task-start-at格式 yyyyMMddHHmmss可以定时开录。常用参数速查表与排错下载出问题时的固定流程先确认是最新版再开调试日志最后才去问人。排错命令N_m3u8DL-RE problem.m3u8 --log-level DEBUG --log-file-path ./error.log把完整调试日志写入文件解析失败、分片缺失、解密报错都能从这里定位。网络抖动的源可以把--download-retry-count从默认的 3 调大需要登录态的站点用-H Cookie: xxx补请求头。某个参数拿不准含义时--morehelp 参数名会给出该参数的专项说明完整参数列表见 README.md。参数作用默认值--thread-count下载线程数本机 CPU 线程数--download-retry-count单个分片失败后的重试次数3--http-request-timeoutHTTP 请求超时秒100--auto-select自动挑选所有类型的最佳轨道关-sv/-sa正则选择视频轨 / 音频轨—--custom-range只下载指定分片范围序号或时间点—--save-pattern命名模板支持Resolution、Language等变量—--sub-only/--sub-format只下字幕 / 字幕格式 SRT 或 VTTSRT-R/--max-speed限速如15M、100K不限--log-level日志级别 DEBUG / INFO / WARN / ERROR / OFFINFO--del-after-done完成后删除临时文件开--check-segments-count校验实际分片数与预期是否一致开打开终端从 TestStreams.md 里挑一个测试流用上面的最小命令下第一个 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），仅供参考