N_m3u8DL-RE 流媒体下载快速上手:5 步跑通
【免费下载链接】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 是一款跨平台流媒体下载工具,解决 MPD、M3U8、ISM 清单内容"有链接却存不下来"的问题:DASH、HLS、MSS 三种协议都支持,点播能下,直播能录,加密分片能解,界面提供英文与简繁中文。
它是怎么工作的:从链接到文件的机制速览
把它想成一位"按目录装订书页"的助手,流程分四步:
- 读取链接指向的播放清单(MPD/M3U8/ISM),列出其中的视频、音频、字幕轨道。
- 按选择条件挑轨道,解析出每个分片(segment)的具体地址。
- 多线程并发抓取分片;遇到加密分片,用内置或指定的密钥当场解密。
- 分片齐后合并、混流,输出可直接播放的 mp4、mkv 或 ts 文件。
💡 判断入口很简单:链接指向 .mpd、.m3u8、.ism 清单时走完整解析流程;指向单个媒体文件时直接下载,不经过轨道选择。
第一次使用:5 步完成首次下载
- 克隆仓库拿到源码,或到项目 Releases 页下载对应平台的压缩包:
git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE - 安装 ffmpeg 并加入 PATH,合并与混流环节依赖它。
- 跑一次
N_m3u8DL-RE --help,确认参数面板能正常输出。 - 用 TestStreams.md 里的公开测试流验证:
N_m3u8DL-RE "http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8" --save-name ocean - 到输出目录检查生成的媒体文件;默认还会写一份解析信息 json,方便核对轨道。
按任务分流的用法手册
下载点播视频
- 从网页或播放器抓到 .mpd / .m3u8 直链,作为第一个参数传入。
- 只取最佳视频轨:
N_m3u8DL-RE "链接" -sv best --save-name demo。 - 需要多音轨加字幕时,追加
-sa all -ss all,或直接用--auto-select。
💡 最易踩坑的是防盗链:报 403/401 时,用-H "Cookie: ..."把浏览器里的请求头补上,多数情况一步解决。
录制直播
- 传入直播流链接,程序自动识别为直播并持续拉取新分片。
- 加
--live-record-limit 00:30:00限制录制时长,避免无限跑。 - 网络稳定时加
--live-pipe-mux实时混流;弱网环境保持默认,录完再合并更稳。 - 分片更新节奏对不上时,用
--live-wait-time手动调整刷新间隔。
下载加密流并解密
- 从页面源码或请求中拿到 KID 与 KEY。
- 用
--key KID:KEY传入;所有分片共用一个 KEY 时可直接--key KEY。 - 解密引擎默认 MP4DECRYPT,装不了可换
--decryption-engine FFMPEG或 SHAKA_PACKAGER。 - 个别 HLS 内容加密方式特殊时,用
--custom-hls-method与--custom-hls-key显式指定。
调优与排障对照表
⚠️ 仅下载自己拥有合法权限的内容,遵守当地法规与平台条款。
| 症状 | 可能原因 | 处理方式 |
|---|---|---|
| 分片反复重试、最终失败 | 网络波动或直链过期 | 调大--http-request-timeout,--download-retry-count提到 5 |
| 速度慢、服务器报错 | 线程数过高触发限流 | --thread-count降到 4 左右,或-R 15M限速观察 |
| 合并报错、成片不能播放 | ffmpeg 缺失或路径不对 | 安装 ffmpeg,必要时用--ffmpeg-binary-path指定 |
| 直播中途丢片段 | 弱网下管道混流丢数据 | 关闭--live-pipe-mux,改为录完统一合并 |
去哪里继续深入
- 全部参数与
--morehelp详解:README.md - 协议解析与轨道选择逻辑:src/N_m3u8DL-RE.Parser/Extractor/
- 可复现的测试流清单:TestStreams.md
出问题先升级到最新版本复测,再把日志文件带上提问,多数解析或解密失败十分钟就能定位。
【免费下载链接】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),仅供参考