【免费下载】 云盘资源搜索与转存工具CloudSaver使用教程

云盘资源搜索与转存工具CloudSaver使用教程

1. 项目介绍

CloudSaver是一个基于Vue 3 + Express的开源网盘资源搜索与转存工具。它支持响应式布局，移动端与PC端完美适配，并且可以通过Docker一键部署。主要功能包括多源资源搜索、网盘资源转存、多用户系统等。

2. 项目快速启动

环境要求

• Node.js >= 18.x
• pnpm >= 8.x (推荐)

克隆项目

git clone https://github.com/jiangrui1994/CloudSaver.git
cd CloudSaver

安装依赖

pnpm install

配置环境变量

cp ./backend/.env.example ./backend/.env

根据.env.example文件说明配置必要的环境变量。

启动开发服务器

pnpm dev

生产环境部署

构建前端

pnpm build:frontend

构建后端

cd backend
pnpm build

启动服务

pnpm start

Docker 部署

单容器部署

稳定版：

docker run -d \
-p 8008:8008 \
-v /your/local/path/data:/app/data \
-v /your/local/path/config:/app/config \
--name cloud-saver \
jiangrui1994/cloudsaver:latest

测试版：

docker run -d \
-p 8008:8008 \
-v /your/local/path/data:/app/data \
-v /your/local/path/config:/app/config \
--name cloud-saver \
jiangrui1994/cloudsaver:test

Docker Compose 部署

创建docker-compose.yml文件：

稳定版：

version: "3"
services:
  cloudsaver:
    image: jiangrui1994/cloudsaver:latest
    container_name: cloud-saver
    ports:
      - "8008:8008"
    volumes:
      - /your/local/path/data:/app/data
      - /your/local/path/config:/app/config
    restart: unless-stopped

测试版：

version: "3"
services:
  cloudsaver:
    image: jiangrui1994/cloudsaver:test
    container_name: cloud-saver
    ports:
      - "8008:8008"
    volumes:
      - /your/local/path/data:/app/data
      - /your/local/path/config:/app/config
    restart: unless-stopped

运行：

docker-compose up -d

注意：测试版（:test标签）包含最新的功能开发和bug修复，但可能存在不稳定因素。建议生产环境使用稳定版（:latest标签）。

3. 应用案例和最佳实践

• 多源资源搜索：支持多个资源订阅源搜索，关键词搜索与资源链接解析，豆瓣热门榜单展示。
• 网盘资源转存：支持115网盘、夸克网盘、天翼网盘一键转存，转存文件夹展示与选择。
• 多用户系统：支持用户注册登录，管理员与普通用户权限区分。

4. 典型生态项目

• 前端框架：Vue 3、TypeScript、Vite
• 状态管理：Pinia
• 路由管理：Vue Router
• UI 组件库：Element Plus (PC)、Vant (Mobile)
• 工具库：Axios
• 后端运行环境：Node.js
• 数据存储：SQLite3