基于 Spring Boot 3.5.x + Sa-Token + MyBatis Flex 的企业级文件管理系统 Free-FS

大文件上传与秒传

前端把大文件切片并行上传，后端通过 SSE 实时推进度，精确到每个分片的状态。网络中断后，系统记录断点位置，续传时从断点继续。

秒传的原理是先算文件 MD5 发给服务端，服务器有相同哈希的文件就直接建立引用，跳过数据传输。所以上传几个 G 的文件有时能"秒完"。

多云存储插件化

存储层用 SPI 插件化设计，把存储能力抽象成统一接口。

内置的存储实现有本地存储、阿里云 OSS、七牛云 Kodo、AWS S3 兼容存储、RustFS。

一套系统可以管理多个存储平台，按需分配或一键切换。新增存储平台只要实现核心接口并注册，不用改主业务代码。

添加存储配置

在线预览

支持五大类文件预览：

Office 文档通过 LibreOffice 转成 PDF 后交给前端，转换用进程池模式，可以配置并发度和超时。

权限与安全

用 Sa-Token 做权限认证，JWT 无状态会话，支持分布式部署。

权限可以控制到文件的查看、下载、编辑、删除等操作。

文件分享和回收站

文件分享有公开链接和授权码两种模式，授权码分享能设置有效期和访问次数。

回收站给删除操作一个缓冲区，支持批量还原、永久删除和自动清理。

回收站

安装与快速上手

环境要求

• JDK 17+
• Maven 3.8+
• MySQL 8.0+ 或 PostgreSQL 14+（二选一）
• Redis
• LibreOffice (可选，用于 Office 文档预览功能)

安装步骤

git clone https://gitee.com/dromara/free-fs.git 
cd free-fs 
mvn clean install -DskipTests 

数据库初始化

MySQL：

CREATE DATABASE `free-fs` CHARACTER SET 'utf8mb4' COLLATE 'utf8mb4_general_ci'; 

PostgreSQL：

CREATE DATABASE free-fs ENCODING 'UTF8' LC_COLLATE='zh_CN.UTF-8' LC_CTYPE='zh_CN.UTF-8'; 

数据库创建完成之后，导入项目根目录下对应的 SQL 文件到刚创建的数据库中：

• MySQL: _sql/mysql/free-fs.sql
• PostgreSQL: _sql/postgresql/free-fs_pg.sql

配置与运行

修改 fs-admin/src/main/resources/application-dev.yml 中的数据库和 Redis 配置：

cd fs-admin 
mvn spring-boot:run 

访问地址：

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

技术架构

技术栈选型

后端用 Spring Boot 3.5.4，搭配 MyBatis Flex 做 ORM 层。

MyBatis Flex 是 MyBatis 的增强版，和 MyBatis-Plus 有些差异：

认证授权用 Sa-Token，比 Spring Security 简洁。数据库支持 MySQL 8.0+ 和 PostgreSQL 14+，HikariCP 连接池，配合 Caffeine 本地缓存和 Redis 分布式缓存。

项目结构

多模块 Maven 结构：

存储插件用 SPI 设计，storage-plugin-core 定义接口，各存储实现添加新插件模块就行。

与其他方案对比

只做对象存储的话 MinIO 更合适；需要完整网盘 UI 和协作功能的话 Nextcloud 或 Seafile 更好；需要一个可定制、易集成的文件管理后端，Free-FS 可以考虑。

总结

Free-FS 用 Spring Boot 3.x + MyBatis Flex + Sa-Token 做了一个功能完整的企业级文件管理后端。

• 优势：功能完整，开箱即用；大文件上传（分片/断点续传/秒传）；插件化存储扩展；多格式在线预览；Sa-Token 权限管理；Apache 2.0 协议友好。
• 局限：需要部署数据库（MySQL/PostgreSQL + Redis）；Office 预览要配置 LibreOffice。
• 适用场景：搭建企业级文件管理系统、需要多云存储支持、需要大文件上传能力。

建议先部署基础版本跑通上传下载流程，再按需要接入云存储和配置预览。

• 后端地址：https://gitee.com/dromara/free-fs
• 前端地址：https://gitee.com/xddcode/free-fs-frontend