N_m3u8DL-RE 流媒体下载实战教程:3 步搞定 M3U8 下载与直播录制
2026/9/19 2:26:22 网站建设 项目流程

N_m3u8DL-RE 流媒体下载实战教程:3 步搞定 M3U8 下载与直播录制

【免费下载链接】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(MPD)、HLS(M3U8)、MSS(ISM)清单,点播和直播都能下
  • 加密流下载:指定密钥后自动调用 mp4decrypt / shaka-packager / ffmpeg 解密
  • 多条音频、视频、字幕轨道可并发下载,混流成一个 mp4 或 mkv
  • 直播录制支持时长限制、实时合并、管道实时混流
  • 界面支持英文、简体中文、繁体中文(--ui-language

两步装好程序

最短路径是源码编译,三条命令即可:

git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE cd N_m3u8DL-RE dotnet build src/N_m3u8DL-RE.sln -c Release

完成后可执行文件在src/N_m3u8DL-RE/bin/Release/net10.0/目录下,拷到 PATH 中即可直接用命令名调用。

一条命令下 M3U8

N_m3u8DL-RE "https://example.com/stream/index.m3u8" --save-name "我的视频"
  • 第一个参数是清单地址(也支持本地清单文件路径)
  • --save-name指定输出文件名,文件默认落在当前目录

运行后程序会打印轨道列表,选定轨道后按分片并发下载、自动合并,结束后在输出目录看到成片即可。

常用参数速查

参数用途示例
--save-name指定输出文件名--save-name "我的视频"
--key加密流解密密钥--key KID1:KEY1
-sv / -sa选视频 / 音频轨道-sv best -sa best
-M混流容器-M format=mp4
--live-record-limit直播录制时长上限--live-record-limit 01:00:00
-H附加 HTTP 请求头-H "Cookie: xxx"

实战场景

直播录制:时长限制怎么设

目标:录 1 小时直播。命令后追加--live-record-limit 01:00:00,到点自动停止,时长判断逻辑见直播录制管理器。想让文件在录制中就能播放,再加--live-real-time-merge

加密流下载:密钥怎么传

目标:下载 CENC/AES 加密流。KID 与 KEY 成对时用多个--key KID:KEY;全部分片同一把密钥直接--key KEY。外部解密程序可用--decryption-engine切换(MP4DECRYPT / SHAKA_PACKAGER / FFMPEG),底层算法实现见AES 解密工具。

音视频质量怎么选

目标:挑最清晰的画面和音质。-sv best -sa best即取各自最佳轨道;只想要 4K HEVC 就写-sv res="3840*":codecs=hvc1:for=best。筛选条件支持按分辨率、编码、语言、带宽正则匹配。

避坑速查

  • 老 Windows 终端报错或乱码:程序用 ANSI 渲染输出,旧终端不支持。换 cmder 或 Windows Terminal 再跑。
  • -mt改不了输出格式:当前版本-mt--concurrent-download的缩写,和格式无关;容器要用-M format=mp4。别照抄旧教程。
  • 直播管道混流丢分片--live-pipe-mux的数据读取由 ffmpeg 负责,网络不稳时容易丢直播数据;重要录制关掉它,走普通录后合并。
  • 解出来不能播放:多数是密钥没给或 KID 不匹配。对照日志里的 KID,用--key KID:KEY重新传入。

收尾

记住--save-name--key-sv/-sa-M这几个参数,日常 M3U8 点播、MPD 多轨混流、直播限时录制基本都覆盖了。最新发行版和更新记录以官方仓库(上方 clone 地址)为准。

【免费下载链接】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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询