Skip to content

Home

Jump to bottom Edit New page
Wjavan edited this page Oct 4, 2026 · 2 revisions

FerryLink 使用文档

本文档是 README 的扩展版，补充各下载方式的细节、常见问题和故障排查。

目录

下载方式详解

FerryLink 提供 5 种下载模式，在网盘页面点击「下载助手」按钮后选择：

API 下载

直接获取文件的真实下载地址，点击链接后交给浏览器下载。每行附带：

  • 文件名（超长截断时悬停可查看完整名）
  • IDM 下载按钮（实心，主操作）
  • 复制链接按钮
  • 复制文件名按钮

百度网盘超过 50MB 的文件点击 API 链接会提示改用 IDM / Aria2 / cURL，因为百度 PCS 对大文件要求特定 User-Agent，浏览器导航无法设置。其他网盘不受此限制。

Aria 下载

生成 aria2c 命令文本，复制后粘贴到终端执行。命令已包含：

  • 多线程参数（-x 16 -s 16 -k 1M）
  • 认证头（百度带 BDUSS Cookie，迅雷/夸克带 __pus/__puus Cookie，阿里带 Referer + User-Agent）

RPC 下载

通过 JSON-RPC 协议直接推送到 Aria2 / Motrix 等 RPC 下载器。点击「推送到 RPC 下载器」按钮即可，无需复制命令。

出于安全考虑，RPC 主机只允许本机或内网地址（127.x、10.x、192.168.x、169.254.x、localhost、::1）。

cURL 下载

生成 curl 命令文本，复制后粘贴到终端执行。命令已包含认证头和 User-Agent。终端类型在设置中可选（Windows CMD / PowerShell / Linux / MacOS）。

BC 下载

生成 BitComet（比特彗星）的 bc:// 链接，点击后由 BitComet 接管下载。

各网盘下载器适配

网盘 推荐下载方式 认证方式 备注
百度网盘 IDM / Aria2 / cURL OAuth + BDUSS 大文件需 pan.baidu.com UA；浏览器直下限 50MB
阿里云盘 API / IDM OAuth Token CDN 要求浏览器 User-Agent
天翼云盘 API / IDM Cookie + MD5 签名 无特殊头
迅雷网盘 IDM / Aria2 __pus/__puus Cookie 大文件可能被服务端限速
夸克网盘 API / IDM __pus/__puus Cookie 入口按钮为白底描边样式
移动云盘 API / IDM Cookie 无特殊头

配置说明

通过油猴菜单 → 设置打开配置弹窗：

配置项 默认值 说明
RPC主机 http://localhost Aria2/Motrix RPC 地址（仅限本机/内网）
RPC端口 16800 Motrix 默认端口；Aria2 默认 6800
RPC路径 /jsonrpc JSON-RPC 路径
RPC密钥 (空) Aria2 认证密钥，没设就留空
保存路径 C: 下载文件保存目录
终端类型 自动检测 可选：CMD / PowerShell / Linux / MacOS
主题颜色 #09AAFF 7 种预设：蓝、红、紫蓝、绿、橙、粉、米

主题颜色修改后立即生效，无需刷新页面。其他配置修改后页面会自动刷新一次（history.go(0)）以重新初始化。

百度网盘下载说明

百度网盘的下载链路和其他网盘不同，需要 OAuth 授权 + BDUSS Cookie 双通道：

  1. 首次使用：脚本会自动跳转到百度 OAuth 授权页，点击「授权」后自动回到网盘页面
  2. OAuth Token：存在油猴沙箱存储中，用于获取文件下载链接
  3. BDUSS：从浏览器 Cookie 读取，用于 Aria2/cURL 命令的认证头
  4. 大文件限制：百度 PCS 对超过 50MB 的文件要求 User-Agent: pan.baidu.com，浏览器导航无法设置此头，因此浏览器直下会失败。IDM 推送时脚本会自动附加该 UA。

下载方式选择：

  • ≤ 50MB：点 API 链接，浏览器直接下载
  • > 50MB：点 IDM 按钮（脚本自动带 UA + 真实文件大小），或用 Aria2/cURL 命令

迅雷网盘下载说明

迅雷网盘的下载需要 __pus 或 __puus Cookie 认证：

  • API 下载：点链接后浏览器下载，脚本自动带 Cookie
  • IDM 下载：点 IDM 按钮，脚本自动附加 Cookie
  • Aria2/cURL：命令中已包含 Cookie 头

速度说明： 迅雷 CDN 对大流量文件可能限速。实测 5.7GB 文件浏览器和 IDM 速度相同（都不到 10KB/s，且都是单线程），8.5MB 文件可到 130KB/s。这是服务端行为，不是脚本问题。相关探究见 issue #7。

镜像节点： 迅雷有 100+ 个镜像节点（vod0007-h05-vip-lixian.xunlei.com 等），服务端选择哪个不可控。不同节点速度可能不同。

常见问题

Q: 为什么 IDM 下载只开了 8 个线程？

A: 旧版本推送链接时漏传了文件大小，IDM 拿不到总大小就无法并行切分。v1.2.1 已修复，确保 IDM 的「每任务最大连接数」设置到 32 或更高。

Q: 百度网盘点 API 链接没反应？

A: 文件超过 50MB 时浏览器无法直接下载，会弹出提示。点 IDM 按钮或用 Aria2/cURL 命令。

Q: 设置弹窗看不到 / 被遮挡？

A: 脚本已通过 target: document.body + 最高 z-index 穿透微前端遮挡。如果仍看不到，尝试刷新页面后再点设置。

Q: 下载链接过期了？

A: 各网盘直链都有时效性（通常 8 小时），过期后重新点击「下载助手」按钮获取新链接。

Q: 脚本能突破网盘限速吗？

A: 不能。脚本只解析下载链接，不修改网盘客户端或服务端行为。限速是网盘服务端策略，需要会员账号或官方客户端才能突破。

Q: 脚本安全吗？会泄露我的数据吗？

A: 脚本只在本地运行，不向任何第三方服务器发送数据。OAuth Token 和 BDUSS 存在油猴沙箱存储中，页面级 XSS 无法读取。RPC 推送只允许本机或内网地址。

故障排查

IDM 无法调用

  1. 确认 IDM 已启动
  2. 确认 IDM 版本支持本地捕获（2019 年后版本）
  3. 确认 IDM 设置中「捕获浏览器下载」或本地捕获端口（默认 1001）已开启
  4. 点 IDM 按钮后看按钮上的报错提示：
    • 「推送失败：IDM 未响应」→ IDM 未启动或端口被占
    • 按钮变红但 IDM 有任务 → 链接被 CDN 拒绝（检查 Cookie / UA）

Aria2 RPC 连接失败

  1. 确认 Aria2 已启动并开启了 RPC 服务
  2. 确认 RPC 端口正确（Motrix 默认 16800，Aria2 默认 6800）
  3. 确认 RPC 密钥匹配（Aria2 设了密钥就在脚本设置里填上）
  4. 确认 RPC 主机是本机或内网地址（脚本拒绝外网地址）

天翼网盘无法获取链接

  1. 确认已登录天翼云盘
  2. 刷新页面后重试
  3. 检查浏览器是否禁用了第三方 Cookie

迅雷/夸克 IDM 下载报「在下载过程中发生错误」

链接的 Cookie 没传过去。v1.2.2 之后的版本已修复迅雷的问题（自动附加 __pus/__puus）。如果仍报错，确认脚本版本是最新的。

Add a custom footer
Add a custom sidebar

Clone this wiki locally