CloudSearch/README.md

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 连接（不设则自动降级）

首次使用

1. 登录管理后台 /admin/login
2. 在「网盘配置」→「添加配置」中填入网盘 Cookie
3. 启用对应网盘配置
4. 返回首页即可搜索并转存资源

---

开发环境

# 后端
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 等凭证由用户自行保管，系统以加密形式存储。