N_m3u8DL-RE完整指南一条命令跑通 M3U8/MPD/ISM 流媒体下载【免费下载链接】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 是一款跨平台的命令行流媒体下载工具支持 M3U8HLS、MPDDASH、ISMMSS三种清单格式覆盖点播与直播两类场景。它把解析清单 → 选流 → 分片下载 → 解密 → 合并混流整条链路打包在一套命令里适合会用命令行、手里有流地址或密钥的个人用户和运维场景。下载前的自检清单先花一分钟确认环境能避开后面 80% 的报错可执行文件从 Release 页拿到对应平台Windows / Linux / macOS的压缩包解压即得N_m3u8DL-RE可执行文件Windows 老系统自带终端若显示异常可换用第三方终端运行网络可达浏览器能打开清单 URL 不代表命令行能访问若内容站需要登录先准备好 Cookie 或请求头依赖工具合并与混流依赖 FFmpeg自动查找或--ffmpeg-binary-path指定路径解密默认调用 mp4decrypt备选 ffmpeg、shaka-packager环境体检运行N_m3u8DL-RE doctor它会逐项检查系统、运行时和各依赖工具是否就位加--json可输出结构化结果供排查一条命令跑通完整下载以一条公开的 HLS 点播流为例仓库的 TestStreams.md 里列了一批可直接用的测试流N_m3u8DL-RE https://example.com/video.m3u8 --auto-select --save-name 我的视频这条命令依次做了四件事解析主播放列表并按每类轨道最佳自动选流多线程并发拉取所有分片将分片合并为完整文件最后把结果保存到当前目录文件名由--save-name指定。跑完你会得到一个可直接播放的文件旁边还有一份解析结果的 json。如果不想自动选流也可以交互确认去掉--auto-select程序会列出轨道让你挑选多段点播内容如含广告段默认还会弹出选段界面空格勾选、回车确认。场景配方库按想下载什么取用参数可直接替换。普通点播只挑我要的分辨率和音轨目标拿到 4K 视频 中文音轨输出 mp4。N_m3u8DL-RE URL \ -sv res3840*:forbest \ -sa langzh:forbest \ -M formatmp4 --save-name 4K视频-sv/-sa/-ss支持正则匹配分辨率res、语言lang、编码codecs、码率bwMin/bwMax等维度forbest取最优一条forall全保留。完整写法可运行N_m3u8DL-RE --morehelp select-video查看。加密内容给对密钥选对引擎目标下载 AES-128 加密的 HLS 或带 KID 的 DASH 流。N_m3u8DL-RE 加密URL \ --key KID十六进制:KEY十六进制 \ --save-name 解密后的视频关键点有三所有 KEY 相同时可直接--key KEY多路密钥用多个--key或--key-text-file文件提供引擎用--decryption-engine切换取值MP4DECRYPT默认/FFMPEG/SHAKA_PACKAGERCHACHA20 类建议走FFMPEG清单里没有写明密钥来源如 JS 里动态解时可用--custom-hls-method--custom-hls-key--custom-hls-iv手动指定加密方式与密钥--custom-hls-scope VIDEO限定只作用于视频流密钥的提取不在本工具范围内需要从网页请求或 JS 逻辑里自己拿到这是新手最常卡住的一步。直播录制限定时长实时合并目标把直播内容录 2 小时边录边合成完整文件。N_m3u8DL-RE 直播URL \ --live-real-time-merge \ --live-record-limit 02:00:00 \ --save-name 直播录制--live-record-limit到点自动停止不加录制时长则一直录到手动中断。--live-wait-time 30可手动设置清单刷新间隔秒网络波动大的线路可调大--live-idle-timeout用于连续多少秒没有新分片就自动停适合录固定节目单。直播回看从历史时间点补录目标补录一小时前开始的节目里的 30 分钟。N_m3u8DL-RE URL --live-catchup 01:00:00 --live-record-limit 00:30:00 --live-real-time-merge -M mkv--live-catchup支持回看时长或日期时间两种写法。前提是清单提供可靠的时间戳且起点仍在服务端回看窗口内否则回看会失败——这不是参数问题是源站窗口的问题。仅字幕不下载音视频目标只抓取全部中文字幕输出 SRT。N_m3u8DL-RE URL --sub-only --ss name中文:forall --sub-format SRT--sub-only关闭音视频轨道--sub-format支持 SRT 与 VTT。若还想把字幕混进已有的视频文件用工具命令N_m3u8DL-RE mux -i video.mp4 -i subtitle.srt -o output.mp4字幕时间轴默认自动修正。部分下载只要某段时间目标只下 5 分钟到 20 分钟的内容分片级保留不精确裁切。N_m3u8DL-RE URL --custom-range 05:00-20:00也可用分片序号如--custom-range 10-从第 10 片开始。多段点播里想排除广告段先--vod-list-parts查看各段编号再--vod-drop-parts 0,2-4排除。调优杠杆参数很多但真正影响效率的只有下面几个其余保持默认即可。入门必改参数作用建议--thread-count默认 10下载线程数高延迟小分片可调到 16–32本地网络无收益-mt音视频字幕并发下载多轨道多音轨字幕时必开--save-dir/--save-name输出位置与命名养成固定输出目录习惯避免污染工作区进阶可选参数作用何时改-R限速如-R 20M怕打满带宽或被源站限流时--download-retry-count默认 7单分片失败重试次数网络不稳时调大--http-request-timeout默认 100 秒单次请求超时弱网环境调大注意分片直播指定后也用作连续无数据超时--binary-merge二进制合并代替 FFmpeg 合并分片极多或 FFmpeg 合并报文件句柄问题时无需 FFmpeg 直接拼另外重复用的参数组合可以写进配置文件Linux/macOS 在~/.config/N_m3u8DL-RE/config.confWindows 在%APPDATA%\N_m3u8DL-RE\config.conf沿用命令行语法优先级为命令行 配置文件 内置默认值省去每次敲长命令的麻烦。故障定位地图按现象对号入座多数问题走前两条就能解决。清单 403 / 401或报无法解析最可能是缺 Cookie、Referer 或 User-Agent。用-H Cookie: ...手动补请求头或从浏览器导出 Netscape 格式 Cookie 文件后用--cookies cookies.txt载入确认过 URL 是否有时效参数过期需--append-url-params把查询参数透传给分片。下载成功但播放花屏 / 无声解密没做对。核对--key的十六进制完整性KEY 应为 32 位、KID 为 32 位换--decryption-engine FFMPEG重试仍失败就先用doctor确认解密工具在位、版本可用。分片反复失败、整体极慢先--doctor之外看网络换--custom-proxy或--use-system-proxy false排除代理干扰调大--download-retry-count必要时-R限速绕过源站限流。直播场景下临时断流属于正常重试耗尽后仍会等待恢复不必中途杀掉进程。FFmpeg 相关报错找不到、合并失败--ffmpeg-binary-path 完整路径显式指定分片数量巨大导致句柄报错时改--binary-merge或确认默认--ffmpeg-concat-mode LOCAL_HTTP生效该模式通过本机回环输入逐个打开分片不吃文件句柄上限。直播录着录着停了 / 一直没内容调大--live-wait-time放宽刷新节奏确认--live-catchup起点没有超出服务端回看窗口节目结束类断流属预期行为需要--live-idle-timeout控制自动停止。能力边界与下一步三件事它不擅长提前知道能省时间一是不抓取网页输入必须是清单 URL 或本地清单文件网页解析和密钥提取需要你自己完成二是不做 Widevine / FairPlay 类 DRM 解密只处理清单可见的 AES-128、CHACHA20、CENC 等密钥型加密三是直播回看依赖源站窗口窗口外无法回补。下一步建议打开 README.md 对照完整参数表重点读--morehelp列出的各选项细则从 TestStreams.md 挑一条流实测上面所有配方把参数手感建立起来遇到解析不了的清单带着doctor输出和日志去仓库 Issues 区搜同类案例或提交新 Issue想深入机制读 命令行解析 与 下载管理 两个目录的源码选流、录制、合并各阶段都清晰可查输出文章【免费下载链接】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），仅供参考 
长河君 · 2026/10/24 1:49:34 · 阅读 1.2k N_m3u8DL-RE完整指南：一条命令跑通 M3U8/MPD/ISM 流媒体下载
N_m3u8DL-RE完整指南一条命令跑通 M3U8/MPD/ISM 流媒体下载【免费下载链接】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 是一款跨平台的命令行流媒体下载工具支持 M3U8HLS、MPDDASH、ISMMSS三种清单格式覆盖点播与直播两类场景。它把解析清单 → 选流 → 分片下载 → 解密 → 合并混流整条链路打包在一套命令里适合会用命令行、手里有流地址或密钥的个人用户和运维场景。下载前的自检清单先花一分钟确认环境能避开后面 80% 的报错可执行文件从 Release 页拿到对应平台Windows / Linux / macOS的压缩包解压即得N_m3u8DL-RE可执行文件Windows 老系统自带终端若显示异常可换用第三方终端运行网络可达浏览器能打开清单 URL 不代表命令行能访问若内容站需要登录先准备好 Cookie 或请求头依赖工具合并与混流依赖 FFmpeg自动查找或--ffmpeg-binary-path指定路径解密默认调用 mp4decrypt备选 ffmpeg、shaka-packager环境体检运行N_m3u8DL-RE doctor它会逐项检查系统、运行时和各依赖工具是否就位加--json可输出结构化结果供排查一条命令跑通完整下载以一条公开的 HLS 点播流为例仓库的 TestStreams.md 里列了一批可直接用的测试流N_m3u8DL-RE https://example.com/video.m3u8 --auto-select --save-name 我的视频这条命令依次做了四件事解析主播放列表并按每类轨道最佳自动选流多线程并发拉取所有分片将分片合并为完整文件最后把结果保存到当前目录文件名由--save-name指定。跑完你会得到一个可直接播放的文件旁边还有一份解析结果的 json。如果不想自动选流也可以交互确认去掉--auto-select程序会列出轨道让你挑选多段点播内容如含广告段默认还会弹出选段界面空格勾选、回车确认。场景配方库按想下载什么取用参数可直接替换。普通点播只挑我要的分辨率和音轨目标拿到 4K 视频 中文音轨输出 mp4。N_m3u8DL-RE URL \ -sv res3840*:forbest \ -sa langzh:forbest \ -M formatmp4 --save-name 4K视频-sv/-sa/-ss支持正则匹配分辨率res、语言lang、编码codecs、码率bwMin/bwMax等维度forbest取最优一条forall全保留。完整写法可运行N_m3u8DL-RE --morehelp select-video查看。加密内容给对密钥选对引擎目标下载 AES-128 加密的 HLS 或带 KID 的 DASH 流。N_m3u8DL-RE 加密URL \ --key KID十六进制:KEY十六进制 \ --save-name 解密后的视频关键点有三所有 KEY 相同时可直接--key KEY多路密钥用多个--key或--key-text-file文件提供引擎用--decryption-engine切换取值MP4DECRYPT默认/FFMPEG/SHAKA_PACKAGERCHACHA20 类建议走FFMPEG清单里没有写明密钥来源如 JS 里动态解时可用--custom-hls-method--custom-hls-key--custom-hls-iv手动指定加密方式与密钥--custom-hls-scope VIDEO限定只作用于视频流密钥的提取不在本工具范围内需要从网页请求或 JS 逻辑里自己拿到这是新手最常卡住的一步。直播录制限定时长实时合并目标把直播内容录 2 小时边录边合成完整文件。N_m3u8DL-RE 直播URL \ --live-real-time-merge \ --live-record-limit 02:00:00 \ --save-name 直播录制--live-record-limit到点自动停止不加录制时长则一直录到手动中断。--live-wait-time 30可手动设置清单刷新间隔秒网络波动大的线路可调大--live-idle-timeout用于连续多少秒没有新分片就自动停适合录固定节目单。直播回看从历史时间点补录目标补录一小时前开始的节目里的 30 分钟。N_m3u8DL-RE URL --live-catchup 01:00:00 --live-record-limit 00:30:00 --live-real-time-merge -M mkv--live-catchup支持回看时长或日期时间两种写法。前提是清单提供可靠的时间戳且起点仍在服务端回看窗口内否则回看会失败——这不是参数问题是源站窗口的问题。仅字幕不下载音视频目标只抓取全部中文字幕输出 SRT。N_m3u8DL-RE URL --sub-only --ss name中文:forall --sub-format SRT--sub-only关闭音视频轨道--sub-format支持 SRT 与 VTT。若还想把字幕混进已有的视频文件用工具命令N_m3u8DL-RE mux -i video.mp4 -i subtitle.srt -o output.mp4字幕时间轴默认自动修正。部分下载只要某段时间目标只下 5 分钟到 20 分钟的内容分片级保留不精确裁切。N_m3u8DL-RE URL --custom-range 05:00-20:00也可用分片序号如--custom-range 10-从第 10 片开始。多段点播里想排除广告段先--vod-list-parts查看各段编号再--vod-drop-parts 0,2-4排除。调优杠杆参数很多但真正影响效率的只有下面几个其余保持默认即可。入门必改参数作用建议--thread-count默认 10下载线程数高延迟小分片可调到 16–32本地网络无收益-mt音视频字幕并发下载多轨道多音轨字幕时必开--save-dir/--save-name输出位置与命名养成固定输出目录习惯避免污染工作区进阶可选参数作用何时改-R限速如-R 20M怕打满带宽或被源站限流时--download-retry-count默认 7单分片失败重试次数网络不稳时调大--http-request-timeout默认 100 秒单次请求超时弱网环境调大注意分片直播指定后也用作连续无数据超时--binary-merge二进制合并代替 FFmpeg 合并分片极多或 FFmpeg 合并报文件句柄问题时无需 FFmpeg 直接拼另外重复用的参数组合可以写进配置文件Linux/macOS 在~/.config/N_m3u8DL-RE/config.confWindows 在%APPDATA%\N_m3u8DL-RE\config.conf沿用命令行语法优先级为命令行 配置文件 内置默认值省去每次敲长命令的麻烦。故障定位地图按现象对号入座多数问题走前两条就能解决。清单 403 / 401或报无法解析最可能是缺 Cookie、Referer 或 User-Agent。用-H Cookie: ...手动补请求头或从浏览器导出 Netscape 格式 Cookie 文件后用--cookies cookies.txt载入确认过 URL 是否有时效参数过期需--append-url-params把查询参数透传给分片。下载成功但播放花屏 / 无声解密没做对。核对--key的十六进制完整性KEY 应为 32 位、KID 为 32 位换--decryption-engine FFMPEG重试仍失败就先用doctor确认解密工具在位、版本可用。分片反复失败、整体极慢先--doctor之外看网络换--custom-proxy或--use-system-proxy false排除代理干扰调大--download-retry-count必要时-R限速绕过源站限流。直播场景下临时断流属于正常重试耗尽后仍会等待恢复不必中途杀掉进程。FFmpeg 相关报错找不到、合并失败--ffmpeg-binary-path 完整路径显式指定分片数量巨大导致句柄报错时改--binary-merge或确认默认--ffmpeg-concat-mode LOCAL_HTTP生效该模式通过本机回环输入逐个打开分片不吃文件句柄上限。直播录着录着停了 / 一直没内容调大--live-wait-time放宽刷新节奏确认--live-catchup起点没有超出服务端回看窗口节目结束类断流属预期行为需要--live-idle-timeout控制自动停止。能力边界与下一步三件事它不擅长提前知道能省时间一是不抓取网页输入必须是清单 URL 或本地清单文件网页解析和密钥提取需要你自己完成二是不做 Widevine / FairPlay 类 DRM 解密只处理清单可见的 AES-128、CHACHA20、CENC 等密钥型加密三是直播回看依赖源站窗口窗口外无法回补。下一步建议打开 README.md 对照完整参数表重点读--morehelp列出的各选项细则从 TestStreams.md 挑一条流实测上面所有配方把参数手感建立起来遇到解析不了的清单带着doctor输出和日志去仓库 Issues 区搜同类案例或提交新 Issue想深入机制读 命令行解析 与 下载管理 两个目录的源码选流、录制、合并各阶段都清晰可查输出文章【免费下载链接】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），仅供参考