Pan-Fetcher：一个面向115网盘的自动化订阅下载工具

# Pan-Fetcher：一个面向115网盘的自动化订阅下载工具

在数字资源管理流程中，从“发现资源”到“完成下载”往往涉及多个割裂的步骤。Pan-Fetcher 是我最近在维护的一个开源项目，它的目标是把这些步骤整合进一个统一的、可配置的自动化管道中。

## 项目定位

Pan-Fetcher 是一个**面向115网盘的中后台工具**，主要解决以下场景的需求：

– 对特定番剧、剧集或发布组的持续跟踪与自动下载
– 跨多个BT索引器的资源聚合检索
– 115网盘文件的远程管理
– 下载任务状态的通知与监控

它不是一个面向普通用户的“一键下载器”，而更适合**有一定技术背景、希望构建稳定自动化流程**的用户。

## 架构与交互

项目采用 **Go + SQLite + 原生HTML模板** 的技术栈，没有引入前端框架或复杂的运行时依赖。这种选择带来了几个实际的好处：

– 编译产物为单一二进制文件，部署简单
– 内存占用低，适合在低配VPS或树莓派等设备上长期运行
– 启动速度快，依赖少

Web面板覆盖了配置、搜索、订阅、任务管理和文件操作等核心功能，同时也提供了CLI命令，方便在无图形界面的环境下进行脚本化操作。

## 核心工作流程

从功能分层来看，Pan-Fetcher 的工作流可以拆解为四个环节：

1. **资源发现**：支持内置索引器（ACG.RIP、动漫花园、Mikan、Nyaa.si）以及通过Torznab协议接入Jackett/Prowlarr管理的数百个索引器。搜索结果分页展示，支持分类筛选和关键词过滤。

2. **订阅管理**：用户配置RSS源后，系统定时抓取更新，通过info hash去重和关键词/正则过滤，只推送符合条件的资源到下一步。订阅源可以独立启用/禁用，缓存可手动清理。

3. **离线任务提交**：将磁力、ed2k或http链接通过115官方API提交至离线下载队列。任务列表按状态（下载中/已完成/失败）分页展示，支持批量清理。

4. **文件管理**：对115网盘内的文件进行浏览、新建目录、重命名、移动、复制和删除操作。CLI模式下还提供了一个带Tab补全的交互式Shell。

## 部署与配置

项目提供了多种部署路径：

| 部署方式 | 适用场景 |
|———|———|
| Docker Compose | 推荐方式，依赖最少，环境隔离 |
| Linux systemd脚本 | 适合直接跑在宿主机的长期服务 |
| 预编译二进制 | 覆盖Linux/macOS/Windows共5个平台 |
| 源码编译 | 需要定制或二次开发时使用 |

配置方面，大部分参数（115登录凭证、代理、Jackett地址、通知Webhook等）都支持在Web设置页动态修改，不需要频繁编辑配置文件。

## 几点客观说明

在使用前，有几个事实值得注意：

– **依赖115官方API**：所有网盘操作均通过`webapi.115.com`和`proapi.115.com`进行，不涉及第三方传输，但工具本身的可用性受115接口变动影响。
– **登录方式**：支持Cookies导入和扫码登录两种方式。扫码登录相对更安全，因为不涉及手动提取Cookies。
– **通知渠道**：目前仅实现了企业微信Webhook，尚不支持其他IM平台（如Telegram、Pushover等），未来可以根据需求扩展。

## 开源与贡献

项目采用MIT许可证，代码仓库位于GitHub。目前包含完整的文档（中英文）、示例配置和CI构建流程。如果你也在寻找一个能串联“搜索-订阅-下载”链路的工具，欢迎试用、提Issue或提交PR。

项目地址：[https://github.com/mguyenanastacio-glitch/pan-fetcher](https://github.com/mguyenanastacio-glitch/pan-fetcher)