基于SpringBoot实现的咸鱼云网盘-后端

更多内容请参考项目在线文档 (逐步完善中)

提示

该项目仅为后端，不带前端，前端项目请移步Gitee 或 GitHub

项目介绍

简介

咸鱼云网盘目前是一个用于共享文件和实现私人网盘基本功能的系统，同时具有公共网盘与私人网盘，公共资源站与私有存储云两不误。

功能介绍

基础功能

• 公共网盘与私人网盘两个存储域
• 文件搜索
• 文件收集
• 文件/目录分享
• 外部存储挂载
• 在线解压缩
• 默认按文件哈希散列统一组织文件，支持文件秒传
• 自定义配置桌面组件
• 文本文件在线编辑，markdown编辑实时预览
• 视频在线播放

其他技术特性

• 具有插件系统
• 兼容低版本到高版本的升级，自动更新数据库
• 构建与部署简单，具有统一的属性参数配置系统，大部分参数都能在运行期间通过管理员界面进行动态配置。
• 支持docker部署（文档待补充）
• 支持在线重启
• 系统启动失败会进入紧急模式，可通过/api/error查看启动失败原因，通过/api/admin/sys/restart重启

拓展功能（插件支持）

• 支持存储集群
• 外部存储目录挂载 - MinIO,HDFS,Samba,SFTP协议的外部存储读写支持
• 自定义视频转码、字幕提取
• 作为FTP服务端提供网盘文件访问

杂杂念

该项目是我大二时从无Java基础一边学习一边开发一边重构和维护的项目，难免会有明显bug或明显的设计缺陷。

欢迎各路大佬提出批评、建议和issue。也欢迎感兴趣的大佬贡献代码。

快速开始

0. 打包与编译

全模块打包直接使用package命令即可

$ mvn package

如果单独是对某个拓展模块打包，需要先install sfc-api模块。（若全模块打包失败也可先install sfc-api模块）

$ cd sfc-api; mvn install;
$ cd ../sfc-ext/sfc-ext-demo; mvn package

输出目录：

• 主程序: release/sfc-core.jar
• 拓展插件：release/ext-available/*.jar

1. 运行程序

启动前需要在配置文件config.yml确认MySQL数据库与Redis连接配置，确认或修改无误后

基础启动命令：

$ java -jar sfc-core.jar --spring.config.import=file:config.yml

2 关于数据表

• 项目启动后会自动初始化数据库。若初始化失败，可尝试手动给数据库执行初始化脚本，脚本位于sfc-core/src/main/resource/sql/full.sql
• 目前只在MySQL上测试过系统，不确保其他数据库管理系统可以正常运行

3. 可选插件

位于sfc-ext模块下，打包后各模块jar包在release/ext-available下，若要启用，将其复制到运行目录下的ext目录即可

注意：以下插件均为实验性功能，部分网络存储挂载功能尚不稳定。

目前有以下插件：

4. 插件的加载

jar包模式

如果有已经打包好的插件（jar包），那么直接把插件放到运行目录/ext后，启动主程序即可

开发模式

在maven的develop配置文件环境下，对application-develop.yml的plugin.extra-resource数组补充sfc-ext/插件项目，如：

plugin:
  extra-resource:
    - sfc-ext/sfc-ext-demo
    - sfc-ext/sfc-ext-ftp-server

tips：

1. 插件项目需要使用sfc-ext作为父级，并确保本地仓库安装了sfc-api
2. 插件项目初创或修改了pom.xml后，需要执行mvn clean compile。
3. 启动主程序之前，若修改了插件项目的代码，需要手动构建后再启动主程序，否则加载插件时不会加载到修改后的代码
4. 不要把插件项目添加到主项目的maven依赖中
5. 在IntelliJ IDEA中，插件的代码编译修改后，支持热重载class（其他IDE未测试）

部分前端界面展示

• 支持自定义配置的首页
• 目录浏览支持README.md渲染和在线编辑
• 管理员后台-简单的插件系统