基于 Python 的多网盘聚合中继与自动化变现管理系统

业务逻辑 • 支持网盘 • 部署指南 • 凭证配置 • 开放接口 • 联系作者

Pan-Relay 是一款专为网盘推广员、资源站长打造的全自动化收益与聚合分发系统。

通过“资源聚合 -> 自动转存 -> 收益链接替换 -> 优先分发”的闭环，将外部资源转化为自己的分享链接，提升拉新与转存收益。

内置 SQLite 数据库，支持本地资源、第三方 API、Telegram 公开频道与可扩展插件聚合搜索。

---

💎 核心业务逻辑

• 自动化链接洗白：已接入 夸克网盘、百度网盘、阿里云盘、UC 网盘、迅雷网盘。选择批量转存入库后，系统自动执行“转存至个人盘 -> 生成个人分享链 -> 替换入库”，将外部链接转化为自己的收益链接。
• 私有收益资源库：资源统一存入本地 SQLite 数据库，支持后台批量导入、转存、增删改查、类型标注、关键词检索和导出，方便持续维护与全网分发。
• 多渠道聚合搜索：
  • 前台搜索：优先展示私有资源库中的收益链接，再并发聚合第三方 API、Telegram 公开频道和搜索插件的结果。
  • 动态收益出链：外部搜索结果可在用户访问时按需转存，生成临时个人分享链；转存失败时自动回退原链接，过期分享由系统定时清理。
  • 公开接口：提供可开关的 JSON 聚合搜索 API，支持按关键词和网盘筛选，便于接入公众号、小程序、机器人或资源导航站，扩大资源分发入口。

✨ 项目特点

• 无需外部数据库：内置 SQLite 与 WAL 模式，无需安装配置 MySQL 等数据库服务。
• 开箱即用：启动时自动初始化表结构及预置 API、TG 频道和插件搜索源，支持源码与 Docker 部署。
• 免凭证TG搜索：直接抓取 Telegram 公开频道，无需 Bot Token，并自动提取网盘链接与提取码。
• 搜索源可扩展：后台统一管理 API、TG 频道和 Python 搜索插件，支持启停、测试与调度配置。
• 容器化部署：提供 Dockerfile 与 Docker Compose，支持数据持久化和健康检查。

---

💾 支持的网盘矩阵

网盘平台	识别状态	自动转存/洗白	动态查看/临时分享	凭证类型
夸克网盘	✓	✓	✓	Cookie
百度网盘	✓	✓	✓	Cookie
阿里云盘	✓	✓	✓	Refresh Token
UC网盘	✓	✓	✓	Cookie
迅雷网盘	✓	✓	✓	Refresh Token + Captcha Sign + User ID
其他网盘	✓	🚧	🚧	视平台而定

---

🚀 部署指南

方式一：Docker 部署（强烈推荐，开箱即用）

内置 SQLite 数据库，无需安装任何数据库软件，一键启动：

# 1. 克隆代码并进入目录
git clone https://github.com/ucmao/pan-relay.git
cd pan-relay

# 2. 启动服务（自动构建镜像，数据持久化挂载至本地 ./data 目录）
docker compose up -d

# 3. 查看实时运行日志
docker compose logs -f

---

方式二：本地 Python 环境运行

适用于本地二次开发或无 Docker 环境的宿主机：

# 1. 创建并激活虚拟环境 (Python 3.8+)
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 2. 安装依赖并启动
pip install -r requirements.txt
python app.py

---

🌐 服务访问与管理后台

服务启动后，在浏览器直接访问：

• 前台搜索：http://localhost:5004
• 管理后台：http://localhost:5004/admin（默认账号 admin / 密码 admin123）

💡 提示：如需自定义后台账号密码，可复制 cp .env.example .env 后按需修改；TG 代理、超时和并发数在后台搜索源管理中配置。

---

⚙️ 网盘凭证说明

登录管理后台（/admin）进入 配置中心 -> 云盘凭证 即可配置各平台登录态：

• 夸克 / 百度 / UC 网盘：登录网页版，从浏览器开发者工具（F12）网络请求标头中复制完整 Cookie 填入。
• 阿里云盘：从登录会话中提取并填入 refresh_token。
• 迅雷网盘：需同时填入 Refresh Token、Captcha Sign 与 User ID 三项参数（缺一不可）。

💡 安全提示：所有凭证仅在服务端本地存储，用于自动化转存与动态出链，绝不上传至任何第三方。

---

🔌 开放接口（可选）

系统提供 JSON 聚合搜索接口，便于接入微信公众号、机器人或外部导航站。接口默认开启，可在后台配置中心关闭，关闭后返回 HTTP 403。支持 keyword（必填）、cloud_name（可选，按网盘名称筛选）与 limit（默认 100）参数：

GET /api?keyword={关键词}&cloud_name={可选网盘平台}&limit=20

响应示例：

{
  "success": true,
  "total": 1,
  "results": [
    {
      "source": "hot",
      "name": "凡人修仙传.4K",
      "share_link": "https://pan.quark.cn/s/xxxx",
      "cloud_name": "夸克网盘"
    }
  ]
}

---

📩 联系作者

如果您在安装、使用过程中遇到问题，或有定制需求，请通过以下方式联系：

• 微信：csdnxr
• QQ：294323976
• 邮箱：leoucmao@gmail.com
• Bug反馈：GitHub Issues

---

⚖️ 开源协议 & 免责声明

1. 本项目基于 MIT LICENSE 协议开源。
2. 免责声明：本工具仅供技术交流与学习研究，严禁用于任何商业侵权或非法目的。因使用本工具造成的任何账号封禁或法律责任，均由使用者自行承担，与原作者无关。