fs-doc: A CSS repository from xddcode

项目介绍

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

源码地址：

Gitee
Github

开发文档： 文档

在线预览： https://fs.elites.chat

内置账号：

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

快速了解

主要特性

整合阿里云、七牛云两个当下火热的云存储，对存储管理操作快速便捷。
代码简化整洁，适合二次开发。
利用mybatisPlus的多租户特性，只需更改一个配置就能动态切换当前系统使用的存储类型（本地Local、七牛云还是阿里云）。
项目前后端没有分离，降低上手开发难度。
全局异常统一拦截和处理，避免繁琐的判断。
自定义权限注解与匿名接口注解，可快速对接口拦截与放行。
移除内嵌Tomcat容器，使用Undertow来提高性能。

主要功能

用户管理：实现用户登录，与注册。
文件管理：实现对文件上传，下载，查看，重命名，移动，删除等管理。
权限控制：不同角色登录的用户，对文件的操作权限不同。
目录管理：文件夹目录管理，重命名，移动，删除等。

项目结构

- sql                         项目数据库文件
- src
  - main
    - java
    - com.free.fs
      - common                公共模块
        - annotation          自定义注解
        - aop                 自定义切面
        - config              系统基本配置，本地资源映射、sa拦截器注册，跨域配置等
        - constant            系统常量
        - domian              系统实体类
        - exception           全局异常处理和自定义异常
        - properties          资源读取类
        - template            文件上传模板类
        - utils               系统工具类
      - controller            控制层
      - mapper                mapper接口层
      - model                 实体模型层
      - service               业务接口
        -impl                 业务接口实现
      - xxApplication.java    启动类
  - resources
    - mapper                  mybatis mapper.xml
    - static                  静态资源包存放js css 第三方插件
    - templates               静态页面 html
    - application.yml         配置文件
    - application-dev.yml     开发环境配置
    - application-prod.yml    生产环境配置

快速开始

系统设计

项目技术栈

后端：

Spring Boot 2.6.6
orm: MyBatis Plus 3.5.1
数据库：MySQL 8.0+
权限安全控制：Sa-Token
本地缓存：Ehcache
文件上传：本地Local、七牛云、阿里云OSS

前端：

Thymeleaf
Layui v2.5.5
Jquery
Ajax

所需环境

操作系统：Windows 10
构建工具：Maven
开发工具：Intellij IDEA
应用服务器：Apache Tomcat
接口测试工具：Postman
压力测试工具：Apache JMeter
版本控制工具：Gitee
Java 版本：8
七牛云存储
阿里云存储

1. JDK：1.8+ 
安装教程：https://www.runoob.com/java/java-environment-setup.html
2. Maven 3.0+
安装教程：https://www.runoob.com/maven/maven-setup.html
3. MYSQL 5.7+
安装教程：https://www.runoob.com/mysql/mysql-install.html

开发准备

!> 为了便于项目开发，你可能还需以下准备。

1. idea安装lombok插件，否则项目会报错。lombok主要工作是简化代码，节省不必要的时间。具体可以查看：lombok
1. 了解MybatisPlus，本人比较懒，大多数sql都用mp代替，所以不熟悉mp的同学可能看不懂代码。具体可以查看：MybatisPlus
1. 项目是由Springboot开发，所以你还需要springboot的相关知识，具体可以查看：Springboot
1. 前端是由Layui+jquery实现，所以你需要去看看layui的部分基础和语法，具体可以查看：Layui
1. 认证授权是用Shiro实现，不妨也可以去看一看：Shiro

运行项目

打开idea，导入git项目

输入我们的git地址：https://gitee.com/dh_free/free-fs.git

导入成功后，配置我们的本地maven地址

idea如果是2019之前的版本记得在配好maven后会弹出一个选择框，记得勾选：Enable Auto-Import 自动导入包，这样在每次修改pom.xml后idea会自动更新jar包。

等待项目开始下载依赖包，如果下载太慢，记得给自己的maven配置阿里镜像，找到自己maven安装目录conf/setting.xml,加入以下配置：

 <mirrors>
    <mirror>  
      <id>alimaven</id>  
      <name>aliyun maven</name>  
      <url>http://maven.aliyun.com/nexus/content/groups/public/</url>  
      <mirrorOf>central</mirrorOf>          
    </mirror> 
  </mirrors>

镜像配置好后，如果下载突然卡住了，则关掉idea后在重新打开，然后点击Reimport按钮重新拉取，如果不行多试几次：