CloudSearch — 网盘内容搜索与智能管理平台
CloudSearch 是一款集跨网盘搜索引擎、网盘资源管理、存储空间清理、转存自动化于一体的全栈 Web 应用。支持夸克网盘、百度网盘、阿里云盘等主流云盘，提供统一的管理后台和用户友好的搜索首页。
功能全景
🔍 搜索引擎
- 多数据源聚合：集成 PanSou 搜索引擎 + 多个 TG 频道资源，一站式查找网盘资源
- 多盘直链转存：支持夸克网盘、百度网盘、阿里云盘、115 网盘等主流平台的转存操作
- 分享链接复用：相同原始链接自动复用已有资源，60 秒内重复请求直接返回缓存
- Cookie 验证：自动检测各网盘 Cookie 有效性，过期自动标记
📊 管理后台
- 仪表盘：实时展示网盘数量、总空间、转存统计、活跃配置等核心指标
- 网盘配置：添加/管理各网盘账号（夸克、百度、阿里云、115 等），支持主账号设置、转存启用控制
- 存储清理：
- 自动清理策略设置（保留天数、回收站清空、空间阈值自动清理）
- 白名单目录保护（排除不清理的目录）
- 一键清理、一键清空回收站
- 空间校准与 Cookie 检测间隔配置
- 系统配置：管理员密码修改、Logo 自定义、搜索策略配置
- 转存日志：查看所有转存操作记录，支持搜索与详情展开
🧹 智能存储管理
- 存储空间校准：快速获取网盘实际使用空间（支持夸克
/member接口，单次 API 调用） - 空间阈值自动清理：超出设定使用率阈值时按比例自动删除最旧文件
- 回收站清空：一键清空所有已启用驱动的网盘回收站
🌐 用户前端（首页 + H5）
- 响应式搜索界面，支持桌面端与移动端
- 搜索结果即时展示
- 推广内容展示
🔐 安全特性
- Cookie 加密存储（AES-256-GCM）
- JWT 登录认证
- 暗色/亮色主题切换
- 非 root 容器运行
技术架构
┌──────────────────────────────────────────────────┐
│ 用户浏览器 │
│ Vue 3 SPA（Element Plus UI） │
└──────────────┬──────────────────┬────────────────┘
│ http/9527 │
┌──────────────▼──────────────────▼────────────────┐
│ Express.js 后端 API │
│ TypeScript + better-sqlite3 │
├──────────────────────────────────────────────────┤
│ 📦 网盘驱动 │
│ ┌──────┐ ┌──────┐ ┌────────┐ ┌──────┐ │
│ │ 夸克 │ │ 百度 │ │ 阿里云 │ │ 115 │ … │
│ └──────┘ └──────┘ └────────┘ └──────┘ │
├──────────────────────────────────────────────────┤
│ 🗃️ 数据层 │
│ SQLite（系统配置 + 转存记录 + Cookie缓存） │
│ Redis 缓存（可选自动降级） │
└──────────────┬────────────────────────────────────┘
│
┌──────────────▼────────────────────────────────────┐
│ PanSou 搜索引擎容器 │
│ 80+ 数据源（网盘/资源站/TG 频道/磁力） │
└───────────────────────────────────────────────────┘
组件栈
| 层 | 技术 |
|---|---|
| 前端 | Vue 3 (Composition API) + TypeScript + Element Plus + Vite |
| 后端 | Node.js + Express + TypeScript + better-sqlite3 |
| 搜索引擎 | PanSou（独立容器，80+ 数据源插件） |
| 缓存 | Redis 7（可选，自动降级内存缓存） |
| 容器化 | Docker + Docker Compose（3 服务：app + pansou + redis） |
一键部署
前置条件
- 服务器：Linux x86_64（推荐 2C4G 以上）
- Docker Engine 24+ & Docker Compose v2
部署命令
# 1. 下载部署包
wget https://gitea.timxx.cn/admin/CloudSearch/releases/download/v0.1.6/cloudsearch-deploy.tar.gz
# 或直接从仓库克隆
# git clone https://gitea.timxx.cn/admin/CloudSearch.git && cd CloudSearch
# 2. 解压 & 进入目录
tar xzf cloudsearch-deploy.tar.gz
cd cloudsearch
# 3. 一键配置 + 启动
cp .env.example .env
sed -i "s/change-me-to-a-random-64-char-hex-string/$(openssl rand -hex 32)/" .env
sed -i "s/change-me-to-a-random-key/$(openssl rand -hex 32)/" .env
echo "⚠️ 请编辑 .env 文件，修改 ADMIN_PASSWORD 和 CORS_ORIGIN"
docker compose up -d
# 4. 检查服务状态
docker compose ps
# 预期输出：CloudSearch_App、CloudSearch_PanSou 均为 Up
# 5. 访问
# 搜索页面： http://your-server-ip:9527
# 管理后台： http://your-server-ip:9527/admin/login
环境变量说明
| 变量 | 必需 | 说明 |
|---|---|---|
ADMIN_USERNAME |
✅ | 管理员用户名（默认 admin） |
ADMIN_PASSWORD |
✅ | 务必修改默认密码 |
JWT_SECRET |
✅ | 运行 openssl rand -hex 32 生成 |
CORS_ORIGIN |
✅ | 你的站点域名（如 https://search.example.com） |
COOKIE_ENCRYPTION_KEY |
⚠️ 推荐 | Cookie 加密密钥，不设置则重启后旧数据不可解密 |
REDIS_URL |
❌ 可选 | Redis 连接（不设则自动降级） |
首次使用
- 登录管理后台
/admin/login - 在「网盘配置」→「添加配置」中填入网盘 Cookie
- 启用对应网盘配置
- 返回首页即可搜索并转存资源
开发环境
# 后端
cd packages/backend
npm install
cp .env.example .env # 编辑数据库路径等
npm run dev
# 前端（新终端）
cd packages/frontend
npm install
npm run dev
更新升级
cd /opt/CloudSearch
git pull origin master
docker compose down
docker compose build --no-cache app
docker compose up -d
许可
本项目基于 Gitea 私有仓库维护，仅供授权用户使用。
注意：本系统仅用于合法用途，使用者需遵守当地法律法规。网盘 Cookie 等凭证由用户自行保管，系统以加密形式存储。