Springboot与minio

Minio是一个简单易用的云存储服务，它让你可以轻松地把文件上传到互联网上，这样无论你在哪里，只要有网络，就能访问或分享这些文件。

游王子

1323人浏览 · 2024-09-18 22:25:40

游王子 · 2024-09-18 22:25:40 发布

1 介绍

Minio是一个简单易用的云存储服务，它让你可以轻松地把文件上传到互联网上，这样无论你在哪里，只要有网络，就能访问或分享这些文件。如果你想要从这个仓库里取出一张图片或一段视频，让网站的访客能看到或者下载，Minio和网站之间就需要配合完成几个步骤：

上传文件：首先，你通过Minio提供的接口或者工具，把视频或图片上传到Minio的服务器上。上传时，你可以设置一些额外的信息，告诉Minio这些文件是可以被公开访问的。
生成链接：当你要在网站上展示这些文件时，Minio能生成一个特殊的网址（我们叫做对象URL）。这个链接直接指向存储在Minio中的视频或图片。关键在于，这个链接可以设置一个有效期，过了时间就失效，保证安全性。
前端显示：网站的前端代码（就是浏览器能看到的部分）会用这个链接去请求Minio服务器上的视频或图片。当浏览器收到这些文件时，如果它们是图片，就会直接显示在页面上；如果是视频，则会在页面上嵌入一个播放器让用户观看。
下载功能：对于下载来说，其实也很简单。因为前端已经有了这个文件的直接链接，用户点击“下载”按钮时，浏览器就会使用这个链接开始下载文件到用户的电脑上，就像平时在网上下载东西一样。

2 部署minio

2.1 Linux 部署

2.1.1 拉取最新的minio镜像

使用docker pull minio/minio命令，下载镜像。

2.1.2 创建目录

一个用来存放配置，一个用来存储上传文件的目录。启动前需要先创建Minio外部挂载的配置文件（ /home/minio/config）,和存储上传文件的目录（ /home/minio/data）。

2.1.3 运行minio容器

docker run -p 9000:9000 -p 9090:9090 \
     --net=host \
     --name minio \
     -d --restart=always \
     -e "MINIO_ACCESS_KEY=minioadmin" \
     -e "MINIO_SECRET_KEY=minioadmin" \
     -v /home/minio/data:/data \
     -v /home/minio/config:/root/.minio \
     minio/minio server \
     /data --console-address ":9090" -address ":9000"

9090端口指的是minio的客户端端口
MINIO_ACCESS_KEY ：账号
MINIO_SECRET_KEY ：密码（账号长度必须大于等于5，密码长度必须大于等于8位）

2.1.4 访问minio

在浏览器输入：服务器地址:9090/login，进入登录界面。输入启动命令中设置的账号密码，进入系统。

2.2 windows 部署

2.2.1 下载服务端和客户端安装包文件

下载地址：MinIO | Code and downloads to create high performance object storage

服务端文件:minio.exe 用于接收文件信息
客户端文件:mac.exe 用于上传文件，如果用程序代码操作文件存储，只启动服务端就可以。

2.2.2 创建minio目录

创建一个minio的文件夹，存放minio相关文件

在minio文件夹中创建minio的应用目录bin，存放mc.exe 以及minio.exe 文件。
在minio文件夹中创建minio的数据目录data，存放相关数据文件
在minio文件夹中创建minio的数据目录log，存储相关日志

2.2.3 启动Minio服务

.\minio.exe server ..\data --console-address "127.0.0.1:9000" --address "127.0.0.1:9005"

使用浏览器输入localhost:9000访问，输入上面启动窗口中显示的帐号密码登入：

2.2.4 修改默认账户密码

setx MINIO_ROOT_USER 帐号

 setx MINIO_ROOT_PASSWORD 密码

三、minio系统操作

1、创建用户

设置账号密码，勾选所有策略。

2、创建组

设置组名，并向该组中添加用户。

3、创建accessKey和secretKey

直接点击创建即可。

出现弹窗，点击下载。

文件内容如下所示，保存文件，SDK操作文件的API需要用到：

{"url":"http://192.168.197.131:9090/api/v1/service-account-credentials","accessKey":"S2I6E378jrzSLTY0X0WY","secretKey":"vOGE87WIe3ilh4Ff2CUEzKuUskiZXctubjYkwcnC","api":"s3v4","path":"auto"}

4、创建Bucket（桶）

设置名字，点击创建。

点击进入桶的设置界面，当把桶的访问策略设置为public时，桶中的文件可以通过{服务器地址:minio服务端口号}/{bucketName}/文件名的方式访问。

5、上传文件

选择要上传到的bucket。

点击upload上传。

四、springboot项目中使用minio

1、添加依赖

minio包中自带的okhttp3会报错，需要排除依赖后重新引入。springboot3版本无需额外引入。

<dependency>
            <groupId>com.squareup.okhttp3</groupId>
            <artifactId>okhttp</artifactId>
            <version>4.12.0</version>
        </dependency>

        <dependency>
            <groupId>io.minio</groupId>
            <artifactId>minio</artifactId>
            <version>8.5.12</version>
            <exclusions>
                <exclusion>
                    <artifactId>okhttp</artifactId>
                    <groupId>com.squareup.okhttp3</groupId>
                </exclusion>
            </exclusions>
        </dependency>

2、编写测试代码

package com.zkdj.applet.common;

import io.minio.*;
import io.minio.errors.*;
import org.junit.jupiter.api.Test;

import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;

/**
 * 类描述 -> minio测试类
 *
 * @Author: ywz
 * @Date: 2024/09/18
 */
public class MinioTest {


    /**
     * 方法描述 -> 测试MinIO上传功能
     * 该方法用于验证MinIO客户端的连接，并尝试向指定的存储桶上传文件。如果存储桶不存在，则创建它。
     * 使用了MinioClient来构建与MinIO服务器的连接，并执行相应的操作。
     *
     * @Author: ywz
     * @Date: 2024/09/18
     */
    @Test
    public void minioTest() {
        try {
            // 初始化MinioClient，设置服务器端点和访问凭证
            MinioClient minioClient =
                    MinioClient.builder()
                            .endpoint("http://192.168.197.131:9000")
                            .credentials("S2I6E378jrzSLTY0X0WY",
                                    "vOGE87WIe3ilh4Ff2CUEzKuUskiZXctubjYkwcnC")
                            .build();

            // 检查指定的存储桶是否存在
            boolean found = minioClient.bucketExists(BucketExistsArgs.builder().bucket("public").build());
            // 如果存储桶不存在，则创建它
            if (!found) {
                minioClient.makeBucket(MakeBucketArgs.builder().bucket("public").build());
            }

            // 向存储桶上传文件

            minioClient.uploadObject(
                    UploadObjectArgs.builder()
                            .bucket("public")
                            .object("原神 2024_8_31 22_34_51.png")
                            .filename("C:\\Users\\86176\\Videos\\Captures\\原神 2024_8_31 22_34_51.png")
                            .build());
            // 输出上传成功的提示信息
            System.out.println("文件上传成功");
            GetObjectArgs getObjectArgs = GetObjectArgs.builder().bucket("public").object("原神 2024_8_31 22_34_51.png").build();
            // 获取文件信息，包含了桶、对象名、请求头等信息。
            GetObjectResponse object = minioClient.getObject(getObjectArgs);
            BufferedInputStream bis = new BufferedInputStream(object);
            // 将文件写入到本地文件系统
            FileOutputStream fos = new FileOutputStream("D:\\原神图片.png");
            BufferedOutputStream bos = new BufferedOutputStream(fos);
            int i = 0;
            while ((i = bis.read()) != -1) {
                bos.write(i);
            }
            bos.flush();
            bis.close();
            bos.close();
        } catch (MinioException e) {
            // 处理MinIO异常
            System.out.println("发生错误: " + e);
            System.out.println("HTTP跟踪: " + e.httpTrace());
        } catch (IOException | NoSuchAlgorithmException | InvalidKeyException e) {
            // 处理其他潜在异常
            throw new RuntimeException(e);
        }
    }
}