Explore Free FS: A Modern Spring Boot File Management System with Full Stack Demo

Free FS Overview

Free FS is an enterprise‑grade file management system built on Spring Boot 3.x, offering high‑performance, reliable storage and management.

Key Features

Large file upload with chunking, breakpoint resume, instant upload for TB‑scale files.

Plug‑in storage via SPI, enabling new storage backends (local, OSS, S3, etc.) in about five minutes.

Modular architecture with clear layered design for easy maintenance and extension.

Security: JWT authentication, fine‑grained permission control, file integrity checks.

Real‑time progress using Server‑Sent Events for smooth user experience.

Technology Stack

Backend: Spring Boot 3.5.4, MyBatis Flex, Sa‑Token.

Frontend: React 19, TypeScript, Vite 6, shadcn/ui.

Storage adapters: local, Alibaba Cloud OSS, RustFS, Qiniu Kodo, and generic S3‑compatible services.

Installation – Backend

Prerequisites: MySQL 8+ and Redis.

Clone the source code from https://gitee.com/dromara/free-fs and import into an IDE.

Create a MySQL database named free-fs and run the script _sql/mysql/free-fs.sql to populate tables.

Update fs-admin/src/main/resources/application-dev.yml with your MySQL and Redis connection details.

Run the main class FsAdminApplication to start the backend service.

Installation – Frontend

Clone the frontend repository https://gitee.com/xddcode/free-fs-frontend and open it in VS Code.

Install dependencies and start the development server:

After a successful start, open http://localhost:5173 and log in with the default credentials admin/admin.

Usage Highlights

Console

The admin console provides an overview of storage usage and system status.

File Management

Supports click‑or‑drag multi‑file upload, list and grid views, and a recycle‑bin‑like recovery feature.

Storage Platforms

Multiple storage backends can be switched on the fly; local storage is default, with options such as Alibaba Cloud OSS.

Sharing

Files can be shared via generated links.

Preview

Online preview supports many formats, including DOCX, PPTX, and PDF, making it a versatile preview tool.

Conclusion

Free FS combines a modern stack, plug‑in architecture, and rich features to deliver an efficient, secure file management solution for both enterprises and individual developers.

Project Repository

https://gitee.com/dromara/free-fs