使用文档

安装指南

GDownload 为 Windows、macOS 与 Linux 提供开箱即用的安装包，均可在 GitHub Releases 免费下载。

Windows

1. 下载 Windows 安装包（.exe）。
2. 双击运行安装程序，按提示完成安装；支持用户级安装，无需管理员权限即可安装到当前用户目录。
3. 安装完成后，从开始菜单启动 GDownload 即可。

macOS

1. 下载 Universal 版 DMG 安装包，同时支持 Apple Silicon 与 Intel 机型。
2. 打开 DMG 后，将 GDownload 拖入 Applications（应用程序）文件夹完成安装。
3. 首次打开如果提示"无法验证开发者"，右键（或按住 Control 点击）应用图标选择"打开"并在弹窗中再次确认即可；如果没有出现该选项，也可以前往 系统设置→隐私与安全性，在提示下方点击"仍要打开"。

Linux

1. 下载对应架构的 AppImage 文件。
2. 在终端为文件添加可执行权限：chmod +x gdownload-linux-*.AppImage。
3. 双击或在终端直接运行该文件即可启动，无需安装；较老的发行版如果提示缺少 FUSE，需要先安装 libfuse2 依赖包。

快速上手

安装完成后，几分钟内就能上手 GDownload 的核心操作。

1. 新建任务：在主界面粘贴下载链接，或者直接把种子文件拖入窗口即可创建下载任务。
2. 任务分类视图：按"全部""下载中""已完成"对任务分类展示，方便在大量任务中快速定位目标任务。
3. 暂停、恢复与限速：单个任务或全部下载都可以随时暂停和恢复，并设置限速，避免下载占满带宽影响其他网络使用。
4. 深浅主题切换：点击导航栏的主题按钮，即可在浅色与深色主题之间切换，选择会自动保存。
5. 界面语言设置：在设置中可以选择简体中文、繁體中文、English、日本語、한국어 五种界面语言。

浏览器扩展

GDownload 的浏览器扩展会随桌面安装包一起内置，不需要另外到浏览器商店搜索下载。

1. 安装并打开桌面版 GDownload，扩展已经内置在安装包中。
2. 打开 GDownload 内的扩展引导页。
3. 按照页面提示，在 Chrome、Edge 或 Firefox 中完成扩展的安装与配对；配对通过 Native Messaging 自动完成注册，不需要手动配置。

配对成功后，浏览器中的网页下载会被自动接管并交给 GDownload 处理，同时支持网页媒体嗅探与批量链接抓取。

eD2k 网络

GDownload 内置自研的 eD2k 引擎，在 eD2k 中心页提供三个子页。

搜索

支持服务器搜索与 Kad（去中心化网络）搜索两种方式；使用 Kad 搜索前需要等待 Kad 网络引导就绪。

服务器

列出可用的 eD2k 服务器，可以手动连接或断开；也可以从 URL 更新服务器列表（server.met），获取最新的服务器信息。

分享

管理本地共享目录，并查看上传统计数据。

除了搜索，也可以直接粘贴 ed2k:// 链接新建下载任务，不需要先搜索。设置页面中可以配置昵称、端口、Kad 网络开关、协议混淆与自动连接等选项。

网盘链接解析

1. 把网盘分享链接粘贴到 GDownload 中，目前支持包括百度网盘在内的 5 家网盘。
2. 客户端会自动解析该链接。
3. 解析成功后，在文件列表中勾选需要的文件即可下载。

网盘的分享接口可能会随时间调整，因此网盘解析被做成了独立插件：可以在应用内的插件市场检查更新，安装或升级到对应网盘的最新解析插件，保持解析成功率。

插件配置教程

部分网盘插件需要填写登录凭据（Cookie / Token）才能下载，详见各插件的分步配置教程：

• 百度网盘：获取 Cookie
• 夸克网盘：获取 Cookie
• 阿里云盘：获取 refresh_token
• 123 云盘：获取登录 Token

常见问题