# Cloudora

**Repository Path**: calmer2024/cloudora

## Basic Information

- **Project Name**: Cloudora
- **Description**: 基于C#语言开发的开源网盘项目
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2025-04-30
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cloudora 网盘 ☁️

Cloudora 是一个基于 C# ASP.NET Core 和 React 构建的现代化、功能完善的个人云存储解决方案。

## ✨ 主要功能

- **用户与管理员系统**：安全注册登录、用户管理、权限与空间控制。
- **文件与目录管理**：树状结构、双视图模式（列表/网格）、文件操作、回收站。
- **高效上传**：客户端直传OSS、智能秒传、多重校验。
- **安全分享**：强制访问密码（哈希存储）、有效期设置、范围权限控制。
- **文件预览**：支持图片和视频（截帧）的快速预览。

## 🛠️ 技术栈

- **后端**: ASP.NET Core 8, C#, EF Core, MySQL, JWT, Redis, Aliyun OSS SDK
- **前端**: React, Vite, Node.js, Axios, React Router
- **部署与运维**: 阿里云ECS, Nginx (HTTPS), 云效CI/CD, systemd

## 🚀 快速开始

**环境准备:**

- .NET 8 SDK
- Node.js (v18+)
- MySQL 数据库
- Redis

### **1. 后端设置**

1. **克隆仓库**并进入后端目录：

   ```
   git clone https://gitee.com/calmer2024/cloudora.git
   cd Cloudora/Backend
   ```

2. **创建数据库**：

   - 在MySQL中创建一个名为 `cloudora_db` 的空数据库。
   - 执行项目根目录 `/Database/DatabaseScript.sql` 脚本，以创建所有数据表。

3. **配置敏感信息**：

   - **数据库连接**：在 `Backend` 目录下创建一个 `appsettings.Development.json` 文件，并配置MySQL与Redis连接字符串。

     ```
     {
       "ConnectionStrings": {
         "DefaultConnection": "server=localhost;port=3306;database=cloudora_db;user=your_user;password=your_password;"
       },
       "Redis": {
         "ConnectionString": "localhost:6379,password=cloudora100points,abortConnect=false"
       }
     }
     ```

   - **阿里云OSS密钥**：在操作系统中设置以下两个**环境变量**：

     - `OSS_ACCESS_KEY_ID`: [阿里云AccessKeyId]
     - `OSS_ACCESS_KEY_SECRET`: [阿里云AccessKeySecret]

4. **运行后端**:

   ```
   dotnet run
   ```

   服务将启动在 `http://localhost:5001`。

### **2. 前端设置**

1. **进入前端目录**并安装依赖：

   ```
   cd ../Frontend
   npm install
   ```


2. **运行前端**:

   ```
   npm run dev
   ```

   前端开发服务器将启动在 `http://localhost:5173`。

### **📚 API 文档**

当后端服务运行时，可通过以下地址访问Swagger API文档： `http://localhost:5001/swagger/index.html`