簡介面向經(jīng)常使用百度網(wǎng)盤網(wǎng)頁版、希望繞開客戶端與非會(huì)員速度限制的用戶這份“百度網(wǎng)盤直接下載助手”用戶腳本可解析頁面文件信息并獲取真實(shí)直鏈配合Tampermonkey或Greasemonkey等腳本管理器即可在瀏覽器中直接觸發(fā)下載。資源為zip壓縮包內(nèi)部僅一個(gè).user.js腳本文件整包大小僅15KB體積小巧、單文件結(jié)構(gòu)輕量無需額外依賴適合已有瀏覽器腳本環(huán)境的用戶直接加載與閱讀。截至目前已有10525人瀏覽學(xué)習(xí)熱度可觀反映出非會(huì)員下載限速的痛點(diǎn)相當(dāng)普遍。腳本內(nèi)容完整演示了如何用JavaScript操作網(wǎng)頁DOM、發(fā)送或模擬HTTP請求并解析出文件直鏈地址同時(shí)覆蓋了腳本運(yùn)行機(jī)制、下載觸發(fā)邏輯與安全權(quán)限邊界閱讀源碼既能理解百度網(wǎng)盤網(wǎng)頁版的資源獲取原理也可作為研究瀏覽器用戶腳本與自動(dòng)化下載流程的迷你實(shí)例。需要提醒的是繞過平臺(tái)限制可能存在違反使用條款的風(fēng)險(xiǎn)使用時(shí)應(yīng)關(guān)注賬號(hào)安全與相關(guān)規(guī)則。1. 百度網(wǎng)盤直接下載助手.user.js一個(gè)腳本解決非會(huì)員下載慢的實(shí)操筆記做資源歸檔和軟件測試這些年我手里攢了幾百份幾十 GB 的資料包幾乎全躺在百度網(wǎng)盤里。最頭疼的不是文件多而是每次要下載都得開客戶端不開客戶端就得忍受幾十 KB/s 的網(wǎng)頁下載速度。后來圈子里的同行給我推薦了百度網(wǎng)盤直接下載助手.user.js 這個(gè)用戶腳本裝上之后確實(shí)能拿到文件直鏈讓瀏覽器或下載工具直接接管下載等于繞開了官方客戶端的限速鏈路。這篇筆記就是圍繞這個(gè)腳本拆出來的它是什么原理、怎么安裝配置、有哪些坑以及怎么批量驗(yàn)證直鏈?zhǔn)欠裼行А＿m合被百度網(wǎng)盤下載速度折磨的普通用戶也適合需要批量轉(zhuǎn)存資源、對下載鏈路有自查習(xí)慣的從業(yè)者。2. 直鏈下載的底層邏輯為什么一個(gè) .user.js 能拿到真實(shí)下載地址2.1 用戶腳本的運(yùn)行環(huán)境Tampermonkey 注入的是什么在瀏覽器里普通網(wǎng)頁 JavaScript 只能操作當(dāng)前頁面自身的 DOM 和發(fā)送同源請求跨域請求會(huì)受 CORS 限制。而 .user.js 腳本跑在 Tampermonkey 或 Greasemonkey 這類用戶腳本管理器里它通過擴(kuò)展的grant GM_xmlhttpRequest能力可以繞過頁面同源策略發(fā)起跨域請求。百度網(wǎng)盤網(wǎng)頁版在用戶點(diǎn)擊下載按鈕時(shí)內(nèi)部邏輯會(huì)先請求一個(gè)api/disk/api/download接口服務(wù)器返回一個(gè)帶簽名和過期時(shí)間的直鏈 URL前端再把直鏈塞給瀏覽器或喚起客戶端。非會(huì)員狀態(tài)下網(wǎng)頁端會(huì)判定vip字段為0然后故意慢速輸出或者要求安裝客戶端。腳本做的事就是攔截這個(gè)流程當(dāng)你在網(wǎng)盤頁面點(diǎn)擊下載時(shí)它提前調(diào)用接口拿到直鏈把dlink參數(shù)直接呈現(xiàn)出來或觸發(fā)瀏覽器下載。這里有個(gè)關(guān)鍵點(diǎn)腳本并不是去破解百度網(wǎng)盤的加密算法它只是模擬了網(wǎng)頁端合法的下載動(dòng)作拿到服務(wù)器本來就返回的直鏈地址。所以它的可用性取決于百度網(wǎng)盤前端接口變不變一旦接口參數(shù)調(diào)整腳本就會(huì)失效這時(shí)候要去看腳本是否有更新版本。// 以下為腳本核心邏輯的簡化示意并非完整源碼 // 攔截頁面上的下載點(diǎn)擊事件 document.addEventListener(click, function (e) { var btn e.target.closest(.download-btn); if (!btn) return; e.preventDefault(); // 讀取當(dāng)前文件的信息包括 fs_id、sign 等參數(shù) var fileMeta getFileMeta(btn); // 請求百度網(wǎng)盤內(nèi)部的下載接口 GM_xmlhttpRequest({ method: GET, url: https://pan.baidu.com/api/disk/api/download?fs_id fileMeta.fs_id, onload: function (res) { var data JSON.parse(res.responseText); // 服務(wù)器返回的直鏈地址 var dlink data.dlink; // 直接觸發(fā)瀏覽器下載 window.open(dlink, _self); } }); });這段代碼里的GM_xmlhttpRequest是 Tampermonkey 提供的跨域請求方法普通頁面腳本沒有這個(gè)權(quán)限。fs_id是網(wǎng)盤文件在服務(wù)器上的唯一標(biāo)識(shí)dlink是服務(wù)器根據(jù)sign和timestamp動(dòng)態(tài)生成的直鏈。注意腳本只負(fù)責(zé)拿直鏈下載速度取決于你的網(wǎng)絡(luò)到百度網(wǎng)盤 CDN 節(jié)點(diǎn)的物理距離和鏈路質(zhì)量。2.2 腳本類型與適用邊界.user.js 和客戶端、網(wǎng)頁下載器的差異百度網(wǎng)盤直接下載助手.user.js 歸屬于用戶腳本它和安裝在系統(tǒng)層面的百度網(wǎng)盤客戶端、以及 IDM 這類網(wǎng)頁下載器走的路徑完全不同。客戶端是百度官方提供的登錄后重啟客戶端進(jìn)程官方照樣限速非會(huì)員只能拿到幾十 KB/s。IDM 這類下載器雖然能接管瀏覽器下載任務(wù)但它本質(zhì)上是調(diào)用瀏覽器已經(jīng)拿到的直鏈來下載——如果網(wǎng)頁端不給出直鏈IDM 也拿不到。而 .user.js 腳本是在頁面數(shù)據(jù)層面做文章它不等百度網(wǎng)盤把直鏈藏起來而是主動(dòng)調(diào)接口把直鏈要出來然后交給瀏覽器或第三方下載器。所以它的適用邊界很清晰對比項(xiàng)百度網(wǎng)盤客戶端瀏覽器直接下載.user.js 腳本是否需要安裝客戶端需要不需要不需要非會(huì)員下載速度嚴(yán)格限速嚴(yán)格限速且易中斷取決于 CDN 鏈路多數(shù)情況明顯提升是否需要登錄需要需要需要腳本依賴登錄態(tài)獲取接口權(quán)限失效風(fēng)險(xiǎn)低低中接口變更需更新腳本適合場景大文件批量上傳/下載臨時(shí)小文件中大型文件、批量轉(zhuǎn)存后的下載我一般會(huì)在兩類場景用腳本一類是別人分享的大體積壓縮包轉(zhuǎn)存到自己網(wǎng)盤后用腳本拿直鏈另一類是下載一些資源站提供的最新版軟件鏡像這類文件通常幾百 MB 甚至幾個(gè) GB客戶端限速簡直不能忍。需要特別說明的是腳本依賴你的賬號(hào)有對應(yīng)文件的訪問權(quán)限對于加密分享的文件還是得先輸入提取碼完成轉(zhuǎn)存才能操作。3. 從安裝到首次跑通完整配置步驟與參數(shù)說明3.1 安裝 Tampermonkey 并導(dǎo)入腳本文件拿到壓縮包解壓后里面只有一個(gè)百度網(wǎng)盤直接下載助手.user.js文件。這個(gè)文件不能直接雙擊打開需要先裝用戶腳本管理器。Chrome 用戶去應(yīng)用商店裝 TampermonkeyFirefox 用戶裝 Greasemonkey 或 Tampermonkey 都可以。安裝完成后瀏覽器工具欄會(huì)出現(xiàn) Tampermonkey 圖標(biāo)接下來導(dǎo)入腳本# 解壓后確認(rèn)文件內(nèi)容文件頭部應(yīng)該有 // UserScript 元信息塊 head -n 30 百度網(wǎng)盤直接下載助手.user.js正常會(huì)看到類似這樣的頭部元數(shù)據(jù)// UserScript // name 百度網(wǎng)盤直接下載助手 // namespace https://example.com/ // version 1.0.0 // description 獲取百度網(wǎng)盤直鏈并直接下載 // match https://pan.baidu.com/* // grant GM_xmlhttpRequest // /UserScript這里的match定義了腳本生效的頁面范圍grant聲明了需要用到的跨域 API。如果腳本頭部沒有match或匹配的域名不對腳本在百度網(wǎng)盤頁面就不會(huì)運(yùn)行。打開 Tampermonkey 管理面板點(diǎn)擊添加新腳本把 .user.js 文件里的全部內(nèi)容粘貼到編輯器中按 CtrlS 保存。也可以在管理面板的工具選項(xiàng)卡里選擇導(dǎo)入文件直接選中解壓出的 .user.js 文件Tampermonkey 會(huì)自動(dòng)解析元數(shù)據(jù)并安裝。裝好后確認(rèn)腳本開關(guān)是開啟狀態(tài)這一步容易漏腳本列表里如果顯示灰色就表示未啟用。3.2 首次下載驗(yàn)證與直鏈參數(shù)解讀腳本裝完先別急著重啟瀏覽器。打開百度網(wǎng)盤網(wǎng)頁版正常登錄賬號(hào)隨便找一個(gè)文件點(diǎn)擊下載按鈕。如果腳本生效頁面上通常會(huì)多出一個(gè)獲取直鏈或直接下載的按鈕也可能在彈窗里直接顯示一個(gè)長 URL。這個(gè) URL 就是服務(wù)器返回的直鏈。// 典型的百度網(wǎng)盤直鏈結(jié)構(gòu) // https://d.pcs.baidu.com/file/xxxxx?fid123456789rtprgsignDSTeQexpires8htokenxxxx // 其中 sign 是簽名參數(shù)expires8h 表示鏈接有效期為 8 小時(shí)拿到直鏈后建議用命令行工具做一次驗(yàn)證確認(rèn)鏈接確實(shí)有效、支持?jǐn)帱c(diǎn)續(xù)傳# 使用 curl 測試直鏈?zhǔn)欠窨上螺d-L 跟隨重定向-I 只請求頭部 curl -L -I https://d.pcs.baidu.com/file/xxxxx?signxxxexpires8h # 如果返回 HTTP/1.1 200 OK 且?guī)в?Content-Length說明直鏈有效 # 如果返回 403 或 401說明簽名過期或權(quán)限校驗(yàn)失敗這里需要說明幾個(gè)參數(shù)的含義sign是服務(wù)器對登錄態(tài)、文件 ID、時(shí)間戳做的哈希簽名字段它的算法在服務(wù)端腳本無法自行偽造expires8h是鏈接有效期過了時(shí)間必須重新在頁面觸發(fā)一次獲取操作Content-Length是文件大小如果下載過程中發(fā)現(xiàn)實(shí)際字節(jié)數(shù)和這個(gè)值對不上說明中間鏈路出了問題需要換用支持?jǐn)帱c(diǎn)續(xù)傳的下載器。我一般會(huì)把這個(gè)直鏈直接丟給 IDM 或 aria2 去拉比瀏覽器單線程下載穩(wěn)得多。4. 避坑與排查手冊腳本失效、下載中斷、賬號(hào)風(fēng)控4.1 腳本突然不生效優(yōu)先檢查頁面是否改版現(xiàn)象腳本安裝好用了幾天某天打開百度網(wǎng)盤頁面發(fā)現(xiàn)獲取直鏈按鈕消失點(diǎn)擊下載又回到官方客戶端喚起邏輯。原因百度網(wǎng)盤不定時(shí)會(huì)調(diào)整前端頁面結(jié)構(gòu)和接口字段。腳本里的選擇器是寫死的div.download-btn或某個(gè)類名頁面改版后這個(gè)類名被替換了腳本就找不到觸發(fā)點(diǎn)。另一種原因是接口地址變了比如api/disk/api/download變成了新路徑老腳本請求直接 404。解決先去 Tampermonkey 檢查腳本有沒有更新版本去腳本的發(fā)布頁面看看作者是否已適配新版頁面。如果作者停更只能自己改。打開瀏覽器開發(fā)者工具選中頁面上的下載按鈕查看實(shí)際類名把它替換到腳本的選擇器代碼里。接口路徑變了的話同樣在網(wǎng)絡(luò)面板里抓一下下載請求的真實(shí) URL更新腳本里的url拼裝邏輯。修改腳本要小心這里涉及登錄憑證改錯(cuò)了反而會(huì)觸發(fā)賬號(hào)風(fēng)控。4.2 直鏈拿到但下載到一半斷掉不要用瀏覽器單線程現(xiàn)象復(fù)制直鏈后直接貼到瀏覽器地址欄下載跑到 1.2GB 處突然停止刷新后鏈接已失效需要重新獲取。原因?yàn)g覽器內(nèi)置下載器對單個(gè)連接沒有斷點(diǎn)續(xù)傳的重試機(jī)制遇到網(wǎng)絡(luò)波動(dòng)就死。另外expires8h只是鏈接的最大時(shí)長如果文件較大或者 CDN 節(jié)點(diǎn)負(fù)載高連接可能被中途重置。解決凡是超過 500MB 的文件不要用瀏覽器下載。把直鏈粘貼到 IDM 或 aria2 里aria2 開啟斷點(diǎn)續(xù)傳和分線程下載。命令行示例# 用 aria2 下載直鏈開啟 16 線程自動(dòng)重試 aria2c -x 16 -s 16 -k 1M --file-allocationnone https://d.pcs.baidu.com/file/xxxxx?signxxxexpires8h # 參數(shù)說明 # -x 16 最大連接數(shù) # -s 16 分片數(shù)和 -x 配合使用 # -k 1M 每片大小1MB 較均衡 # --file-allocationnone 不做預(yù)分配加快啟動(dòng)下載中途斷了直接重跑同一條 aria2 命令它會(huì)自動(dòng)檢測已下載部分并續(xù)傳。這是我目前驗(yàn)證下來最穩(wěn)的方案尤其是幾個(gè) GB 的系統(tǒng)鏡像包從來沒有續(xù)傳失敗過。4.3 用了腳本后賬號(hào)提示異常控制操作頻率現(xiàn)象短期內(nèi)反復(fù)獲取直鏈或者一秒內(nèi)連續(xù)請求多個(gè)文件的直鏈賬號(hào)收到安全提醒甚至網(wǎng)頁登錄態(tài)被強(qiáng)制退出。原因腳本本質(zhì)上是在模擬頁面請求但正常人操作網(wǎng)頁不會(huì)在一秒內(nèi)發(fā)起幾十個(gè)下載接口調(diào)用。頻率太高風(fēng)控就判定為腳本刷接口。解決控制節(jié)奏。每次拿直鏈間隔至少 10 秒以上不要寫循環(huán)腳本批量去拉取。如果只是要下載整個(gè)目錄的文件優(yōu)先使用百度網(wǎng)盤官方客戶端轉(zhuǎn)存再針對個(gè)別大文件用腳本拿直鏈。只有被封過號(hào)的人才知道賬號(hào)沒了有多痛我現(xiàn)在的習(xí)慣是下載任務(wù)分組執(zhí)行每批不超過 5 個(gè)文件中間手動(dòng)停頓一會(huì)兒。4.4 直鏈返回 403 錯(cuò)誤檢查登錄態(tài)和鏈接時(shí)效現(xiàn)象點(diǎn)擊獲取直鏈按鈕后腳本彈出一個(gè) URL復(fù)制到新窗口打開顯示 403 Forbidden。原因403 分兩種情況。一是直鏈里的sign參數(shù)綁定的是當(dāng)時(shí)登錄會(huì)話的BDUSS憑證如果腳本從頁面上下文拿到的登錄態(tài)失效——比如在另一個(gè)設(shè)備上登錄擠掉了當(dāng)前會(huì)話——簽名就驗(yàn)不過。二是直鏈確實(shí)過期了expires8h指的是從獲取時(shí)刻起算不是從下載時(shí)刻起算拿到 URL 后磨蹭了幾個(gè)小時(shí)再下載自然 403。解決刷新百度網(wǎng)盤頁面確認(rèn)網(wǎng)頁右上角頭像仍顯示登錄狀態(tài)重新觸發(fā)一次獲取直鏈確保 sign 是最新的。獲取后盡快丟給下載器拉取不要囤鏈接。囤鏈接這個(gè)習(xí)慣我吃過虧后來都采用現(xiàn)取現(xiàn)下的方式寧可多花一次獲取的功夫也不拿一個(gè)已經(jīng)失效的 URL 硬磕。4.5 腳本在 Firefox 上無反應(yīng)檢查 grant 與跨域權(quán)限策略現(xiàn)象同一條 .user.js 在 Chrome 上正常換到 Firefox 上就完全沒反應(yīng)控制臺(tái)也沒有報(bào)錯(cuò)。原因Greasemonkey 4.x 之后的版本對GM_xmlhttpRequest的調(diào)用方式做了變更要求腳本頭部必須顯式聲明grant GM_xmlhttpRequest且不支持grant unsafeWindow等舊寫法。如果腳本是從舊版 Greasemonkey 時(shí)代流傳下來的頭部元數(shù)據(jù)不完整新版管理器會(huì)靜默拒絕跨域請求。解決在 Tampermonkey 中打開腳本編輯器確認(rèn)grant聲明存在。如果用的是純 Greasemonkey建議直接換成 Tampermonkey兩個(gè)管理器對舊腳本的兼容性差距很明顯。實(shí)在要在 Firefox 用 Greasemonkey就在腳本編輯器里手動(dòng)補(bǔ)上grant GM_xmlhttpRequest再檢查match是否包含https://pan.baidu.com/*這個(gè)精確匹配。5. 直鏈的后處理與批量驗(yàn)證把拿到的 URL 用出最大價(jià)值拿到直鏈只是第一步怎么把直鏈穩(wěn)定地變成磁盤上的文件才是體力活。我通常會(huì)用腳本批量處理把直鏈逐條寫入文本文件然后用 aria2 的-i參數(shù)批量下載。文本格式是一行一個(gè) URLaria2 會(huì)自動(dòng)并發(fā)拉取所有鏈接但是這里有個(gè)問題——并發(fā)太多會(huì)觸發(fā)前文提到的風(fēng)控。我個(gè)人的做法是控制并發(fā)數(shù)分批執(zhí)行每批不超過 5 個(gè) URL。# 準(zhǔn)備一個(gè) links.txt每行一個(gè)直鏈 URL然后執(zhí)行 aria2c -x 8 -s 8 -k 1M --max-concurrent-downloads3 -i links.txt # 參數(shù)說明 # --max-concurrent-downloads3 同時(shí)只拉 3 個(gè)文件避免并發(fā)過高 # -i links.txt 從文件讀取 URL 列表批量下載完之后還要做一次完整性校驗(yàn)。直鏈下載最怕文件字節(jié)數(shù)對不上尤其是壓縮包缺幾個(gè)字節(jié)可能整個(gè)包就解壓失敗。我習(xí)慣在下載前用curl -I拿到每個(gè)文件的Content-Length下載后對比磁盤文件實(shí)際大小和這個(gè)值。腳本方式如下# 從直鏈 URL 中提取文件名并比較大小 for url in $(cat links.txt); do size_remote$(curl -sI $url | grep -i content-length | awk {print $2} | tr -d \r) filename$(basename $url | cut -d? -f1) size_local$(stat -c%s $filename) if [ $size_remote ! $size_local ]; then echo 文件不完整: $filename (遠(yuǎn)程 $size_remote, 本地 $size_local) fi done這個(gè)校驗(yàn)?zāi)_本的思路很簡單遠(yuǎn)程大小和本地大小不一致就標(biāo)記出來重新用 aria2 續(xù)傳一次。遇到那種千奇百怪的壓縮包分卷用這種方式可以把下載到一半發(fā)現(xiàn)文件損壞的陰間問題前置——等全部下完再解壓悔都來不及。再給一個(gè)進(jìn)階習(xí)慣直鏈里的sign參數(shù)是綁定客戶端 IP 的。如果你在公司和家里切換網(wǎng)絡(luò)同一時(shí)間獲取的直鏈在另一個(gè)網(wǎng)絡(luò)環(huán)境下打開可能報(bào)錯(cuò)。所以我現(xiàn)在拿直鏈之前會(huì)先確認(rèn)自己當(dāng)前網(wǎng)絡(luò)出口 IP拿完之后立刻在當(dāng)前網(wǎng)絡(luò)下啟動(dòng)下載不做二次轉(zhuǎn)發(fā)。百度網(wǎng)盤的直鏈相比其他網(wǎng)盤有個(gè)特點(diǎn)——它的 CDN 節(jié)點(diǎn)會(huì)根據(jù)你的地理區(qū)域分配不同的d.pcs.baidu.com子域名有時(shí)候直鏈指向的節(jié)點(diǎn)明顯很慢我會(huì)手動(dòng)把 URL 里的節(jié)點(diǎn)域名換成相鄰區(qū)域的節(jié)點(diǎn)試一下比如把d.pcs.baidu.com換成nj02d.pcs.baidu.com這類帶前綴的節(jié)點(diǎn)。這個(gè)屬于玄學(xué)優(yōu)化但實(shí)測偶爾能提升一截速度代價(jià)是可能報(bào)簽名不匹配如果換節(jié)點(diǎn)報(bào)錯(cuò)就換回來。從那以后我每次下載網(wǎng)盤里的工程文件和系統(tǒng)鏡像都強(qiáng)制走一遍現(xiàn)取直鏈、aria2 多線程、大小校驗(yàn)、文件完整性比對的流程再?zèng)]出現(xiàn)過下載完解壓失敗的翻車。腳本永遠(yuǎn)只是一個(gè)入口真正決定你能不能拿到完整文件的是你有沒有一套自己信得過的下載鏈路。希望這篇筆記能幫到你。本文還有配套的精品資源點(diǎn)擊獲取