SpringBoot + MinIO 轻松构建对象存储服务，支持私有化部署！

在实际的软件系统开发过程中，经常避免不了需要用到文件存储服务。例如，对于小型的网站系统，通常会将文件存储服务和网站系统部署在一台服务器中，以实现低成本的资源投入，如果访问量不大，基本上没什么问题。当访问量逐渐升高，此时网站的文件资源读取越来越频繁，单台服务器可能难以承载较大的请求量，这个时候网站可能会出现打不开，甚至系统异常等问题。当出现这个场景，很容易第一时间想到将文件采用云存储服务来解决。

python_知世

1464人浏览 · 2024-08-14 10:43:06

python_知世 · 2024-08-14 10:43:06 发布

01、背景介绍

在实际的软件系统开发过程中，经常避免不了需要用到文件存储服务。

例如，对于小型的网站系统，通常会将文件存储服务和网站系统部署在一台服务器中，以实现低成本的资源投入，如果访问量不大，基本上没什么问题。当访问量逐渐升高，此时网站的文件资源读取越来越频繁，单台服务器可能难以承载较大的请求量，这个时候网站可能会出现打不开，甚至系统异常等问题。

当出现这个场景，很容易第一时间想到将文件采用云存储服务来解决。所谓云存储服务，简单的说，就是将访问很频繁的文件资源服务，由本地改成云厂商提供的文件存储服务，比如阿里云 OSS、七牛云、腾讯云、百度云等等，迁移之后，网站的访问压力会得到极大的释放，服务也会变得更加稳定。但是，这些云存储服务大部分都是收费的，以阿里云为例，数据存储通常按照 0.12 元/GB/月的标准来收费，虽然便宜，但是日积月累下来也是一笔不小的开支啊。

为了节省成本，很多项目团队会自己搭建一套云存储服务，比如采用开源的 fastDFS 工具来作为文件存储服务器，虽然能性能不错，但是软件安装环境非常复杂，最重要的是没有一个完整的技术文档，大部分都是某某公司或者某某网友自己总结的文档，每次维护起来很是麻烦。

直到出现了 MinIO，云存储服务工具又多了一个新的可选项。

MinIO 是一款号称世界上速度最快的对象存储服务器，专为大规模数据存储和分析而设计。它支持在各种环境中部署，包括物理服务器、虚拟机、容器等，最关键的是它的技术文档非常完善，非常容易上手；同时，对个人用户是完全开源免费的。

今天通过这篇文章，我们一起了解一下如何利用 MinIO 来搭建一套属于自己的云存储服务。

02、方案实践

2.1、minio 快速安装

minio 工具的安装非常简单，如果你本机安装了 Docker 容器，可以通过 Docker 命令一键实现安装操作。

以 windows 操作系统为例，安装命令如下。
在这里插入图片描述

2.2、minio 使用介绍

登陆成功之后，会看到类似于如下的主界面。

由于官方并没有提供汉化版，如果想要实现中文展示，可以使用浏览器插件进行翻译，翻译之后的内容如下。

在对象存储服务里面，所有的文件都是以桶的形式来组织的。简单的说，你可以将桶看作是目录，这个目录下有很多的文件或者文件夹，这和其它云存储服务基本一致。

下面我们一起来快速体验一下！

2.2.1、创建存储桶

所有的文件必须要存储到桶中，因此我们需要先创建一个存储桶。

如果想要修改存储桶信息，点击左侧的Buckets菜单，就可以看到相关的存储桶配置信息。

2.2.2、上传和下载文件

存储桶创建完成之后，就可以上传文件了。

点击Object Browser菜单，可以看到刚刚创建的存储桶public-bucket，点击进入，上传我们想要存储的文件了。

如果想要下载文件或者预览文件，点击文件，右侧会弹出相关的操作按钮，点击相应的操作按钮就可以了。

2.2.3、设置文件公开访问

默认创建的存储桶，都是私有桶，也就是说无法被公开访问。

以上文的文件为例，如果以 api 的方式直接访问，会提示无权限，示例如下：

通常来说，我们会将数据写入操作进行控制；对于读操作，很多不涉及安全问题的，我们希望能被互联网公开访问，以便加快文件的访问速度，此时如何实现呢？

可以在存储桶里面配置，将数据读取权限设置为公开访问，操作示例如下：

此时，我们再次以 api 的方式访问，结果如下：

可以清晰的看到，此时文件可以公开访问了。

2.3、springBoot 集成 minio 实现文件存储

最后，我们一起来看看，如何在 Spring Boot 工程中集成 minio 客户端以便实现文件存储服务。

2.3.1、创建用户访问密钥

MinIO 支持通过用户、密码来管理存储桶，我们可以利用 minio 客户端来实现文件的上传和下载。

点击Access Keys菜单，创建用户名和密码并将其保存，下文会用到。

2.3.2、引入依赖包

在 Spring Boot 工程，引入 minio 客户端依赖包。

在这里插入图片描述

2.3.3、添加相关配置

在application.properties文件中，添加 minio 相关的配置信息.
在这里插入图片描述

2.3.4、编写 Minio 客户端配置类

基于上文的配置信息，编写 Minio 客户端配置类。
在这里插入图片描述

2.3.5、编写上传和文件预览服务

接着利用 minioClient 客户端，编写上传和文件预览服务。
在这里插入图片描述

2.3.6、编写上传页面

在resources/static目录下，创建index.html文件，编写上传页面。
在这里插入图片描述

2.3.7、最后验证一下服务

最后，将服务启动，一起来验证一下代码的正确性。

1）上传服务验证

在浏览器端，访问http://127.0.0.1:8080/，选择文件并上传，示例如下。

回到 minio 控制台，可以看到刚刚上传的文件信息。

2）文件预览地址验证

在浏览器端，访问http://127.0.0.1:8080/getPreviewUrl?fileName=图片.jpeg，会返回一段带有签名的文件预览地址，示例如下。

将其地址复制出来直接访问，可以清晰的看到图片能正常展示。

通过getPresignedObjectUrl()方法生成的文件地址链接，无论是是公有桶还是私有桶，都可以正常访问。与getObjectUrl()方法生成的文件预览地址相比，它带有过期时间，这样设计的目的也是为了保护文件资源，避免频繁窃取。

03、小结

最后总结一下，本文主要围绕利用 minio 实现对象存储服务，进行了一次知识内容的总结，如果有描述不对的地方，欢迎留言指出。

在实际的使用过程中，通常会这样处理。

如果当前文件不包含隐私信息，比如图片，可以配置公共访问权限，构建永久访问链接。
如果当前文件包含隐私信息，比如营业执照图片，可以配置私有桶，构建带有有效时长的访问链接，比如配置过期时间1小时等。

示例代码地址：

https://gitee.com/pzblogs/spring-boot-example-demo

04、参考

1.https://minio.org.cn/docs/minio/container/index.html

写到最后

如何学习大模型 AI ？

由于新岗位的生产效率，要优于被取代岗位的生产效率，所以实际上整个社会的生产效率是提升的。

但是具体到个人，只能说是：

“最先掌握AI的人，将会比较晚掌握AI的人有竞争优势”。

这句话，放在计算机、互联网、移动互联网的开局时期，都是一样的道理。

我在一线互联网企业工作十余年里，指导过不少同行后辈。帮助很多人得到了学习和成长。

我意识到有很多经验和知识值得分享给大家，也可以通过我们的能力和经验解答大家在人工智能学习中的很多困惑，所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限，很多互联网行业朋友无法获得正确的资料得到学习提升，故此将并将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

在这里插入图片描述