简介这是一份名为“百度网盘直接下载助手”的用户脚本供 Tampermonkey 或 Greasemonkey 管理器加载面向需要绕过百度网盘客户端与非会员限速、直接在浏览器中完成文件下载的普通用户和脚本爱好者。脚本会解析百度网盘页面中的文件信息提取真实下载地址并借助 HTTP 请求与浏览器自带下载能力触发直链下载从而避开官方客户端或网页端的下载限制。压缩包内仅包含 1 个 .user.js 脚本文件整体约 15KB轻量易携带部署成本低对 JavaScript 基础、用户脚本运行机制及网盘下载流程有了解的读者可快速上手。目前已有 10512 人浏览学习适合经常处理百度网盘大文件下载的用户、前端脚本爱好者以及希望研究直链原理、开发自动下载脚本的开发者同时也可作为理解用户脚本如何修改网页逻辑、发起下载请求的入门案例。使用前需留意账号安全与服务条款尽量从可信来源获取脚本。1. 百度网盘直接下载助手把“限速下载”变成一条可复制的直链如果你经常从百度网盘下载大文件大概率经历过这种场景浏览器点了下载弹窗提示“下载速度慢建议安装客户端”装完客户端依然几十 KB/s或者干脆要求充值超级会员。这份百度网盘直接下载助手用户脚本解决的就是这个痛点——它不碰服务器端不破解账号也不改下载协议只是在网页端拦截浏览器自己的下载请求把百度网盘页面上那个需要客户端才能走的下载动作重写成一条普通浏览器和下载工具都能认的直链然后交给浏览器或 IDM、Aria2 这类工具去拉文件。它的落点很窄适合手头有 Tampermonkey、愿意折腾浏览器脚本的用户尤其适合频繁下载大文件、想绕开客户端限制又不想开会员的一线从业者。我第一次用这个脚本是在帮同事导一个 8GB 的 Linux 虚拟机镜像看到下载进度条从“剩余 3 天”变成“剩余 6 分钟”的那一瞬间就知道这类脚本值得反复折腾。下文按“脚本怎么跑起来 → 直链怎么拿到 → 实际情况怎么处理”这条线展开。2. 安装与调试环境先用 Tampermonkey 把脚本挂上浏览器2.1 为什么必须有个用户脚本管理器.user.js 不是一个双击就能运行的独立程序它必须寄生在浏览器的用户脚本管理器里。常见做法是安装 Tampermonkey它支持 Chrome、Edge、Firefox 这些主流浏览器Firefox 也可以用 Greasemonkey但 Tampermonkey 兼容性更好。用户脚本管理器的本质是一个中间层它在百度网盘页面加载完成后把脚本注入到页面当前的运行环境里脚本就能直接读取页面上的 DOM、拦截网络请求、甚至改写页面按钮的行为。没有这层管理器脚本文件只是躺在磁盘上的纯文本浏览器不会主动执行它。安装管理器的步骤是先到你选用的浏览器官方扩展商店搜 Tampermonkey添加扩展。装完后浏览器工具栏会多出一个类似拼图形状的图标点击图标可以看到“管理面板”“添加新脚本”等入口。接下来把项目压缩包里解压出来的“百度网盘直接下载助手.user.js”文件拖进浏览器窗口或者用管理面板里的“从 URL 安装”“导入”功能加载。导入后建议先做两步确认一是看管理面板里脚本开关是否打开二是手动刷新一遍百度网盘页面看有没有报错。# 如果你习惯用命令行先检查脚本格式可以用下面命令快速看一眼文件头 head -n 20 百度网盘直接下载助手.user.js这一步不是必须的但对排查“脚本装了没生效”很有用。脚本头部的 Metadata 块会写明name、namespace、match这些关键字段其中match定义了脚本在哪些网页上运行比如常见的*://pan.baidu.com/*或*://*.baidu.com/*如果匹配规则不对脚本就不会注入。参数说明match是脚本生效的范围白名单一定要确认它覆盖了pan.baidu.com的页面否则你在百度网盘页面点“下载”时脚本根本不会执行。加载后打开百度网盘页面按 F12 打开开发者工具在 Console 标签页里看到用户脚本管理器输出的运行日志或者页面出现一个新的“下载助手”按钮都说明挂载成功。2.2 安装后先做三个基本检查脚本装上不等于万事大吉浏览器插件市场、浏览器安全策略、页面缓存都可能把它卡住。第一确认浏览器没有禁用扩展。Chrome 和 Edge 都有“从其他来源安装的扩展可能被停用”的保护机制如果 Tampermonkey 图标变灰去扩展管理页重新启用。第二确认登录态是有效的。这个脚本的实现思路是复用你当前账号的 Cookie 去请求接口如果你的百度网盘网页版处于未登录状态脚本会拿到直链但因为鉴权失败而无法发起下载。用无痕窗口登录一遍百度网盘再测试能排除很多莫名其妙的权限问题。第三确认脚本版本没被浏览器缓存卡住。更新或替换脚本文件后需要到 Tampermonkey 管理面板里点脚本的“重置”或直接按 F5 刷新页面脚本的注入才能生效。浏览器对本地文件、扩展脚本都有缓存逻辑不要只替换了文件不刷新页面就说“脚本坏了”。3. 直链获取与下载实操从点按钮到把文件拉到本地3.1 脚本的运行原理不是破解是替代下载请求要理解这个脚本能干到什么程度得先看百度网盘网页版的下载流程。普通用户点击下载按钮时页面前端会向后端请求一个下载地址但这个地址不是直接暴露的页面代码会判断你的账号状态、可能需要调用客户端、或者给出一段带时效的链接。百度网盘网页版对非会员的下载行为做了限制常见的手段包括要求安装客户端、限制网页直链时效、甚至对某些大文件只允许通过客户端下载。这个用户脚本做的事情是在页面加载后自动读取当前文件列表里的文件 ID、文件名、大小这些元数据然后模拟一次用户主动发起的下载请求把后端返回的真实下载 URL 拦截下来或重写页面上的下载按钮。你拿到的是一个以https://d.pan.baidu.com/...开头的真实链接这个链接可以直接交给第三方下载工具去拉数据。核心实现点通常在两个请求参数上一个是sign和timestamp这类带时效的鉴权参数另一个是primaryid或文件完整路径。脚本帮你做了参数拼接和时效处理但链接本身带着有效期一般是几分钟到几小时不等。3.2 主流程操作转存文件、打开页面、点下载先说明一点这个脚本在操作上有个前提玄学——它对当前目录下直接列出的文件最稳定。对于放在多层子目录里的文件如果你直接进目录去生成直链拿到链接后下载时容易失败原因是 302 重定向过程中的 Referer 和 Cookie 不匹配。我一般会先把目标文件转存到网盘根目录或者单独建一个“下载中转”文件夹再从该目录直接点下载。具体操作路径是这样的第一步打开百度网盘网页版选中你要下载的文件或文件夹右键点击或使用顶部菜单的“转存”功能把文件放到网盘根目录。如果你要下载的文件是分享链接里看到的同样先保存到自己的网盘因为直接对分享页面的文件发起直链请求时脚本拿不到文件归属者正确的鉴权信息容易返回 403。第二步进入网盘根目录后刷新页面等到脚本注入完毕。这时你把鼠标悬停在某个文件上页面会多出一个“下载”按钮或者“获取直链”的独立入口——具体文案看脚本版本有的叫“下载助手”有的直接在“下载”按钮上增加了“直链下载”的二级菜单。第三步点击该按钮脚本会弹出一个对话框里面显示一个以https://d.pan.baidu.com/...或者https://nj12pkg...开头的链接同时可能带一个“复制链接”按钮。复制这个链接。第四步把链接交给下载工具。如果你只是偶尔下单个文件浏览器地址栏粘贴后直接回车就能开始下载。如果你有 IDM 或 Aria2把它们设置为浏览器默认的下载工具然后粘贴链接新建下载任务即可。注意链接要完整复制不要只复制到第一个符号就停链接后面的参数负责指定文件名和鉴权信息少了参数下载可能变成一个没有文件名的乱码文件。// 下面这段是演示脚本常见做法的伪代码不是脚本原码 // 目的是帮你理解它为什么能拿到直链 const fileId getSelectedFileId(); // 从页面 DOM 读文件 ID const timestamp Math.floor(Date.now() / 1000); const apiUrl /api/shared/download?primaryid${fileId}timestamp${timestamp}; fetch(apiUrl, { credentials: include }) // credentials 确保携带 Cookie .then(res res.json()) .then(data { if (data.errno 0) { // 拿到的 dlink 字段就是带时效的真实下载地址 window.navigator.clipboard.writeText(data.dlink); } });逻辑说明脚本每次生成直链时都要带上credentials: include这个参数明确要求浏览器把当前登录账号的 Cookie 一并发送否则服务端无法确认下载者身份。拿到返回数据后脚本会读取dlink字段——这个字段就是真实下载地址但它一定有时效性。注意这块脚本运行完直链就已经绑定在你当前 IP 和账号上换了网络或登录另一个账号链接大概率失效。刚才这段代码演示的是「分享文件下载」的接口场景。实际脚本里可能还会处理“转存文件下载”的接口两者鉴权方式略有不同但核心都是前端读取文件 ID后端返回带签名的跳转链接。参数说明里的primaryid就是文件的唯一 ID你要是调试时看到接口返回errno非 0优先检查这个值是不是从页面正确读出来的。很多脚本翻车都翻在定位真实文件 ID 的 DOM 选择器上——因为百度网盘前端改版频繁class 名称经常变。3.3 配合下载工具实测参数设置和限速表现拿到直链后用浏览器自带的下载功能也能下但对大文件不太友好——浏览器一旦断网就要从头再来。配合 IDM 或 Aria2可以多线程分块下载实际提速明显。如果你用 IDM建议做两件事一是确认浏览器扩展“IDM Integration Module”已启用这保证你能直接在浏览器里右键“使用 IDM 下载”二是前置设置在 IDM 的“选项 → 连接”里把“默认的最大连接数”改成 8 或 16。百度网盘直链对分块请求的包容度还不错单线程下载通常跑不满你的带宽多线程能有效榨干空闲带宽。但不要设成 32有些 CDN 节点对过高的并发会直接拒绝请求返回 403。如果你用 Aria2命令行里需要指定--referer参数这是不少人在 Aria2 下百度网盘直链时遇到的隐藏坑。aria2c -c -s 16 -x 16 -k 1M \ --refererhttps://pan.baidu.com/ \ https://d.pan.baidu.com/xxxx?signxxxtimestampxxxx参数说明-s 16指定拆成 16 个分片-x 16指定每个服务器最多开 16 条连接-k 1M是每个分片大小为 1MB。--referer非常关键百度网盘的 CDN 会校验请求来源不带 Referer 或 Referer 不是百度网盘域名的请求会被判定为盗链而返回 403。你在 IDM 里可能不用手动设置是因为它自动带了但 Aria2 这类命令行工具默认不带所以必须手动指一下。我见过有人拿着直链下载进度条趴着不动日志里全是403 Forbidden就是漏了这个参数。4. 常见问题排查与避坑脚本、直链和浏览器三方博弈4.1 现象脚本已开启但页面没有“下载助手”按钮原因最常见的是 Tampermonkey 没有实际注入脚本。这个检测起来很简单在百度网盘页面上按 F12 打开开发者工具在 Console 里输入typeof unsafeWindow如果返回undefined就说明脚本管理器没有往页面注入任何代码如果返回object说明管理器在工作但脚本可能没有匹配当前页面。还有一种情况是脚本开关虽然显示“启用”但 Tampermonkey 右上角的“启用/停用”总开关没打开。解决依次检查三处——浏览器扩展页里 Tampermonkey 是否启用、Tampermonkey 面板里脚本是否启用、match规则是否覆盖了当前网址。再不行就重新导入一遍脚本文件并强制刷新页面CtrlF5。4.2 现象直链生成成功但下载时提示 403 Forbidden原因这是最高频的翻车现场。直链生成后百度网盘服务端就已经把这个链接与你当前 IP 和账号绑定了。如果直链被分享给其他人使用或者你生成链接后切换了网络比如从公司内网切到手机热点服务端校验不通过就会拒绝请求。另外部分 CDN 节点要求请求头必须带正确的 Referer如果你直接把直链贴到浏览器新标签页里访问Referer 可能为空同样 403。解决生成直链后尽快下载切换网络后重新生成一条如果用的是 Aria2务必加上--refererhttps://pan.baidu.com/。如果 IDM 也报 403在 IDM 的“站点管理器”里为d.pan.baidu.com添加 Referer 规则。4.3 现象小文件秒下大文件下到一半就失败或速度暴跌原因直链一般是有时效的少数加密链接可能限制总流量或限制连接时长。百度网盘对超大文件比如 4GB 以上通常给出的是分片下载地址脚本拿到的可能是其中一个分片的链接如果你用单线程去请求整文件CDN 会在传输中途断开连接。解决大文件下载优先用支持断点续传和多线程的工具。Aria2 是首选因为它分片管理最稳断点续传能力强。IDM 也支持但偶尔会把任务状态搞坏——如果 IDM 里看到某个分片卡住右键任务选择“刷新下载地址”再继续。如果下到一半失败建议不要在原直链上死磕重新生成一条新直链再下因为旧链接已经失效。4.4 现象移动端浏览器上脚本完全无效原因Tampermonkey 虽然有移动版但 iOS 端的浏览器扩展机制受限Android 端的 Kiwi Browser 或 Firefox 也经常因为网页版百度网盘重定向到移动端页面而找不到桌面端 DOM。这个脚本设计时就默认桌面浏览器。解决不要在手机上折腾脚本换一个思路——在手机浏览器登录百度网盘网页版切到“桌面版网站”模式但坦白讲操作起来很痛苦。真正高效的玩法是在电脑上生成直链然后把链接发到手机上的 Aria2 或下载工具里。手机端下载用“ES 文件浏览器”或“ADM”这类支持直链下载的应用粘贴链接就能拉文件。4.5 现象脚本运行时报错提示“Cannot read properties of null”原因脚本在读取页面 DOM 元素时因为页面结构变了定位不到目标节点。百度网盘前端版本更新频繁脚本的 DOM 选择器失效是很正常的。解决检查是否有脚本更新如果没有你也可以直接拿浏览器开发者工具定位当前页面的文件列表容器手动修改脚本里的选择器。具体做法是右键文件列表区域选“检查”找到文件行最外层元素看它的 class 或># 把直链列表保存为 urls.txt每行一条然后执行 aria2c -c -s 16 -x 16 -k 1M \ --refererhttps://pan.baidu.com/ \ -i urls.txt参数说明-i是 Aria2 的输入文件参数会逐行读取链接并建立下载任务。这种方式比在网页上一个一个点“下载”高效得多而且免去浏览器弹窗干扰。只要你有现成换个变量名的需求比如从一个文件夹里挑出几十个文件再把它们的直链汇总到一起这条命令能一口气全拉回来。注意顺序很重要先刷新百度网盘页面让脚本注入再勾选文件最后点分析生成批量链接。第二件事是给“获取到的直链”做一次二次校验。拿到的直链不能直接复制就走人我会统一做三件事检查链接是否以https://d.pan.baidu.com/开头因为有些脚本返回的是跳转中间页而不是最终下载地址检查链接末尾是否带filenamexxx参数没有这个参数的链接下载后文件名会是一串乱码检查这个链接是否包含完整签名参数——如果看到链接里只有timestamp没有sign那这个链接基本废了要么是脚本解析失败了要么是文件本身无法通过网页端直链下载。// 一个快速校验直链的 JS 片段直接在浏览器 Console 里执行 const link prompt(粘贴你拿到的直链); const u new URL(link); console.log({ host: u.hostname, hasSign: u.searchParams.has(sign), hasTime: u.searchParams.has(timestamp), fileName: u.searchParams.get(filename) });这个片段的作用不是帮你提速是帮你拦截掉八成“看起来像直链其实下了也是白下”的无效操作。打印出来的hasSign如果是false就不要浪费时间下载了重新生成一条才是正路。从那以后我每次下载大型开发资源、镜像、数据集都强制走一遍这个流程转存到根目录 → 刷新页面等脚本注入 → 批量获取直链 → 校验参数 → 丢给 Aria2。这套习惯帮我省下过大量等待时间也让我绕开了不少“下载到 80% 发现链接过期”的尴尬。希望这套笔记对你有用至少让你下次看到百度网盘大文件时不用再一边盯着进度条一边怀疑人生。本文还有配套的精品资源点击获取
