N_m3u8DL-RE 完整教程快速掌握流媒體下載、加密視頻解密與直播錄制【免費(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)的流媒體下載器可以處理 MPDDASH 動(dòng)態(tài)自適應(yīng)協(xié)議、M3U8HLS 分片協(xié)議和 ISM微軟平滑流三種格式覆蓋點(diǎn)播下載與直播錄制兩大需求。它的亮點(diǎn)在于內(nèi)置了多種解密引擎能直接處理 AES-128、CENC 乃至 ChaCha20 加密的加密視頻而不是讓你拿到一堆無法播放的分片文件。只要你習(xí)慣用命令行管理任務(wù)、想把在線視頻存成本地文件這套工具就能派上用場。 從零到第一次成功安裝、驗(yàn)證、第一條命令安裝。Windows 和 macOS 用戶直接到項(xiàng)目 Release 頁面下載對(duì)應(yīng)平臺(tái)的預(yù)編譯包即可Arch Linux 系發(fā)行版可以用 AUR 一條命令裝好yay -Syu n-m3u8dl-re-bin如果你更喜歡源碼編譯也可以克隆倉庫后自行構(gòu)建.NET 項(xiàng)目源碼主體在src/N_m3u8DL-RE/git clone https://gitcode.com/GitHub_Trending/nm3/N_m3u8DL-RE驗(yàn)證。裝完后先確認(rèn)程序能正常運(yùn)行N_m3u8DL-RE --help能看到完整的參數(shù)說明列表就說明安裝成功。第一條下載命令。建議從一個(gè)公開的多碼率測(cè)試流開始跑通全流程它會(huì)同時(shí)驗(yàn)證解析、分片下載和合并三個(gè)環(huán)節(jié)N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-Clear/Manifest_1080p.mpd --save-name demo跑完后你會(huì)在輸出目錄看到demo開頭的媒體文件默認(rèn)還會(huì)生成一份解析元數(shù)據(jù) json方便核對(duì)軌道信息。更多可測(cè)試的樣例流整理在 TestStreams.md 中覆蓋 DASH、HLS、MSS、加密和直播等類型。 核心使用場景四類高頻任務(wù)直接套用加密點(diǎn)播一鍵解密遇到帶 DRM數(shù)字版權(quán)保護(hù)密鑰的 CENC 加密流時(shí)用--key傳入密鑰程序會(huì)調(diào)用內(nèi)置解密引擎還原出明文。密鑰格式為KID:KEYKID 是密鑰標(biāo)識(shí)KEY 是解密用的密鑰本體通常都能從網(wǎng)頁的授權(quán)響應(yīng)里抓到N_m3u8DL-RE https://media.axprod.net/TestVectors/v7-MultiDRM-SingleKey/Manifest_1080p_ClearKey.mpd \ --key 9eb4050de44b4802932e27d75083e266:166634c675823c235a4a9446fad52e4d \ -M formatmp4 --save-name cenc_demo--key多條軌道用不同密鑰時(shí)可以重復(fù)傳入多次所有軌道共用一把密鑰時(shí)只填 KEY 也行-M formatmp4全部下完后把音視頻混流進(jìn) MP4 容器保證能直接播放解密默認(rèn)走 mp4decrypt 引擎解密相關(guān)實(shí)現(xiàn)位于src/N_m3u8DL-RE/Crypto/目錄提示解密依賴第三方工具mp4decrypt、ffmpeg 等如果系統(tǒng)里找不到可用--decryption-binary-path指定可執(zhí)行文件全路徑。直播錄制與實(shí)時(shí)合并錄直播流時(shí)程序會(huì)循環(huán)刷新播放列表并持續(xù)追加新分片。加上實(shí)時(shí)合并選項(xiàng)后邊錄邊拼成一個(gè)可播放的文件避免攢下幾百個(gè)碎分片N_m3u8DL-RE https://cmafref.akamaized.net/cmaf/live-ull/2006350/akambr/out.mpd \ --live-real-time-merge \ --live-record-limit 00:10:00 \ --save-name live_demo--live-real-time-merge錄制過程中實(shí)時(shí)合并分片--live-record-limit錄滿 10 分鐘自動(dòng)停止防止占滿磁盤--live-wait-time可選手動(dòng)指定列表刷新間隔默認(rèn) 15 秒左右--live-pipe-mux可選通過管道加 ffmpeg 實(shí)時(shí)混流出 TS 文件警告網(wǎng)絡(luò)不穩(wěn)時(shí)不建議開--live-pipe-mux。管道內(nèi)的讀取由 ffmpeg 負(fù)責(zé)弱網(wǎng)環(huán)境下容易丟直播數(shù)據(jù)。多清晰度與音軌精準(zhǔn)選擇一個(gè)碼率階梯里往往躺著 360p 到 4K 的好幾條視頻軌、多語言音軌和字幕軌。用正則表達(dá)式式的選擇器-sv選視頻、-sa選音頻、-ss選字幕可以精確鎖定想要的組合N_m3u8DL-RE https://dash.akamaized.net/dash264/TestCases/2c/qualcomm/1/MultiResMPEG2.mpd \ -sv best -sa langen:forbest \ --save-pattern SaveName_Resolution \ --save-name multi_demo -mt -M formatmp4-sv best/-sv res3840*:codecshvc1:forbest選最佳視頻或只挑 4K 且 HEVC 編碼的軌-sa langen:forbest只挑英語音軌里質(zhì)量最好的一條多軌同時(shí)保留可用-sa all--save-pattern文件名里嵌入Resolution等變量多條流并存時(shí)不會(huì)互相覆蓋-mt音視頻字幕并發(fā)下載多軌場景提速明顯不確定選哪條時(shí)先用--auto-select讓程序替你挑各類型的最佳軌道只下載部分內(nèi)容的分片不想下完整集、只想抽某一段--custom-range支持按分片序號(hào)或按時(shí)間截取N_m3u8DL-RE http://playertest.longtailvideo.com/adaptive/oceans_aes/oceans_aes.m3u8 \ --custom-range 05:00-20:00 --save-name partial_demo05:00-20:00只下載第 5 分鐘到第 20 分鐘的分片0-10按序號(hào)下載第 0 到 10 個(gè)分片共 11 個(gè)-99只下前 100 個(gè)分片適合快速抽樣檢查畫質(zhì) 常用參數(shù)速查含義、推薦值與適用場景參數(shù)含義推薦值適用場景--thread-count下載分片用的并發(fā)線程數(shù)默認(rèn)等于 CPU 核數(shù)4~16大文件高速下載弱網(wǎng)反而可調(diào)小--download-retry-count單個(gè)分片失敗后的重試次數(shù)默認(rèn) 35~10網(wǎng)絡(luò)波動(dòng)、跨網(wǎng)下載--http-request-timeout單次 HTTP 請(qǐng)求超時(shí)秒數(shù)默認(rèn) 10030~60慢速服務(wù)器直播場景可放寬-R/--max-speed限速單位 Mbps 或 Kbps如15M按需不想占滿帶寬、掛機(jī)錄制-M/--mux-after-done全部完成后混流如formatmp4或formatmkv:muxermkvmerge視需求音視頻分離的流想直接播放--save-dir/--tmp-dir成品輸出目錄 / 分片臨時(shí)目錄各自指向剩余空間大的盤臨時(shí)盤與系統(tǒng)盤分離--save-name/--save-pattern固定文件名 / 帶變量的命名模板批量下載用 pattern多軌下載避免文件名沖突--key解密密鑰KID:KEY形式可重復(fù)傳入從授權(quán)響應(yīng)中提取CENC、AES 加密流--decryption-engine指定解密工具M(jìn)P4DECRYPT、FFMPEG、SHAKA_PACKAGER默認(rèn) MP4DECRYPT某引擎解密失敗時(shí)換引擎--live-record-limit直播錄制時(shí)長上限HH:mm:ss按計(jì)劃時(shí)長定時(shí)錄節(jié)目--live-real-time-merge直播邊錄邊合并開啟直播錄制--custom-range只下指定序號(hào)區(qū)間或時(shí)間區(qū)間的分片按需抽段、試看、補(bǔ)錄-sv/-sa/-ss正則選擇器挑視頻 / 音頻 / 字幕軌best起步多碼率流精準(zhǔn)取流-H/--header追加自定義請(qǐng)求頭可多次傳入抓包所得需要 Cookie、Referer 鑒權(quán)的站點(diǎn)--use-system-proxy/--custom-proxy走系統(tǒng)代理 / 指定代理地址代理可用時(shí)開啟需要中轉(zhuǎn)網(wǎng)絡(luò)的流--auto-select自動(dòng)挑各類型最佳軌道新手建議開不關(guān)心具體碼率的場景--log-level日志級(jí)別DEBUG、INFO、WARN等排障時(shí)用DEBUG問題定位 高頻問題排查三段式定位法問題一下載成功但視頻無法播放或報(bào)錯(cuò)現(xiàn)象進(jìn)度跑完 100%播放器打開卻是黑屏、花屏或日志里出現(xiàn)解密相關(guān)報(bào)錯(cuò)。原因密鑰格式?jīng)]寫對(duì)漏掉 KID 或?qū)懗闪?Base64或該軌道用的加密方式需要換一個(gè)解密引擎。解決命令確認(rèn)密鑰寫成KID:KEY冒號(hào)分隔并嘗試切換引擎到 ffmpegN_m3u8DL-RE 你的URL --key KID:KEY --decryption-engine FFMPEG -M formatmp4問題二頻繁超時(shí)、中斷、分片下載失敗現(xiàn)象日志反復(fù)出現(xiàn)超時(shí)或 404個(gè)別分片重試多次仍失敗最終任務(wù)中止。原因默認(rèn)重試 3 次、超時(shí) 100 秒的組合對(duì)弱網(wǎng)偏保守或者你所在的網(wǎng)絡(luò)必須經(jīng)代理才能訪問源站。解決命令拉高重試與超時(shí)上限必要時(shí)顯式走本地代理N_m3u8DL-RE 你的URL --download-retry-count 10 --http-request-timeout 60 --custom-proxy http://127.0.0.1:7890問題三解析失敗、返回 403 或分片全部 404現(xiàn)象主鏈接能打開但程序一解析就報(bào) 403或分片下載全部 404。原因服務(wù)端要求 Cookie、Referer 等請(qǐng)求頭或分片鏈接依賴主鏈接上的查詢參數(shù)而這些默認(rèn)不會(huì)帶過去。解決命令把抓包得到的請(qǐng)求頭透傳并讓分片繼承主鏈接的查詢參數(shù)N_m3u8DL-RE 你的URL -H Cookie: sid你的值 -H Referer: 你的域名 --append-url-params收尾記住三件事就能覆蓋絕大多數(shù)需求先用 TestStreams.md 里的樣例流驗(yàn)證環(huán)境再用--key加-M處理加密點(diǎn)播直播錄制則依賴--live-real-time-merge加--live-record-limit。參數(shù)拿不準(zhǔn)時(shí)跑一遍N_m3u8DL-RE --morehelp 參數(shù)名看官方詳細(xì)說明比到處翻帖子更快。完整參數(shù)清單隨時(shí)參考 README.md?！久赓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），僅供參考