Gopeed 下载管理器完全上手指南CLI、Web API 与自动化实操【免费下载链接】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一个链接下不完的大文件、服务器上一批散乱的 URL、下载完还要手动解压的压缩包——这些反复出现的下载琐事Gopeed 下载管理器一次就能解决它用 Golang 写下载引擎、Flutter 写界面一个工具同时覆盖 HTTP、磁力、ed2k 协议还能跑在你常用的任何系统上。上手之后你可以一条命令完成单文件下载用 REST API 批量提交任务下载完成后自动解压、跑脚本第一次成功使用最快上手路径第一次装完别急着研究设置。三步跑通确认命令在 PATH 里、给一个链接、看进度条走完。gopeed https://example.com/largefile.zip -C 16 -D ./downloads终端里会实时刷新进度和速度结束后打印 saving path 告诉你文件落在哪。参数默认值直接来自源码参数作用默认值-C并发连接数16-D保存目录当前工作目录同一命令也接受magnet:?xt...和.torrent文件作为参数。源码参考cmd/gopeed/main.go、cmd/gopeed/flags.go服务器上批量下载headless 模式 REST API什么场景用得上机器只有终端你要一口气提交几十个链接、随时暂停恢复而不是逐个开命令行。把 Gopeed 以 web 模式常驻它就是一个带 REST API 的下载服务gopeed -d /data/downloads -u gopeed -p yourpass参数作用默认值-d数据任务与配置存储目录空默认路径-u/-p账号密码不设密码则不启用登录gopeed / 空-TAPI token启用密码认证后调用接口必带空-c配置文件路径./config.json之后用接口提交任务即可批量接口一次收一组请求curl -u gopeed:yourpass -X POST http://127.0.0.1:9999/api/v1/tasks/batch \ -H Content-Type: application/json \ -d {reqs:[{req:{url:https://example.com/a.zip}},{req:{url:https://example.com/b.zip}}],opts:{path:/data/downloads}}所有配置也支持GOPEED_STORAGE_DIR这类环境变量Docker 部署时比改命令行省事得多。源码参考cmd/web/flags.go、pkg/rest/api.go大文件提速连接数、队列与 BT 参数什么场景用得上单文件 1GB 以上或者队列里混着 HTTP 和磁力任务带宽分配需要你自己定规则。先把规则摸清再动手改场景改什么具体做法HTTP 大文件并发连接数CLI 加-C 32服务端不支持 Range 时无法再分片任务排队太多最大并行任务数 maxRunning设置里默认 5调大即多任务同时跑BT 冷资源Tracker 列表在 BitTorrent 配置里补充 TrackerBT 下完就走/持续做种做种比例与时长 seedRatio / seedTime默认下完即停按社区规则设置另外留意队列同时跑的任务越多单个文件分到的带宽越少排队是设计使然不是故障。源码参考internal/protocol/http/config.go、internal/protocol/bt/config.go下载完成后自动处理解压、脚本、通知什么场景用得上每天固定下几十个压缩包不想每次手动解压、重命名、通知。Gopeed 内置了三层下载完之后的能力都在设置里开关不用写代码自动解压完成后自动解压压缩包可选解压完删除原压缩包脚本执行填一组脚本路径任务完成时按顺序执行做重命名、移动文件都行Webhook填一个或多个 URL完成后发 POST 通知你的系统配合前面的 web 模式就是一条无人值守的下载流水线API 提交 → 自动下载 → 自动解压 → 脚本归档 → webhook 播报。源码参考pkg/download/webhook.go、pkg/download/script.go跨设备协作手机和浏览器随时接管什么场景用得上下载跑在公司服务器上你在家里想看看进度或者干脆用 Docker 把下载中心搬到 NAS 上。web 模式本身就是远程方案服务器上-d /data/downloads起好后家里任何设备浏览器打开http://服务器IP:9999就能看到任务列表、控制任务——前提是局域网互通。调用 API 时带上-T配置的 token 即可账号密码认证下同样适用。Docker 部署时把-d对应的目录挂出去任务数据就和宿主机绑定换机器迁移就是复制这一个目录。源码参考cmd/web/flags.go、docker-compose.yml进阶定制给 Gopeed 装插件什么场景用得上内置功能覆盖不了你的流程比如解析私有站点链接、按团队习惯自动整理任务。Gopeed 的扩展是跑在内置 JS 引擎里的 JavaScript 包通过 REST 接口安装curl -u gopeed:yourpass -X POST http://127.0.0.1:9999/api/v1/extensions \ -H Content-Type: application/json -d install.json本地开发时支持文件夹模式直接挂载本地目录改完即生效不用反复拷贝。插件在四个事件钩子上写逻辑各管一段流程钩子时机能做什么onResolve链接解析阶段改写下载请求onStart下载开始前调整任务参数onError任务报错时自定义重试或兜底onDone下载完成后解压、通知、归档界面侧则不用写代码设置里有浅色/深色主题切换i18n 目录里内置了 20 多种语言中文简繁开箱即用。源码参考pkg/download/extension.go、ui/flutter/lib/i18n/langs/问题自查三个最常见的卡点1. BT 任务一直等待、速度为 0常见原因资源冷门、种子少或防火墙拦了入站连接。防火墙放行 Gopeed 的 BT 监听端口在 BitTorrent 配置里补充 Tracker 列表检查 seedRatio / seedTime 设置确认不是下完即停把做种掐掉了2. HTTP 任务断点续传失败、从头下常见原因服务器不支持 Range 分片或保存目录、文件名中途变了。确认响应头含Accept-Ranges: bytes不支持分片就只能整文件下保持-D目录与文件名不变再续传网络抖动频繁时把-C降到 8 减少并发压力3. 浏览器打不开 web 界面或 API 一直 401常见原因没设密码、或启用密码后没带 token。确认启动时是否传了-p没传则登录认证根本没启用启用认证后API 请求带上-T指定的 token容器环境改用GOPEED_PASSWORD、GOPEED_API_TOKEN等环境变量注入写在最后到这里你已经走完了一条完整路径一条命令下完文件web 模式 REST API 撑起服务器批量下载自动解压、脚本和 webhook 接管下载完成后的活跨设备靠同一个服务远程接管。项目还在持续演进路线图里规划了更强的扩展生态与 P2P 加速方向有想法可以直接看仓库贡献指南CONTRIBUTING_zh-CN.md。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考