操手冊(cè))
N_m3u8DL-RE 完整指南流媒體下載、解密與直播錄制的實(shí)操手冊(cè)【免費(fèi)下載鏈接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/簡體中文/繁體中文.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-REN_m3u8DL-RE 是一款跨平臺(tái)的 DASH/HLS/MSS 流媒體下載工具它負(fù)責(zé)解析 MPD、M3U8、ISM 清單把點(diǎn)播視頻和直播流保存為本地文件并內(nèi)置 CENC、AES-128、ChaCha20 等加密內(nèi)容的解密能力。界面提供簡中、繁中、英文三種語言Windows 與 Linux 均可運(yùn)行。下面按裝好、下載、解密、錄直播的順序帶你把最常用的幾條路徑走通。 怎么把程序裝好并跑通第一條命令獲取可執(zhí)行文件有兩條路到項(xiàng)目 Releases 頁面下載預(yù)編譯包解壓即用或者克隆源碼自己構(gòu)建。下面這條命令完成克隆與構(gòu)建git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE dotnet build src/N_m3u8DL-RE.sln構(gòu)建成功后可執(zhí)行文件就在輸出目錄里。倉庫自帶一份公共測(cè)試流清單見 TestStreams.md從中挑一條 HLS 流來驗(yàn)證安裝是否成功N_m3u8DL-RE http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8 --save-name oceans參數(shù)很直白第一個(gè)參數(shù)是播放列表鏈接--save-name oceans指定輸出文件名。程序會(huì)先列出清單里可用的軌道再下載視頻、音頻分片并自動(dòng)合并最終得到 oceans.mp4 和一份元信息 json。注意舊版 Windows 的自帶終端可能無法完整顯示程序輸出建議換用第三方終端運(yùn)行。Arch Linux 系用戶可以從 AUR 直接安裝n-m3u8dl-re-bin發(fā)行版或n-m3u8dl-re-git開發(fā)版省去手工構(gòu)建步驟。 流媒體點(diǎn)播下載一條命令拿成本地文件手頭已有 MPD 或 M3U8 鏈接時(shí)最省事的寫法是讓程序自己挑軌道N_m3u8DL-RE 鏈接 --save-name 我的視頻 --auto-select--auto-select會(huì)自動(dòng)挑選最佳視頻、音頻、字幕軌道--save-name給出輸出文件名其余不用管。想手動(dòng)控制軌道時(shí)用-sv、-sa、-ss按正則挑選視頻、音頻、字幕。下面這條命令取 1920 級(jí)別中碼率最高的一條視頻N_m3u8DL-RE 鏈接 -sv res1920*:forbest其中res1920*匹配所有以 1920 開頭的分辨率forbest表示只保留最優(yōu)的一條音頻、字幕的寫法與它一致。同時(shí)保存多條軌道時(shí)給--save-pattern加上Resolution、Language等變量每條軌道會(huì)生成互不沖突的文件名。這一場(chǎng)景常用的輸出與性能參數(shù)--save-dir— 指定輸出目錄如--save-dir D:\Videos--tmp-dir— 臨時(shí)分片目錄如--tmp-dir C:\Temp--thread-count— 下載線程數(shù)默認(rèn) 10如--thread-count 8-R— 限速單位 Kbps 或 Mbps如-R 15M-H— 為請(qǐng)求附加請(qǐng)求頭如-H User-Agent: iOS-M— 全部完成后混流分離的音視頻如-M formatmp4--log-level— 日志級(jí)別可選 DEBUG/INFO/WARN/ERROR/OFF 加密流解密密鑰參數(shù)怎么填已經(jīng)拿到密鑰的加密流把密鑰隨命令一起傳入即可N_m3u8DL-RE 加密鏈接 --key KID:KEY --save-name 解密后的視頻--key有兩種寫法KID:KEY成對(duì)給出密鑰 ID 與密鑰如果所有軌道共用同一個(gè)密鑰直接傳KEY就行。多個(gè) KID 就重復(fù)傳多次--key密鑰條數(shù)很多時(shí)可以改用--key-text-file指向一份 KID-KEY 映射文件程序按 KID 查找對(duì)應(yīng)密鑰。解密默認(rèn)由 mp4decrypt 執(zhí)行引擎名 MP4DECRYPT--decryption-engine可切換為 FFMPEG 或 SHAKA_PACKAGER。遇到清單沒寫清加密方式的自定義 HLS AES-128還能用--custom-hls-key和--custom-hls-iv分別指定密鑰與 IV兩者都接受 HEX、Base64 或文件路徑三種形式。這一場(chǎng)景常用的參數(shù)--key— 解密密鑰KID:KEY成對(duì)或純KEY--key-text-file— KID-KEY 映射文件--decryption-engine— 解密引擎MP4DECRYPT默認(rèn)/ FFMPEG / SHAKA_PACKAGER--custom-hls-key/--custom-hls-iv— 自定義 HLS 的密鑰與 IV支持 HEX、Base64、文件 直播錄制錄多久自動(dòng)停、怎么邊錄邊合對(duì)持續(xù)開播的直播流想錄到固定時(shí)長就停用--live-record-limit指定 HH:mm:ss 格式的時(shí)長N_m3u8DL-RE 直播鏈接 --live-record-limit 01:00:00--live-record-limit 01:00:00表示錄制 1 小時(shí)后自動(dòng)停止。兩個(gè)可選的實(shí)時(shí)能力加--live-real-time-merge可以在錄制過程中邊錄邊合并省掉事后的二次合并--live-pipe-mux更進(jìn)一步把分片通過管道交給 ffmpeg 實(shí)時(shí)混出 TS 文件。警告--live-pipe-mux依賴管道傳輸網(wǎng)絡(luò)不穩(wěn)時(shí)容易丟失直播數(shù)據(jù)不確定的網(wǎng)絡(luò)環(huán)境請(qǐng)關(guān)掉它改用普通實(shí)時(shí)合并。其余常用直播參數(shù)--live-take-count— 首次獲取的分片數(shù)量默認(rèn) 16--live-wait-time— 手動(dòng)設(shè)置直播列表刷新間隔秒--live-idle-timeout— 列表連續(xù)指定秒數(shù)無新分片時(shí)停止錄制默認(rèn)關(guān)閉 想看源碼一條命令經(jīng)過哪些模塊讀源碼時(shí)跟著一條命令的數(shù)據(jù)流走最順。你敲下一條下載命令后程序依次經(jīng)過五個(gè)階段入口與參數(shù)解析從 Program.cs 啟動(dòng)加載配置文件與命令行參數(shù)CommandInvoker判斷是打印幫助還是開始任務(wù)解析實(shí)現(xiàn)在 CommandLine/。清單解析StreamExtractor按內(nèi)容類型在 Parser 工程里挑選解析器——M3U8 走 HLSExtractorMPD 走 DASHExtractor2ISM 走 MSSExtractor——輸出軌道列表、分片列表與解密信息入口在 Parser 工程各解析器位于 Extractor/。下載編排點(diǎn)播任務(wù)交給 SimpleDownloadManager 分片并發(fā)下載直播錄制交給 HTTPLiveRecordManager 輪詢清單并追加新分片統(tǒng)一在 DownloadManager/ 里調(diào)度。解密CENC、AES-128、ChaCha20 等由進(jìn)程內(nèi)實(shí)現(xiàn)與 mp4decrypt 等第三方工具協(xié)作完成代碼在 Crypto/。合并與混流分片拼成完整文件后調(diào)用 ffmpeg 或 mkvmerge 輸出 mp4/mkv核心邏輯在 MergeUtil.cs。? 常見問題顯示亂、速度慢、解密失敗Windows 終端下進(jìn)度條和顏色顯示錯(cuò)亂怎么辦舊版 Windows 自帶終端不支持程序使用的輸出方式換 cmder 等第三方終端或加--no-ansi-color去掉顏色。下載速度偏低先查什么先提高--thread-count看并發(fā)是否用滿再用-R限速觀察真實(shí)帶寬如果經(jīng)常超時(shí)調(diào)大--http-request-timeout。報(bào) 403 或分片拉取失敗多半是平臺(tái)在校驗(yàn)請(qǐng)求頭用-H傳入需要的頭如果分片 URL 必須帶上原鏈接的查詢參數(shù)啟用--append-url-params。解密失敗怎么排查先核對(duì) KID 與密鑰是否一一對(duì)應(yīng)仍不行就換一家引擎試試--decryption-engine FFMPEG。直播錄制丟數(shù)據(jù)如果開著--live-pipe-mux先懷疑它——管道模式在網(wǎng)絡(luò)不穩(wěn)時(shí)容易丟數(shù)據(jù)關(guān)掉改用實(shí)時(shí)合并即可。?? 合規(guī)提醒與小結(jié)注意請(qǐng)只下載自己有權(quán)訪問的內(nèi)容并遵守所在地區(qū)的法律法規(guī)項(xiàng)目以 LICENSE 中聲明的 MIT License 開源提供。點(diǎn)播下載、解密、直播錄制是 N_m3u8DL-RE 使用頻率最高的三條路徑本文覆蓋了它們各自的核心參數(shù)。完整參數(shù)以運(yùn)行--help的輸出和 README.md 為準(zhǔn)版本更新到項(xiàng)目 Releases 頁面獲取遇到問題和改進(jìn)建議到項(xiàng)目 Issue 區(qū)反饋?!久赓M(fèi)下載鏈接】N_m3u8DL-RECross-Platform, modern and powerful stream downloader for MPD/M3U8/ISM. English/簡體中文/繁體中文.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考