N_m3u8DL-RE 流媒体下载教程：5 分钟完成你的第一次 M3U8/DASH 下载（含加密解密与直播录制）

N_m3u8DL-RE 流媒体下载教程5 分钟完成你的第一次 M3U8/DASH 下载含加密解密与直播录制【免费下载链接】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 是一款基于 .NET 开发的跨平台流媒体下载工具支持 M3U8/HLS、MPD/DASH、ISM 三种协议可完成加密流媒体下载与解密、直播实时录制合并、断点续传等任务。本文面向只会复制粘贴命令的新手按“能力边界 → 获取程序 → 第一次下载 → 两个进阶场景 → 排错”的顺序展开读完即可独立完成一次完整的视频下载。先弄清能力边界能下什么不能下什么开始之前先明确工具能做与不能做的事避免走弯路。可以做到协议覆盖 M3U8/HLS、MPD/DASH、ISMSmooth Streaming三类播放列表以及 HTTP-TS 直播流的直接录制支持加载 IPTV 频道列表文件点播与直播兼备HLS、DASH 均支持直播并支持从指定历史时间开始的回看下载加密流媒体下载支持 AES-128、AES-128-ECB、CHACHA20、CENC、Sample-AES 等清单内加密解密通过调用 mp4decrypt、shaka-packager 或 ffmpeg 完成轨道选择按分辨率、编码、语言等正则筛选画质、音质与字幕也可只下载字幕直播录制边录边合并、限制录制时长、混流输出 MKV/MP4其他多线程下载、音视字多轨道并发、请求头与 Cookie、断点续传、配置文件做不到无法处理浏览器层面的 DRM 保护Widevine、FairPlay 等它处理的是流媒体清单自带的加密不解析网页提取视频链接只接受播放列表/MPD 直链、本地清单文件或频道列表默认的分片合并与混流依赖 FFmpeg未安装时需改用二进制合并--binary-merge解密也需相应的第三方工具纯命令行程序没有图形界面获取程序三种方式运行 N_m3u8DL-RE预编译包新手推荐到项目 Release 页下载对应系统与架构的压缩包解压即可使用。源码编译需先安装 .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产物位于src/N_m3u8DL-RE/bin/Release/net10.0/目录。Arch Linux可通过 AUR 安装yay -Syu n-m3u8dl-re-bin该源非作者维护。运行成功后先执行环境检查确认 FFmpeg 与解密工具是否齐备N_m3u8DL-RE doctor它会输出程序版本、FFmpeg 等依赖工具的状态Windows PowerShell 用户还可以用--generate-completion powershell加载内嵌补全脚本获得参数名 Tab 补全。注意部分旧版 Windows 系统自带终端可能不支持本程序可换用 cmder 等第三方终端运行。第一次 M3U8 下载从一条命令到画质选择最小命令拿到一个播放列表地址一条命令即可开始N_m3u8DL-RE https://example.com/video.m3u8程序自动解析清单、选择最佳音视频轨道、多线程下载并合并为一个完整视频文件完成后默认删除临时文件。指定保存位置与文件名想让文件按自己的命名规则存放N_m3u8DL-RE https://example.com/video.m3u8 --save-dir ./downloads --save-name 高等数学第三章文件会出现在downloads目录下扩展名由实际流类型决定可能是 mp4 或 ts。画质与音质选择源内容有多档清晰度时用-sv/-sa正则筛选N_m3u8DL-RE https://example.com/video.m3u8 -sv res1920*:forbest -sa codecsmp4a:forbestres匹配分辨率codecs匹配编码forbest表示每组语言只保留码率最高的一档更多语法可执行--morehelp select-video查看。只下载字幕只需要字幕轨道时N_m3u8DL-RE https://example.com/video.m3u8 --sub-only -ss langzh --sub-format SRT--sub-only只选取字幕轨道--sub-format指定输出 SRT 或 VTT 格式。仓库内 TestStreams.md 列有公开的测试流地址适合拿来练习。加密流媒体下载三种方式提供解密密钥流本身加密清单中出现 EXT-X-KEY 等标记时需要自行提供密钥一般从页面网络请求或平台接口中获取。方式一直接指定密钥。全片只用一个密钥时N_m3u8DL-RE https://example.com/encrypted.m3u8 --key 55c5d9f1cedfd018b75623f2565a1d29方式二KID 绑定密钥。流按分片轮换密钥时用 KID 指明对应关系N_m3u8DL-RE https://example.com/encrypted.m3u8 --key e5114f87b3e54b9faca331e6e6d646a6:55c5d9f1cedfd018b75623f2565a1d29--key可重复传入多组 KID:KEY。方式三从文件加载。密钥较多时在 keys.txt 中按行写入 KID:KEYN_m3u8DL-RE https://example.com/encrypted.m3u8 --key-text-file keys.txt --decryption-engine FFMPEG--decryption-engine决定调用 FFMPEG、MP4DECRYPT默认还是 SHAKA_PACKAGER 解密输出异常时可先尝试更换引擎。HLS 还支持--custom-hls-method、--custom-hls-key、--custom-hls-iv显式指定加密方式与密钥/IV。注意N_m3u8DL-RE 只负责使用你提供的密钥完成解密不会绕过浏览器层面的 DRM 保护。HLS 直播录制与回看最小配置边录边合并直播录制默认先保存分片加上--live-real-time-merge后边录边合并N_m3u8DL-RE https://example.com/live.m3u8 --live-real-time-merge --live-record-limit 01:30:00 -M mkv --save-name 重要会议录播--live-record-limit以 HH:mm:ss 限制录制时长到时自动停止-M mkv把音视频混流进 MKV 容器。回看补录错过了开头可以从历史时间点开始下载N_m3u8DL-RE https://example.com/live.m3u8 --live-catchup 01:00:00 --live-record-limit 00:30:00 --live-real-time-merge--live-catchup接受回看时长或日期时间此处表示从一小时前开始下载后续 30 分钟。前提是清单提供可靠时间信息且起点仍在服务端回看窗口内。如果你有 IPTV 频道列表文件直接传入即可N_m3u8DL-RE channels.m3u --live-record-limit 00:03:00并用-sv name...:forall同时匹配多个频道分别录制。注意网络不稳定时不要开启--live-pipe-mux管道实时混流到 TS 文件管道数据由 ffmpeg 读取容易丢失直播数据。录制过程中网络抖动程序按分片重试默认 7 次--download-retry-count可调重试耗尽后继续等待恢复希望直播结束后自动停录可设置--live-idle-timeout列表连续指定秒数无新分片即停止。常用参数速查重复使用的选项可写入配置文件Linux/macOS 为~/.config/N_m3u8DL-RE/config.confWindows 为%APPDATA%\N_m3u8DL-RE\config.conf命令行始终优先于配置文件。参数作用示例--save-dir/--save-name输出目录 / 文件名--save-dir ./downloads --save-name 课程03-sv/-sa/-ss正则选择视频/音频/字幕-sv res1920*:forbest--auto-select自动选择各类型最佳轨道--auto-select--thread-count下载线程数默认 10--thread-count 16-mt并发下载所选音频、视频、字幕轨道-mt--key/--key-text-file解密密钥KID:KEY/ 密钥文件--key KID:KEY--decryption-engine解密工具 FFMPEG / MP4DECRYPT / SHAKA_PACKAGER--decryption-engine FFMPEG--live-real-time-merge直播实时合并--live-real-time-merge--live-record-limit录制时长上限 HH:mm:ss--live-record-limit 01:30:00--live-catchup从指定历史时间下载--live-catchup 01:00:00--sub-only/--sub-format仅字幕 / 字幕输出格式--sub-only --sub-format SRT-H/--cookies请求头 / Cookie 文件-H User-Agent: ...--custom-range仅下载部分分片序号或时间--custom-range 05:00-20:00-M完成后混流指定容器-M formatmp4--http-request-timeoutHTTP 请求超时秒--http-request-timeout 30-R限速-R 15M--tmp-dir临时文件目录--tmp-dir /ssd/temp--log-level/--log-file-path日志级别 / 日志文件--log-level DEBUG排错速查表常见报错与处理现象可能原因处理下载报 401 / 403 Forbidden缺少请求头或 Cookie补上浏览器 UA 与 Cookie-H User-Agent: Mozilla/5.0 ... --cookies cookies.txt合并阶段提示找不到 ffmpeg未安装 FFmpeg安装 FFmpeg或改用--binary-merge二进制合并无需 FFmpeg下载速度慢、频繁超时线程不足或网络不稳--thread-count调至 4~16 并配--http-request-timeout 30临时盘慢可用--tmp-dir指向 SSD大文件中断后重下浪费未利用已有进度重跑同一条命令二进制下载任务会从本地已有文件位置继续断点续传直播录制中途断开分片请求失败内置每分片重试默认 7 次--download-retry-count可调等待网络恢复后继续直播分片 404、找不到分片分片已滑出服务端窗口调小--live-wait-time提高列表刷新频率解密后文件乱码、无法播放密钥错误或解密引擎不对核对--key/--key-text-file的 KID更换--decryption-engine程序无法启动或终端乱码缺少运行时或旧版 Windows 终端安装 .NET 10 运行时换用 cmder 等第三方终端仍无法解决时先运行N_m3u8DL-RE doctor检查环境再用--log-file-path指定日志文件查看详细过程。合规提醒N_m3u8DL-RE 基于 MIT License 开源更多参数细节可查阅 README.md 与 src/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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考