# boot-file

**Repository Path**: likeywy/boot-file

## Basic Information

- **Project Name**: boot-file
- **Description**: 基于SpringBoot+elFinder的文件管理系统，目前支持本地文件系统、阿里云OSS
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2023-10-17
- **Last Updated**: 2025-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# boot-file

基于SpringBoot+elFinder的文件管理系统，目前支持本地文件系统、阿里云OSS


## 功能介绍
- 文件以及文件夹的新建，复制、剪切、删除，重命名、查看详情
- 文件上传、下载
- 在线预览（文档、图片）
- 在线富文本编辑器打开文档
- 在线处理文件
- 在线压缩文件和文件夹
- 在线解压缩
- 文件拖拽
- 支持国际化
- 支持多种文件系统（目前仅实现本地文件系统、阿里云OSS，其他可自行扩展） 
- 图片在线调整大小、裁切、旋转（待实现）


## 技术选型
基础框架：Spring Boot  
脚手架：[boot-admin](https://gitee.com/likeywy/boot-admin.git)  
文件管理器前端：[elFinder2.1.62](https://studio-42.github.io/elFinder)  
文件管理器服务端：[elfinder-java-connector](https://github.com/trustsystems/elfinder-java-connector)


## 开发环境  
* JDK1.8  
* IntelliJ IDEA


## 项目展示 
1.本地文件
![登录界面](doc/1.png)

2.阿里云OSS
![主页](doc/2.png)


## 项目部署
### 配置说明
```yaml
file-manager:
  thumbnail:
    width: 80 #缩略图宽
  workspaces:
    - space:
      source: fileSystem #文件系统来源
      alias: 本地 # 目录别名
      path: D:/cloudFile #文件存放目录
      _default: false #是否默认打开
      locale:
      constraint: #约束
        locked: false #文件夹是否锁定
        readable: true #是否可读
        writable: true #是否可写
    - space:
      source: aliyunoss
      alias: 阿里云
      _default: true
      locale:
      constraint:
        locked: false
        readable: true
        writable: true
      aliyunoss:
        bucketName:  #Bucket名称
        endpoint: oss-cn-beijing.aliyuncs.com #地域节点
        accessKeyId:  #密钥
        accessKeySecret:  #密钥
        bucketDomain: #Bucket域名
```

### 部署项目
1. 下载源码
2. 编译源码  
在工程下执行`maven clean install`命令下载依赖。
3. 导入数据库  
使用数据库脚本`doc/boot-admin.sql`，初始化数据库。同时修改工程的application.yml文件中的数据源等配置信息。
4. 服务器运行项目  
执行`maven clean package`命令进行打包，将打包后的jar文件上传服务器，执行命令运行项目：
```
nohup java -jar boot-file..jar >run.log 2>&1 &
```

运行地址：http://localhost:8080  
账号密码：admin/123456