为了方便您快速了解系统逻辑,我们提供了全功能的在线测试环境:
- 🔍 用户搜索端:https://so.ucmao.cn
- ⚙️ 管理后台: https://so.ucmao.cn/admin
- 管理账号:
admin - 管理密码:
admin123
- 管理账号:
安全提示:演示环境仅供功能体验。为了您的账号安全,请勿在演示站后台填入您真实的云盘凭证。
- 自动化链接洗白:已接入 夸克网盘、百度网盘、阿里云盘、UC网盘、迅雷网盘。批量导入他人分享链接,系统自动执行“转存至个人盘 -> 生成个人分享链 -> 替换入库”,实现收益权转移。
- 私有资源池:资源存入本地 MySQL 数据库,支持后台批量管理、资源标注及一键导出 Excel,方便全网分发。
- 多维分发模式:
- 前台搜索:极简搜索首页,优先展示您的收益链接,后聚合展示第三方 API 结果。
- 标准接口:提供公开 API,可对接微信机器人、小程序或其他资源导航站。
| 平台 | 识别状态 | 自动转存/洗白 | 动态查看/临时分享 | 凭证类型 |
|---|---|---|---|---|
| 夸克网盘 | ✅ 识别 | ✅ 已支持 | ✅ 已支持 | Cookie |
| 百度网盘 | ✅ 识别 | ✅ 已支持 | ✅ 已支持 | Cookie |
| 阿里云盘 | ✅ 识别 | ✅ 已支持 | ✅ 已支持 | Refresh Token |
| UC网盘 | ✅ 识别 | ✅ 已支持 | ✅ 已支持 | Cookie |
| 迅雷网盘 | ✅ 识别 | ✅ 已支持 | ✅ 已支持 | Refresh Token + Captcha Sign + User ID |
| 其他网盘 | ✅ 识别 | 🚧 持续开发中 | 🚧 持续开发中 | 视平台而定 |
公共搜索接口:GET /api
| 参数 | 描述 | 示例值 |
|---|---|---|
keyword |
搜索关键词 | 凡人修仙传 |
cloud_name |
筛选网盘 | 夸克网盘 |
type |
资源类型 | 电影 |
limit |
返回数量 | 100 |
sort |
排序方式 | default(时间倒序) / random(随机) / asc / desc |
返回示例:
{
"success": true,
"total": 2,
"results": [
{
"source": "hot",
"name": "凡人修仙传",
"share_link": "https://pan.quark.cn/s/xxxx",
"cloud_name": "夸克网盘"
}
]
}- Python: 3.8 及以上版本
- MySQL: 5.7 或 8.0+
首先,将项目克隆到本地服务器或电脑:
git clone https://github.com/ucmao/search-ucmao.git
cd search-ucmao
# 创建虚拟环境
python3 -m venv venv
# 激活环境 (Linux/Mac)
source venv/bin/activate
# 激活环境 (Windows)
# venv\Scripts\activate
pip install --upgrade pip
pip install -r requirements.txt
将项目根目录的 .env.example 文件重命名为 .env 文件,填入以下配置:
# 系统密钥 (用于JWT签名)
SECRET_KEY = 请替换为你的JWT签名密钥(如随机字符串)
# MYSQL 数据库配置
DB_HOST = localhost
DB_PORT = 3306
DB_DATABASE = ucmao_search
DB_USER = root
DB_PASSWORD = 请替换为你的MySQL密码
DB_CHARSET = utf8mb4
# 管理员账号配置
ADMIN_USERNAME = admin
ADMIN_PASSWORD = 请替换为你的管理员密码
# 创建数据库
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS ucmao_search DEFAULT CHARACTER SET utf8mb4;"
# 导入表结构
mysql -u root -p ucmao_search < schema.sql
python app.py
访问 http://localhost:5004 即可进入系统。
启动成功后,请先登录后台完成以下配置:
- 进入
配置中心 - 填写你准备启用的网盘凭证
- 保存后再去
我的资源管理测试转存入库 - 最后去前台搜索页测试动态查看
项目后台现在统一使用“云盘凭证”概念,而不再只限定为 Cookie。不同平台需要填写的内容如下:
| 平台 | 后台字段 | 说明 |
|---|---|---|
| 百度网盘 | 百度网盘 Cookie |
登录网页版后复制整段 Cookie |
| 夸克网盘 | 夸克网盘 Cookie |
登录网页版后复制整段 Cookie |
| 阿里云盘 | 阿里云盘 Refresh Token |
使用阿里云盘登录态提取 refresh_token |
| UC网盘 | UC网盘 Cookie |
登录网页版后复制整段 Cookie |
| 迅雷网盘 | Refresh Token + Captcha Sign + User ID |
3 个字段必须同时填写,缺一不可 |
- 登录网页版:在浏览器打开对应平台官网并登录。
- 进入开发者模式:按下
F12,切换到 Network (网络) 标签页。 - 刷新页面:按
F5刷新,在左侧列表中找到第一个请求。 - 复制 Cookie:在右侧 Headers (标头) 中找到
Cookie:字段,复制整段字符串。 - 完成配置:登录后台,进入
配置中心,粘贴保存。
阿里云盘不是直接使用 Cookie,而是使用 refresh_token。你需要通过自己的抓包方式或现有工具提取登录态中的 refresh token,然后填入后台的 阿里云盘 Refresh Token。
迅雷网盘需要同时准备:refresh_token、captcha_sign、user_id
search-ucmao/
├── app.py # 程序入口
├── configs/ # 应用与日志配置
├── routes/ # 路由层 (API、认证、搜索、资源管理)
├── src/
│ ├── clients/ # 网盘底层客户端 (夸克/百度/阿里/UC/迅雷)
│ ├── db/ # 数据库交互层 (DAO模式)
│ ├── services/ # 业务逻辑层 (API聚合、资源处理)
│ └── pan_operator.py # 核心操作器:执行转存与洗白逻辑
├── templates/ # 前端页面模板
├── static/ # 静态资源 (CSS/JS)
├── utils/ # 工具类 (权限校验、链接识别)
└── schema.sql # 数据库初始化脚本
如果您在安装、使用过程中遇到问题,或有定制需求,请通过以下方式联系:
- 微信:csdnxr
- QQ:294323976
- 邮箱:leoucmao@gmail.com
- Bug反馈:GitHub Issues
- 本项目基于 MIT LICENSE 协议开源。
- 免责声明:本工具仅供技术交流学习,严禁用于任何非法目的。因使用本工具造成的任何账号封禁或法律风险,均与原作者无关。
小青搜剧 - 让每一份网盘资源都为你创造价值。
