在SpringBoot应用中使用Minio作为云存储服务

最新推荐文章于 2025-10-10 19:56:43 发布

原创

最新推荐文章于 2025-10-10 19:56:43 发布 · 1.5k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot

在SpringBoot应用中使用Minio作为云存储服务

除去阿里云之类的公有云，自己搭建一个私有云也是蛮不错的，虽然访问速率受到服务器带宽限制，但是它的存储和访问都是免费的。对于一般的APP来说，够够的。

Minio

Minio是什么

Minio是Apache License v2.0下发布的对象存储服务器
它与Amazon S3云存储服务兼容
它最适合存储非结构化数据: 如照片, 视频, 日志文件, 备份和容器/VM映像
对象的大小可以从几KB到最大5TB
Minio服务器足够轻, 可以与应用程序堆栈捆绑在一起, 类似于NodeJS, Redis和MySQL

官方地址

Github
https://github.com/minio/minio

中文文档
https://docs.min.io/cn/minio-quickstart-guide.html

安装

Minio可以使用Docker或者二进制文件的方式进行安装部署。

推荐使用Docker，这种方式便捷好维护。在开始安装之前。确定你的服务器正确的安装了Docker。

安装指令

docker run -p 9000:9000 --name minio1 \
-e "MINIO_ACCESS_KEY=AKIAIOSFO******" \
-e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K******" \
-v /mnt/data:/data \
-v /mnt/config:/root/.minio \
minio/minio server /data

MINIO_ACCESS_KEY 和 MINIO_SECRET_KEY 可以理解为访问web控制台和api接口的账户名和密码。千万要认真设置。
共享卷的设置
- -v /mnt/data:/data \，指定数据存储在宿主机的 /mnt/data
- -v /mnt/config:/root/.minio \，指定宿主机的配置文件目录 /mnt/config

耐心等待安装完成，安装成功如下图。Minio在 9000 端口提供服务

Web控制台的基本使用

打开控制台：http://{host}:9000/minio/，输入用户名和密码（安装时设置的 MINIO_ACCESS_KEY
和 MINIO_SECRET_KEY）登录到主页面

整个后台干净，简单。这也是Minio迷人的一个地方

Bucket的添加

Bucket，表示一个仓库，从存储上来说，可以理解为一个目录。可以通过右下角的圆点菜单来创建多个。
在Bucket中，可以通过顶部的路径菜单添加路径，可以通过右下角的圆点菜单，上传文件到当前路径。

Bucket的匿名读写权限

Bucket中的资源，默认情况下，不允许匿名用户访问。鼠标指向Bucket，可以从左边菜单中选择Edit Policy，添加Bucket的匿名访问权限。
可以添加多个权限，使用不同的访问 prefix 区分。

一般都是允许匿名读，所以添加一个 Rea Only记录即可

资源的访问路径

http://{host}:9000/{bucket}/{file}

例如我在名为images的bucket中有一张图片在路径 /2020/06/19 目录下，名字叫做 58c4e5c7fd6714e4fa7cc5527d9091080207633d.png
则访问路径为：
http://{host}:9000/images/2020/06/19/58c4e5c7fd6714e4fa7cc5527d9091080207633d.png

授予文件的临时读取权限

有些特定的资源，不允许匿名用户随意的访问。此时可以删除掉bucket的Edit Policy。不允许匿名用户随意访问。

在指定资源的菜单中，选择Share Object，创建一个资源临时的访问链接。并且可以设置过期时间

在SpringBoot中使用Minio

Minio提供的SDK

<!-- https://mvnrepository.com/artifact/io.minio/minio -->
<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>7.0.2</version>
<