★ FEATURED ARTICLE 简介面向经常使用百度网盘网页版、希望绕开客户端与非会员速度限制的用户这份“百度网盘直接下载助手”用户脚本可解析页面文件信息并获取真实直链配合Tampermonkey或Greasemonkey等脚本管理器即可在浏览器中直接触发下载。资源为zip压缩包内部仅一个.user.js脚本文件整包大小仅15KB体积小巧、单文件结构轻量无需额外依赖适合已有浏览器脚本环境的用户直接加载与阅读。截至目前已有10525人浏览学习热度可观反映出非会员下载限速的痛点相当普遍。脚本内容完整演示了如何用JavaScript操作网页DOM、发送或模拟HTTP请求并解析出文件直链地址同时覆盖了脚本运行机制、下载触发逻辑与安全权限边界阅读源码既能理解百度网盘网页版的资源获取原理也可作为研究浏览器用户脚本与自动化下载流程的迷你实例。需要提醒的是绕过平台限制可能存在违反使用条款的风险使用时应关注账号安全与相关规则。1. 百度网盘直接下载助手.user.js一个脚本解决非会员下载慢的实操笔记做资源归档和软件测试这些年我手里攒了几百份几十 GB 的资料包几乎全躺在百度网盘里。最头疼的不是文件多而是每次要下载都得开客户端不开客户端就得忍受几十 KB/s 的网页下载速度。后来圈子里的同行给我推荐了百度网盘直接下载助手.user.js 这个用户脚本装上之后确实能拿到文件直链让浏览器或下载工具直接接管下载等于绕开了官方客户端的限速链路。这篇笔记就是围绕这个脚本拆出来的它是什么原理、怎么安装配置、有哪些坑以及怎么批量验证直链是否有效。适合被百度网盘下载速度折磨的普通用户也适合需要批量转存资源、对下载链路有自查习惯的从业者。2. 直链下载的底层逻辑为什么一个 .user.js 能拿到真实下载地址2.1 用户脚本的运行环境Tampermonkey 注入的是什么在浏览器里普通网页 JavaScript 只能操作当前页面自身的 DOM 和发送同源请求跨域请求会受 CORS 限制。而 .user.js 脚本跑在 Tampermonkey 或 Greasemonkey 这类用户脚本管理器里它通过扩展的grant GM_xmlhttpRequest能力可以绕过页面同源策略发起跨域请求。百度网盘网页版在用户点击下载按钮时内部逻辑会先请求一个api/disk/api/download接口服务器返回一个带签名和过期时间的直链 URL前端再把直链塞给浏览器或唤起客户端。非会员状态下网页端会判定vip字段为0然后故意慢速输出或者要求安装客户端。脚本做的事就是拦截这个流程当你在网盘页面点击下载时它提前调用接口拿到直链把dlink参数直接呈现出来或触发浏览器下载。这里有个关键点脚本并不是去破解百度网盘的加密算法它只是模拟了网页端合法的下载动作拿到服务器本来就返回的直链地址。所以它的可用性取决于百度网盘前端接口变不变一旦接口参数调整脚本就会失效这时候要去看脚本是否有更新版本。// 以下为脚本核心逻辑的简化示意并非完整源码 // 拦截页面上的下载点击事件 document.addEventListener(click, function (e) { var btn e.target.closest(.download-btn); if (!btn) return; e.preventDefault(); // 读取当前文件的信息包括 fs_id、sign 等参数 var fileMeta getFileMeta(btn); // 请求百度网盘内部的下载接口 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); // 服务器返回的直链地址 var dlink data.dlink; // 直接触发浏览器下载 window.open(dlink, _self); } }); });这段代码里的GM_xmlhttpRequest是 Tampermonkey 提供的跨域请求方法普通页面脚本没有这个权限。fs_id是网盘文件在服务器上的唯一标识dlink是服务器根据sign和timestamp动态生成的直链。注意脚本只负责拿直链下载速度取决于你的网络到百度网盘 CDN 节点的物理距离和链路质量。2.2 脚本类型与适用边界.user.js 和客户端、网页下载器的差异百度网盘直接下载助手.user.js 归属于用户脚本它和安装在系统层面的百度网盘客户端、以及 IDM 这类网页下载器走的路径完全不同。客户端是百度官方提供的登录后重启客户端进程官方照样限速非会员只能拿到几十 KB/s。IDM 这类下载器虽然能接管浏览器下载任务但它本质上是调用浏览器已经拿到的直链来下载——如果网页端不给出直链IDM 也拿不到。而 .user.js 脚本是在页面数据层面做文章它不等百度网盘把直链藏起来而是主动调接口把直链要出来然后交给浏览器或第三方下载器。所以它的适用边界很清晰对比项百度网盘客户端浏览器直接下载.user.js 脚本是否需要安装客户端需要不需要不需要非会员下载速度严格限速严格限速且易中断取决于 CDN 链路多数情况明显提升是否需要登录需要需要需要脚本依赖登录态获取接口权限失效风险低低中接口变更需更新脚本适合场景大文件批量上传/下载临时小文件中大型文件、批量转存后的下载我一般会在两类场景用脚本一类是别人分享的大体积压缩包转存到自己网盘后用脚本拿直链另一类是下载一些资源站提供的最新版软件镜像这类文件通常几百 MB 甚至几个 GB客户端限速简直不能忍。需要特别说明的是脚本依赖你的账号有对应文件的访问权限对于加密分享的文件还是得先输入提取码完成转存才能操作。3. 从安装到首次跑通完整配置步骤与参数说明3.1 安装 Tampermonkey 并导入脚本文件拿到压缩包解压后里面只有一个百度网盘直接下载助手.user.js文件。这个文件不能直接双击打开需要先装用户脚本管理器。Chrome 用户去应用商店装 TampermonkeyFirefox 用户装 Greasemonkey 或 Tampermonkey 都可以。安装完成后浏览器工具栏会出现 Tampermonkey 图标接下来导入脚本# 解压后确认文件内容文件头部应该有 // UserScript 元信息块 head -n 30 百度网盘直接下载助手.user.js正常会看到类似这样的头部元数据// UserScript // name 百度网盘直接下载助手 // namespace https://example.com/ // version 1.0.0 // description 获取百度网盘直链并直接下载 // match https://pan.baidu.com/* // grant GM_xmlhttpRequest // /UserScript这里的match定义了脚本生效的页面范围grant声明了需要用到的跨域 API。如果脚本头部没有match或匹配的域名不对脚本在百度网盘页面就不会运行。打开 Tampermonkey 管理面板点击添加新脚本把 .user.js 文件里的全部内容粘贴到编辑器中按 CtrlS 保存。也可以在管理面板的工具选项卡里选择导入文件直接选中解压出的 .user.js 文件Tampermonkey 会自动解析元数据并安装。装好后确认脚本开关是开启状态这一步容易漏脚本列表里如果显示灰色就表示未启用。3.2 首次下载验证与直链参数解读脚本装完先别急着重启浏览器。打开百度网盘网页版正常登录账号随便找一个文件点击下载按钮。如果脚本生效页面上通常会多出一个获取直链或直接下载的按钮也可能在弹窗里直接显示一个长 URL。这个 URL 就是服务器返回的直链。// 典型的百度网盘直链结构 // https://d.pcs.baidu.com/file/xxxxx?fid123456789rtprgsignDSTeQexpires8htokenxxxx // 其中 sign 是签名参数expires8h 表示链接有效期为 8 小时拿到直链后建议用命令行工具做一次验证确认链接确实有效、支持断点续传# 使用 curl 测试直链是否可下载-L 跟随重定向-I 只请求头部 curl -L -I https://d.pcs.baidu.com/file/xxxxx?signxxxexpires8h # 如果返回 HTTP/1.1 200 OK 且带有 Content-Length说明直链有效 # 如果返回 403 或 401说明签名过期或权限校验失败这里需要说明几个参数的含义sign是服务器对登录态、文件 ID、时间戳做的哈希签名字段它的算法在服务端脚本无法自行伪造expires8h是链接有效期过了时间必须重新在页面触发一次获取操作Content-Length是文件大小如果下载过程中发现实际字节数和这个值对不上说明中间链路出了问题需要换用支持断点续传的下载器。我一般会把这个直链直接丢给 IDM 或 aria2 去拉比浏览器单线程下载稳得多。4. 避坑与排查手册脚本失效、下载中断、账号风控4.1 脚本突然不生效优先检查页面是否改版现象脚本安装好用了几天某天打开百度网盘页面发现获取直链按钮消失点击下载又回到官方客户端唤起逻辑。原因百度网盘不定时会调整前端页面结构和接口字段。脚本里的选择器是写死的div.download-btn或某个类名页面改版后这个类名被替换了脚本就找不到触发点。另一种原因是接口地址变了比如api/disk/api/download变成了新路径老脚本请求直接 404。解决先去 Tampermonkey 检查脚本有没有更新版本去脚本的发布页面看看作者是否已适配新版页面。如果作者停更只能自己改。打开浏览器开发者工具选中页面上的下载按钮查看实际类名把它替换到脚本的选择器代码里。接口路径变了的话同样在网络面板里抓一下下载请求的真实 URL更新脚本里的url拼装逻辑。修改脚本要小心这里涉及登录凭证改错了反而会触发账号风控。4.2 直链拿到但下载到一半断掉不要用浏览器单线程现象复制直链后直接贴到浏览器地址栏下载跑到 1.2GB 处突然停止刷新后链接已失效需要重新获取。原因浏览器内置下载器对单个连接没有断点续传的重试机制遇到网络波动就死。另外expires8h只是链接的最大时长如果文件较大或者 CDN 节点负载高连接可能被中途重置。解决凡是超过 500MB 的文件不要用浏览器下载。把直链粘贴到 IDM 或 aria2 里aria2 开启断点续传和分线程下载。命令行示例# 用 aria2 下载直链开启 16 线程自动重试 aria2c -x 16 -s 16 -k 1M --file-allocationnone https://d.pcs.baidu.com/file/xxxxx?signxxxexpires8h # 参数说明 # -x 16 最大连接数 # -s 16 分片数和 -x 配合使用 # -k 1M 每片大小1MB 较均衡 # --file-allocationnone 不做预分配加快启动下载中途断了直接重跑同一条 aria2 命令它会自动检测已下载部分并续传。这是我目前验证下来最稳的方案尤其是几个 GB 的系统镜像包从来没有续传失败过。4.3 用了脚本后账号提示异常控制操作频率现象短期内反复获取直链或者一秒内连续请求多个文件的直链账号收到安全提醒甚至网页登录态被强制退出。原因脚本本质上是在模拟页面请求但正常人操作网页不会在一秒内发起几十个下载接口调用。频率太高风控就判定为脚本刷接口。解决控制节奏。每次拿直链间隔至少 10 秒以上不要写循环脚本批量去拉取。如果只是要下载整个目录的文件优先使用百度网盘官方客户端转存再针对个别大文件用脚本拿直链。只有被封过号的人才知道账号没了有多痛我现在的习惯是下载任务分组执行每批不超过 5 个文件中间手动停顿一会儿。4.4 直链返回 403 错误检查登录态和链接时效现象点击获取直链按钮后脚本弹出一个 URL复制到新窗口打开显示 403 Forbidden。原因403 分两种情况。一是直链里的sign参数绑定的是当时登录会话的BDUSS凭证如果脚本从页面上下文拿到的登录态失效——比如在另一个设备上登录挤掉了当前会话——签名就验不过。二是直链确实过期了expires8h指的是从获取时刻起算不是从下载时刻起算拿到 URL 后磨蹭了几个小时再下载自然 403。解决刷新百度网盘页面确认网页右上角头像仍显示登录状态重新触发一次获取直链确保 sign 是最新的。获取后尽快丢给下载器拉取不要囤链接。囤链接这个习惯我吃过亏后来都采用现取现下的方式宁可多花一次获取的功夫也不拿一个已经失效的 URL 硬磕。4.5 脚本在 Firefox 上无反应检查 grant 与跨域权限策略现象同一条 .user.js 在 Chrome 上正常换到 Firefox 上就完全没反应控制台也没有报错。原因Greasemonkey 4.x 之后的版本对GM_xmlhttpRequest的调用方式做了变更要求脚本头部必须显式声明grant GM_xmlhttpRequest且不支持grant unsafeWindow等旧写法。如果脚本是从旧版 Greasemonkey 时代流传下来的头部元数据不完整新版管理器会静默拒绝跨域请求。解决在 Tampermonkey 中打开脚本编辑器确认grant声明存在。如果用的是纯 Greasemonkey建议直接换成 Tampermonkey两个管理器对旧脚本的兼容性差距很明显。实在要在 Firefox 用 Greasemonkey就在脚本编辑器里手动补上grant GM_xmlhttpRequest再检查match是否包含https://pan.baidu.com/*这个精确匹配。5. 直链的后处理与批量验证把拿到的 URL 用出最大价值拿到直链只是第一步怎么把直链稳定地变成磁盘上的文件才是体力活。我通常会用脚本批量处理把直链逐条写入文本文件然后用 aria2 的-i参数批量下载。文本格式是一行一个 URLaria2 会自动并发拉取所有链接但是这里有个问题——并发太多会触发前文提到的风控。我个人的做法是控制并发数分批执行每批不超过 5 个 URL。# 准备一个 links.txt每行一个直链 URL然后执行 aria2c -x 8 -s 8 -k 1M --max-concurrent-downloads3 -i links.txt # 参数说明 # --max-concurrent-downloads3 同时只拉 3 个文件避免并发过高 # -i links.txt 从文件读取 URL 列表批量下载完之后还要做一次完整性校验。直链下载最怕文件字节数对不上尤其是压缩包缺几个字节可能整个包就解压失败。我习惯在下载前用curl -I拿到每个文件的Content-Length下载后对比磁盘文件实际大小和这个值。脚本方式如下# 从直链 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 (远程 $size_remote, 本地 $size_local) fi done这个校验脚本的思路很简单远程大小和本地大小不一致就标记出来重新用 aria2 续传一次。遇到那种千奇百怪的压缩包分卷用这种方式可以把下载到一半发现文件损坏的阴间问题前置——等全部下完再解压悔都来不及。再给一个进阶习惯直链里的sign参数是绑定客户端 IP 的。如果你在公司和家里切换网络同一时间获取的直链在另一个网络环境下打开可能报错。所以我现在拿直链之前会先确认自己当前网络出口 IP拿完之后立刻在当前网络下启动下载不做二次转发。百度网盘的直链相比其他网盘有个特点——它的 CDN 节点会根据你的地理区域分配不同的d.pcs.baidu.com子域名有时候直链指向的节点明显很慢我会手动把 URL 里的节点域名换成相邻区域的节点试一下比如把d.pcs.baidu.com换成nj02d.pcs.baidu.com这类带前缀的节点。这个属于玄学优化但实测偶尔能提升一截速度代价是可能报签名不匹配如果换节点报错就换回来。从那以后我每次下载网盘里的工程文件和系统镜像都强制走一遍现取直链、aria2 多线程、大小校验、文件完整性比对的流程再没出现过下载完解压失败的翻车。脚本永远只是一个入口真正决定你能不能拿到完整文件的是你有没有一套自己信得过的下载链路。希望这篇笔记能帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
