LinkSwift 使用文档

认识 LinkSwift

LinkSwift 是一款基于 JavaScript 开发的开源网盘直链解析工具，通过浏览器用户脚本获取受支持网盘的文件下载地址，再交由浏览器或已配置的下载工具处理。

它不是独立的 Windows 安装软件。使用前需要安装脚本猫、Tampermonkey 等脚本管理扩展。脚本仍需与网盘接口通信；使用远程 Aria2 时，还会向你配置的下载服务发送任务。

安装教程

1. 01

   准备浏览器与扩展权限

   使用 Chrome、Edge 等支持扩展的桌面浏览器。将浏览器更新至受支持版本，并允许所需扩展权限。普通手机浏览器通常不能运行用户脚本。

   
2. 02

   安装脚本管理器

   在脚本猫或 Tampermonkey 官网选择对应浏览器的扩展。完成添加后，将扩展固定到工具栏，打开管理面板并确认扩展已启用。

   
3. 03

   安装并启用 LinkSwift

   点击“下载 LinkSwift 脚本”，进入脚本管理器安装确认页，核对名称、来源、匹配网站和权限，再确认安装。在已安装脚本列表中检查 LinkSwift 已启用。按扩展提示允许用户脚本运行。

   
4. 04

   进入网盘使用

   打开受支持的网盘网页版并登录，刷新页面，选择文件后找到“下载助手”，按提示选择 API 下载、复制链接或 Aria2 下载。

   

首次使用：找到下载助手

1. 打开受支持的网盘网页版，登录你自己的账号。
2. 选择需要下载的文件；部分网盘或分享场景需要先保存到自己的网盘。
3. 找到工具栏中的“下载助手”按钮，打开 LinkSwift。
4. 根据用途选择 API 下载、复制链接或已经配置好的下载器。

按钮位置会随网盘页面和脚本版本变化。如未显示，请先刷新网页，再检查脚本与站点访问权限。

支持网盘

百度网盘正式版支持阿里云盘正式版支持夸克网盘正式版支持迅雷云盘正式版支持天翼云盘正式版支持中国移动云盘正式版支持UC 网盘正式版支持123 云盘正式版支持光鸭云盘测试版支持

浏览器下载与复制链接

在网盘中选中文件并打开下载助手，选择“API 下载”。获取可用链接后，可以通过浏览器直接下载，或将链接复制到你信任的下载工具。

1. 确认账号仍处于登录状态，且拥有文件访问权限。
2. 选择文件并打开 API 下载窗口，等待文件地址获取完成。
3. 选择下载操作，或使用复制链接功能；批量下载以当前网盘与脚本支持情况为准。

下载地址可能带有临时签名或访问凭证。请不要公开分享，也不要发送到不信任的网站。链接失效时回到网盘重新获取。

如何使用 IDM 下载

IDM 需要单独安装。先确认 IDM 可以正常创建下载任务，浏览器集成扩展已启用，并与当前浏览器兼容。

1. 打开 LinkSwift 的下载助手，根据当前版本进入 API 下载或 IDM 相关选项。
2. 如使用推送功能，先在助手设置中检查 IDM 客户端设置，并按提示完成本机配置。
3. 获取链接后选择推送到 IDM；也可以复制下载地址，在 IDM 中新建下载任务。
4. 核对文件名与保存位置，再开始下载。

如何配置 Aria2

Aria2 RPC 用于接收下载任务。使用前需在电脑、NAS 或服务器上安装并运行 Aria2，启用 RPC，并确认浏览器能够访问该服务。

1. 打开 LinkSwift 助手设置，找到 Aria2 / RPC 下载相关配置。
2. 填写服务器地址与端口。常见本机地址为 http://127.0.0.1:6800/jsonrpc；NAS 场景应替换为实际局域网地址。
3. 在 RPC Secret 中填写与 Aria2 服务配置相同的密钥，不要填写网盘密码。
4. 如脚本提供连接测试，先测试并保存。然后回到网盘选中文件，使用 Aria2 下载推送任务。
5. 在 Aria2 管理界面查看任务、保存目录和错误信息。

cURL 使用方法

在 LinkSwift 中选择复制 cURL 命令，再在本机终端执行。Windows 可使用 PowerShell 或 Windows Terminal；macOS / Linux 可使用终端。请先检查生成命令中的地址、文件名和请求头。

curl --location --output "file.zip" "https://example.com/file.zip"

Windows 如遇到命令别名问题，可以使用 curl.exe。实际下载应优先使用脚本生成的完整命令，保留必要请求头；不要向本站提交真实下载链接或凭证。

本站仅提供示例复制，不在网页中执行命令。遇到链接过期时重新获取，不要重复使用已失效的签名地址。

分享文件下载

打开分享页面后，先按网盘要求输入提取码或登录账号，再检查是否出现下载助手。若当前分享场景不支持直接下载，请先保存到自己的网盘，再在网盘文件列表中操作。

部分分享场景、文件类型、账号权限和平台策略可能影响可用功能。LinkSwift 不保证所有分享链接都可以直接下载，不会改变文件的访问权限与可见范围。

常见问题与故障排查

反馈问题时请提供浏览器、脚本管理器、LinkSwift 版本、网盘名称与可复现步骤，并遮挡账号、下载凭证和 RPC 密钥。