Gopeed 开源下载管理器上手指南：5 分钟跑通第一个下载任务

【免费下载链接】gopeedA fast, modern download manager for HTTP, BitTorrent, Magnet, and ed2k. Cross-platform, built with Golang and Flutter.项目地址: https://gitcode.com/GitHub_Trending/go/gopeed

昨晚下的 10GB 安装包卡在 99%，重下又得从 0% 开始——这种情况你大概率遇到过。Gopeed（Go Speed，够快下载器）是一个开源的下载管理器，一个客户端同时管 HTTP、BitTorrent、磁力链接和 ed2k 四类任务，支持断点续传，桌面、手机、Web、NAS 都能跑。

📦 为什么值得装一个 Gopeed

先说它能替你解决的问题，每条都对应一个真实痛点：

• ⚡HTTP 多连接分段下载：大文件被切成多个连接并发拉取，一条宽带能跑满时它帮你跑满，默认 16 个并发连接。
• 📁磁力链接可以按文件挑：一个种子包 40 个文件，你只想要其中一个，添加任务时直接勾选，不用整包下载再删。
• 🌐浏览器下载一键接管：Chrome、Edge、Firefox 装个官方扩展，浏览器里的下载转给 Gopeed，断网了不用从头来。
• 🧩JavaScript 扩展：视频站、网盘、AI 模型站这类需要特殊解析的来源，用 JS 写个扩展就能接入，不用改核心代码。

手机和桌面是同一套任务数据，界面按设备自动布局：

桌面和手机的截图看完了，接下来花 5 分钟装上它、下完第一个文件。

⏱️ 5 分钟装好并下完第一个文件

第一步：安装

• 桌面端：从项目仓库的 Releases 页取对应系统的安装包（Windows/macOS 也有 2.0 Beta 版本，界面全面换新，想尝鲜可以装）。
• 移动端：应用商店搜 Gopeed。
• NAS / 服务器：仓库根目录自带 Dockerfile 和 docker-compose.yml，容器默认监听 9999 端口。
• 只用命令行：装了 Go 之后执行go install安装，或直接git clone https://gitcode.com/GitHub_Trending/go/gopeed后go install ./cmd/gopeed。

第二步：启动

桌面版双击就能用。命令行场景一条命令同时完成启动和下载：

gopeed -D ~/Downloads -C 16 https://example.com/file.zip

-D指定保存目录（默认当前目录），-C指定并发连接数（默认 16），进度条和实时速度直接打在终端里。

第三步：跑通第一个任务

图形界面里点"+"粘贴链接、选保存路径、开始即可。磁力链接会先弹出文件列表让你勾选，支持按分享率或时长控制做种时长。想折腾自动化的人，记得在设置里把 API 打开——REST 服务会随应用启动，端口默认 9999，配一个 token 才能调用。

跑通之后，下面三个场景是最常见的用法。

🧲 三个高频场景：续传、挑文件、接管浏览器

下载进行到一半断网了：进度存在任务数据里，断网、关机都不怕。

1. 网络恢复后打开 Gopeed，暂停中的任务保持原位；
2. 点"继续"（或启动时开启自动恢复）。

效果：从已下载的位置接着跑，不用重新排队，也不会把文件覆盖成 0 字节。

磁力种子里只要一个文件：整包下下来再删太浪费。

1. 添加磁力链接，先解析出文件列表；
2. 只勾选目标文件再启动任务；
3. 下完后按设置里的分享率或时长自动停止做种。

效果：带宽只花在你要的文件上，做种时间自己说了算，不会一直吃上传。

浏览器下载想交给 Gopeed 管：浏览器自带下载器不支持断点续传，换个网络就得重下。

1. 保持 Gopeed 在后台运行；
2. 在 Chrome、Edge 或 Firefox 装上官方扩展；
3. 点击下载时选择用 Gopeed 接管。

效果：浏览器只是入口，真正的传输和续传都在 Gopeed 里，手机上还能继续盯着进度。

会用完了，给爱折腾的人留了三个更深的玩法，都是仓库里现成的能力。

🔧 进阶玩法：CLI、REST API 和扩展开发

CLI：cmd/gopeed/ 下就是一个完整下载器，支持 HTTP 直链、.torrent文件和磁力链接，适合塞进脚本。

REST API：Web 服务默认监听 9999 端口（-P可改），开启认证时用-p设密码、-T设 API token。常用端点：POST /api/v1/tasks创建任务，PUT /api/v1/tasks/{id}/pause暂停，PUT /api/v1/tasks/{id}/continue继续。配好 token 后：

curl -H "X-Api-Token: 你的token" http://127.0.0.1:9999/api/v1/tasks

JavaScript 扩展：扩展本质是一个带manifest.json的目录，声明 URL 匹配规则和入口脚本，命中后接管解析，就能把新来源接进 Gopeed：

{ "name": "my-site", "version": "0.0.1", "scripts": [{ "event": "onResolve", "match": { "urls": ["*://example.com/*"] }, "entry": "index.js" }] }

项目自带的十几个示例扩展在 pkg/download/testdata/extensions/，抄一个改改就能跑。

❓ 上手前最常被问的 5 个问题

下载一半断网了怎么办？不用管。恢复网络后点继续即可从断点接着下，任务列表里的进度一直在。

下完的文件存在哪？建任务时指定的目录，CLI 是-D参数指定的位置；Docker 部署时把宿主机目录挂载到容器的/app/Downloads，compose 文件里有现成注释。

REST API 是默认开的吗？不是。默认关闭，需要在设置里手动开启并配置 token，避免把下载器暴露成无认证服务。

能在 NAS 上跑吗？能。仓库根目录的 Dockerfile 基于 Alpine，镜像不到 100MB 量级，docker compose up -d之后浏览器访问:9999就能用，QNAP 也支持。

界面语言怎么切？设置里选，共 20+ 种，深色/浅色跟随系统都行。

Gopeed 的价值很直接：一个客户端收编五种链接、六个平台，还给你留了 API 和扩展两个口子。下一步建议：读 README_zh-CN.md 看完整特性清单 → 翻 pkg/download/ 里的下载引擎和 pkg/rest/ 里的 REST API 实现 → 有想法就在仓库提 issue 或 PR。

【免费下载链接】gopeedA fast, modern download manager for HTTP, BitTorrent, Magnet, and ed2k. Cross-platform, built with Golang and Flutter.项目地址: https://gitcode.com/GitHub_Trending/go/gopeed