# 云文件服务平台

**Repository Path**: mingjue/cloud-file-service-platform

## Basic Information

- **Project Name**: 云文件服务平台
- **Description**: 基于 SpringBoot 实现云文件服务平台，支持文件上传、分片上传、断点续传及秒传功能，结合对象存储与缓存机制提升文件访问效率与系统稳定性。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-01
- **Last Updated**: 2026-08-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

<img alt="云文件服务平台 Logo" src=".images/logo.svg" width="100"/>

# 云文件服务平台

### 企业级云文件管理系统

一个基于 Spring Boot 4.x 的企业级云文件管理系统，专注于提供高性能、高可靠的文件存储和管理服务。

 <img src="https://img.shields.io/badge/Spring%20Boot-4.0.3-blue.svg" alt="Spring Boot">
 <img src="https://img.shields.io/badge/React-19-blue.svg" alt="React">
 <img src="https://img.shields.io/badge/MyBatis%20Flex-1.0.0-blue.svg" alt="MyBatis Flex">
 <img src="https://img.shields.io/badge/Redis-7.0+-blue.svg" alt="Redis">
 <img src="https://img.shields.io/badge/MySQL-8.0+-blue.svg" alt="MySQL">

</div>

---

## 项目简介

云文件服务平台是一个功能完整的企业级文件管理系统，支持大文件上传、断点续传、秒传、在线预览等核心功能，采用模块化架构设计，易于扩展和维护。

### 技术栈

- **后端**：Spring Boot 4.0.3, MyBatis Flex, Redis, MySQL/PostgreSQL
- **前端**：React 19, TypeScript, Ant Design
- **存储**：本地存储、MinIO、阿里云 OSS、七牛云 Kodo、S3 体系
- **认证**：JWT 认证、权限控制
- **其他**：SSE 实时推送、SPI 插件化架构

## 核心功能

### 1. 文件管理
- ✅ 大文件上传（分片上传、断点续传、秒传）
- ✅ 实时上传进度推送
- ✅ 文件预览（支持多种文件格式）
- ✅ 文件下载
- ✅ 文件夹创建与管理
- ✅ 文件/文件夹重命名、移动
- ✅ 文件分享/授权码分享
- ✅ 文件删除（支持回收站）

### 2. 存储管理
- ✅ 多存储平台支持（本地、MinIO、阿里云 OSS、七牛云 Kodo、S3 体系）
- ✅ 一键切换存储平台
- ✅ 平台配置管理
- ✅ 存储空间统计

### 3. 系统管理
- ✅ 用户管理
- ✅ 权限控制
- ✅ 日志管理
- ✅ 计划任务

### 4. 在线预览支持
- **图片**：jpg, jpeg, png, gif, bmp, webp, svg, tif, tiff
- **文档**：pdf, doc, docx, xls, xlsx, csv, ppt, pptx
- **文本/代码**：txt, log, ini, properties, yaml, yml, conf, java, js, jsx, ts, tsx, py, c, cpp, h, hpp, cc, cxx, html, css, scss, sass, less, vue, php, go, rs, rb, swift, kt, scala, json, xml, sql, sh, bash, bat, ps1, cs, toml
- **Markdown**：md, markdown
- **音视频**：mp4, avi, mkv, mov, wmv, flv, webm, mp3, wav, flac, aac, ogg, m4a, wma
- **压缩包**：zip, rar, 7z, tar（支持查看目录结构，支持预览压缩包中的文件）
- **其他**：drawio

## 项目结构

```
cloud-file-service-platform/
├── fs-admin/                    # Web 管理模块
├── fs-dependencies/             # 依赖版本管理（BOM）
├── fs-framework/                # 框架层
│   ├── fs-common-core/          # 公共核心模块
│   ├── fs-notify/               # 通知模块
│   ├── fs-orm/                  # ORM 配置模块
│   ├── fs-preview/              # 预览封装模块
│   ├── fs-redis/                # Redis 配置模块
│   ├── fs-security/             # 安全认证模块
│   ├── fs-swagger/              # API 文档配置
│   ├── fs-sse/                  # SSE 支持
│   └── fs-storage-plugin/       # 存储插件框架
│       ├── storage-plugin-boot/        # 插件核心管理模块
│       ├── storage-plugin-core/        # 插件核心接口模块
│       ├── storage-plugin-local/       # 本地存储插件
│       ├── storage-plugin-aliyunoss/   # 阿里云 OSS 插件
│       ├── storage-plugin-kodo/        # 七牛云 kodo 插件
│       └── storage-plugin-obs/         # 腾讯云 bos 插件
│       └── storage-plugin-rustfs/      # RustFS 插件
└── fs-modules/                  # 业务模块
    ├── fs-file/                 # 文件管理模块
    ├── fs-storage/              # 存储平台管理模块
    ├── fs-system/               # 系统管理模块
    ├── fs-log/                  # 日志模块
    └── fs-plan/                 # 计划任务模块
```

## 快速开始

### 环境要求

- JDK >= 21
- Maven >= 3.8
- MySQL >= 8.0 或 PostgreSQL >= 14
- Redis

### 安装步骤

1. **克隆项目**
   ```bash
   git clone https://gitee.com/zhaoyw1/cloud-file-service-platform.git
   cd cloud-file-service-platform
   ```

2. **编译项目**
   ```bash
   mvn clean install -DskipTests
   ```

3. **初始化数据库**
   ```bash
   # MySQL
   mysql -u root -p < _sql/mysql/free-fs.sql
   
   # PostgreSQL
   psql -U postgres -c "CREATE DATABASE cloud-file-service;"
   psql -U postgres -d cloud-file-service -f _sql/postgresql/free-fs_pg.sql
   ```

4. **修改配置文件**
   修改 `fs-admin/src/main/resources/application-dev.yml` 中的数据库和 Redis 配置

5. **启动应用**
   ```bash
   cd fs-admin
   mvn spring-boot:run
   # 或使用 IDE 运行 FreeFsApplication
   ```

### 访问信息

- 服务地址：http://localhost:8080
- API 文档：http://localhost:8080/swagger-ui.html
- 默认账号：admin / admin

## 界面预览

| 功能   | 效果图                                                                                                                  | 效果图                                                                                                                     | 效果图                                                                                                                          |
|------|----------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|
| 登录   | <img alt="login.png"  width="600" src=".images/login.png"/>                                                          | <img alt="register.png"  width="600" src=".images/register.png"/>          | <img alt="forget_password.png"  width="600" src=".images/forget_password.png"/> |
| 首页   | <img alt="dashboard.png" width="600" src=".images/dashboard.png"/>      |                                                                                                                         |                                                                                                                              |
| 我的文件 | <img alt="grid_file.png" width="600" src=".images/grid_file.png"/>      | <img alt="file.png" width="600" src=".images/file.png"/>                   |                                                                                                                              |
| 回收站  | <img alt="recycle.png" width="600" src=".images/recycle.png"/>          | <img alt="recycle_clear.png" width="600" src=".images/recycle_clear.png"/> |                                                                                                                              |
| 分享文件 | <img alt="share.png" width="600" src=".images/share.png"/>              | <img alt="share_create.png" width="600" src=".images/share_create.png"/>   | <img alt="share_list.png" width="600" src=".images/share_list.png"/>            |
| 移动文件 | <img alt="move.png" width="600" src=".images/move.png"/>                |                                                                                                                         |                                                                                                                              |
| 传输   | <img alt="transmission.png" width="600" src=".images/transmission.png"/> |                                                                                                                         |                                                                                                                              |
| 存储平台 | <img alt="storage.png" width="600" src=".images/storage.png"/>          | <img alt="add_storage.png" width="600" src=".images/add_storage.png"/>     | <img alt="enable_storage.png" width="600" src=".images/enable_storage.png"/>    |
| 个人信息 | <img alt="profile.png" width="600" src=".images/profile.png"/>          | <img alt="profile_auth.png" width="600" src=".images/profile_auth.png"/>   |                                                                                                                              |

## 技术亮点

1. **高性能文件上传**：采用分片上传、断点续传、秒传技术，支持 TB 级文件
2. **实时进度推送**：基于 SSE 技术实现实时上传进度推送，提升用户体验
3. **插件化存储架构**：采用 SPI 机制实现存储平台热插拔，5 分钟接入一个新存储平台
4. **模块化设计**：清晰的分层架构，易于维护和扩展
5. **安全可靠**：JWT 认证、权限控制、文件完整性校验
6. **丰富的预览支持**：支持多种文件格式的在线预览，满足企业级需求

## 项目价值

- **企业级应用**：满足企业内部文件管理需求，提高工作效率
- **技术实践**：整合 Spring Boot 4.x、React 19 等前沿技术栈
- **可扩展性**：插件化架构设计，支持多种存储平台
- **学习价值**：包含完整的文件管理系统核心功能，适合学习和实践

## 联系方式

- Gitee: [@zhaoyw1](https://gitee.com/zhaoyw1)

<div align="center">

Made with ❤️ by [@zhaoyw1](https://gitee.com/zhaoyw1)

</div>