Free-FS开源文件管理系统：零基础搭建专属云存储平台

Free-FS开源文件管理系统：零基础搭建专属云存储平台

【免费下载链接】free-fs✨Free-Fs 开源文件管理系统：基于 SpringBoot2.x + MyBatis Plus + MySQL + Sa-Token + Layui 等搭配七牛云，阿里云OSS实现的云存储管理系统。包含文件上传、删除、在线预览、云资源列表查询、下载、文件移动、重命名、目录管理、登录、注册、以及权限控制等功能。项目地址: https://gitcode.com/gh_mirrors/fr/free-fs

Free-FS是一款基于SpringBoot 3.x + MyBatis Flex + MySQL构建的开源文件管理系统，支持阿里云OSS、七牛云、MinIO等主流云存储服务，提供文件上传、在线预览、权限控制等一站式管理功能，让个人与企业轻松搭建专属云存储平台。

为什么选择Free-FS？三大核心优势解析

全平台云存储兼容，数据管理更灵活

Free-FS深度整合多种存储服务，通过统一接口实现跨平台文件管理：

• 本地存储：适合小型团队或个人服务器部署
• 阿里云OSS/七牛云：企业级高可用对象存储方案
• MinIO：私有化部署的高性能分布式存储

项目核心存储接口定义在 fs-common/src/main/java/com/free/fs/common/storage/IFileStorage.java，开发者可轻松扩展更多存储平台。

开箱即用的安全认证体系

集成Sa-Token权限框架，提供：

• 基于角色的访问控制（RBAC）
• 登录验证码保护
• 细粒度文件操作权限配置

用户管理模块源码路径：fs-core/src/main/java/com/free/fs/core/service/UserService.java

极简部署流程，5分钟启动服务

支持Docker一键部署与传统Jar包运行，配置文件路径：mybatis-flex.config，新手也能快速上手。

功能大盘点：满足90%文件管理需求

基础文件操作

• 拖拽上传：支持多文件批量上传
• 在线预览：图片、文档、视频直接查看（基于PreviewAspect切面实现）
• 文件操作：移动/重命名/删除/打包下载

核心实现类：fs-admin/src/main/java/com/free/fs/controller/FileController.java

权限管理系统

• 用户注册/登录/密码重置
• 角色与权限分配（含默认管理员账户）
• 目录级访问权限控制

数据统计与可视化

• 存储空间使用量监控
• 文件类型分布分析
• 操作日志记录与查询

新手入门：三步搭建个人云存储

环境准备

• JDK 17+ & MySQL 8.0+
• Maven 3.6+ (构建项目)
• Git (克隆代码库)

git clone https://gitcode.com/gh_mirrors/fr/free-fs cd free-fs

初始化数据库

1. 执行SQL脚本：sql/free-fs.sql
2. 配置数据库连接：修改 application.properties 中的数据源参数

启动服务

# 方式1：Maven打包运行 mvn clean package -DskipTests java -jar fs-admin/target/fs-admin.jar # 方式2：Docker部署 docker build -t free-fs:latest . docker run -p 8080:8080 free-fs:latest

访问 http://localhost:8080 即可打开登录界面（默认账号：admin/admin）

2025年重大更新亮点

SpringBoot 3.x全面适配

项目已完成核心依赖升级，支持SpringBoot 3.x新特性，性能提升30%+，兼容JDK 17长期支持版本。

MyBatis Flex ORM框架迁移

从MyBatis Plus平滑过渡到MyBatis Flex，简化CRUD操作，代码生成效率提升40%，配置文件：mybatis-flex.config。

前端交互体验优化

基于Layui重构文件管理界面，新增：

• 文件夹树形结构视图（Dtree组件）
• 大文件分片上传断点续传
• 暗黑模式切换

参与贡献与社区支持

Free-FS采用Apache 2.0开源协议，欢迎开发者通过以下方式参与项目：

• 提交Issue：报告bug或建议新功能
• Pull Request：代码贡献（请遵循项目代码规范）
• 文档完善：补充使用教程或开发指南

核心开发模块目录：

• 公共工具类：fs-common/src/main/java/com/free/fs/common/utils/
• 异常处理：fs-common/src/main/java/com/free/fs/common/exception/handler/

总结：免费、开源、强大的文件管理解决方案

无论你是需要搭建个人网盘，还是企业级文件管理系统，Free-FS都能提供开箱即用的解决方案。其模块化设计既满足新手快速部署的需求，也为开发者预留了充足的扩展空间。立即克隆项目，开启你的云存储自建之旅吧！

git clone https://gitcode.com/gh_mirrors/fr/free-fs

项目持续迭代中，更新日志详见 Update.md 文件。

【免费下载链接】free-fs✨Free-Fs 开源文件管理系统：基于 SpringBoot2.x + MyBatis Plus + MySQL + Sa-Token + Layui 等搭配七牛云，阿里云OSS实现的云存储管理系统。包含文件上传、删除、在线预览、云资源列表查询、下载、文件移动、重命名、目录管理、登录、注册、以及权限控制等功能。项目地址: https://gitcode.com/gh_mirrors/fr/free-fs