README.md

Free-Fs — 开源文件管理系统

---

📖 项目简介

✨Free-Fs 开源文件管理系统：基于 SpringBoot2.x + MyBatisPlus + MySQL + Shiro+ Layui 等搭配七牛云，阿里云OSS实现的云存储管理系统。包含文件上传、删除、预览、云资源列表查询、下载、文件移动、重命名、目录管理、登录、注册、以及权限控制等功能。

源码链接：

• Gitee：https://gitee.com/dh_free/free-fs
• Github：https://github.com/dh-free/free-fs

开发文档： https://dh_free.gitee.io/free-fs-doc

体验地址： https://fs.elites.icu

内置账号

	账号	密码	权限
管理员	admin	admin	所有权限
普通用户	fs	fs	查看，复制，下载，上传

📚 项目技术栈

后端：

• Spring Boot 2.6.6
• orm: MyBatis Plus 2.5.1
• 数据库：MySQL 8.0
• 权限安全控制：shiro
• 本地缓存：ehcache
• 文件上传：七牛云 阿里云OSS

前端：

• Thymeleaf
• Layui v2.5.5
• Jquery
• Ajax

🛶 系统设计

💻 项目开发环境

• 操作系统：Windows 11、macOS
• 构建工具：Maven 3.8.1
• 开发工具：Intellij IDEA
• 应用服务器：Undertow
• 接口测试工具：Postman
• 压力测试工具：Apache JMeter
• 版本控制工具：Gitee
• Java 版本：8
• idea开发插件: lombok

📁 项目结构

- sql                         项目数据库文件
- src
  - main
    - java
    - com.free.fs
      - common                公共模块
        - aspect              自定义切面
        - config              系统基本配置，web跨域和七牛云配置
        - constant            系统常量
        - exception           全局异常处理和自定义异常
        - properties          资源读取类
        - shiro               shiro配置与自定义认证和授权
        - utils               系统工具类
      - controller            控制层
      - mapper                mapper接口层
      - model                 实体模型层
      - service               业务接口
        -impl                 业务接口实现
      - xxApplication.java    启动类
  - resources
    - mapper                  mybatis mapper.xml
    - shiro                   缓存配置文件
    - static                  静态资源包存放js css 第三方插件
    - templates               静态页面 html
    - application.yml         配置文件
    - application-dev.yml     开发环境配置
    - application-pro.yml     生产环境配置
    - application-preview.yml 演示环境配置

👀 界面预览

登录页： 注册页： 主页： 资源操作： 目录管理： 重命名： 添加文件夹： 移动文件或目录： 删除文件：

❤ 特别鸣谢

• 感谢 synchronized 大佬提供的前端模板

🔗 友情链接

• EleAdmin 通用型后台管理模板，界面美观、开箱即用拥有丰富的扩展组件和模板页面，适合各类中后台应用。
• Echo 一套前后端不分离的开源社区系统。

📧 反馈交流

• QQ交流群：739596094

☎ 联系我

• 有什么问题也可以添加我的微信，请注明来意！