2023-10-18 17:16:51 +08:00
|
|
|
|
# minio-plus
|
|
|
|
|
|
|
|
|
|
|
|
[MinIO-Plus](https://github.com/lxp135/minio-plus/) 是一个 [MinIO](https://github.com/minio/minio) 的二次封装与增强工具，在 MinIO 的基础上只做增强，不侵入 MinIO 代码，只为简化开发、提高效率而生。成为 MinIO 在项目中落地的润滑剂。
|
|
|
|
|
|
|
|
|
|
|
|
> 我们的愿景是成为 MinIO 最好的搭档。
|
|
|
|
|
|
|
|
|
|
|
|
# 特性
|
|
|
|
|
|
|
|
|
|
|
|
* **无侵入** ：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑。
|
2024-05-14 16:20:00 +08:00
|
|
|
|
* **文件秒传** ：对每个上传的文件进行哈希摘要识别，用户上传同一个文件时，没有文件实际传输过程，做到秒传。
|
2023-10-18 17:16:51 +08:00
|
|
|
|
* **并发上传** ：将文件切分为小块。同时并发上传多个小块，最大限度地利用带宽，加快上传速度。
|
|
|
|
|
|
* **断点续传** ：在传输过程中遇到问题导致传输失败，只需重新传输未完成的小块，而不需要重新开始整个传输任务。
|
|
|
|
|
|
* **缩略图生成** ：识别文件类型，在图片上传时自动生成缩略图，缩略图大小可配置。
|
|
|
|
|
|
* **自动桶策略** ：按照文档、压缩包、音频、视频、图片等类型自动建桶，按照`/年/月`划分路径，避免受到操作系统文件目录体系影响导致性能下降。
|
|
|
|
|
|
* **访问权限控制** ：可支持基于用户、组的文件权限控制，保证重要文件的安全性。
|
|
|
|
|
|
* **访问链接时效** ：基于 MinIO 的临时链接创建策略，提供具备有效期并预签名的上传与下载地址。
|
|
|
|
|
|
* **前端直连** ：前端直连 MinIO ，项目工程不做文件流的搬运，在支持以上特性的情况下提供 MinIO 原生性能。
|
|
|
|
|
|
|
|
|
|
|
|
# 架构设计
|
|
|
|
|
|
|
2024-05-14 16:20:00 +08:00
|
|
|
|
项目定位是一个SDK，非独立部署服务，并支持spring-boot自动装配。
|
|
|
|
|
|
用户自行实现数据存储部分，项目仅提供MySQL默认实现。
|
|
|
|
|
|
|
2024-05-14 17:59:52 +08:00
|
|
|
|
## 文件下载时序图
|
2024-05-14 18:03:48 +08:00
|
|
|
|
|
2024-05-14 17:59:52 +08:00
|
|
|
|
|
|
|
|
|
|
浏览器向服务端发起文件读取请求，服务端会根据fileKey入参取得文件的元数据信息。获取文件元数据信息后，根据元数据信息中的是否私有字段和所有者字段判断是否具备文件读取权限。
|
|
|
|
|
|
|
|
|
|
|
|
* 当用户具备读取权限时，服务端请求MinIO服务器获取经过预签名的文件访问地址返回给浏览器。
|
|
|
|
|
|
* 当用户不具备读取权限时，返回给浏览器无访问权限提示信息。
|
|
|
|
|
|
|
|
|
|
|
|
浏览器拿到真实文件地址后，读取文件并显示或下载。
|
|
|
|
|
|
|
|
|
|
|
|
## 文件上传时序图
|
|
|
|
|
|
|
|
|
|
|
|
## 秒传时序图
|
|
|
|
|
|
|
2023-10-18 17:16:51 +08:00
|
|
|
|
# 代码托管
|
|
|
|
|
|
|
2024-05-14 16:20:00 +08:00
|
|
|
|
代码托管在 [https://github.com/lxp135/minio-plus](https://github.com/lxp135/minio-plus/) 仓库中，jar 发布到 Maven 中央仓库。
|
|
|
|
|
|
|
2023-10-18 17:16:51 +08:00
|
|
|
|
# 参与贡献
|
|
|
|
|
|
|
2024-05-14 16:20:00 +08:00
|
|
|
|
* 刘小平 contact@liuxp.me
|
