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

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

Author: 潘志的研发笔记 · 分类： Java ·    2024年12月 · tags:

01、背景介绍

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

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

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

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

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

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

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

02、方案实践

2.1、minio 快速安装

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

以 windows 操作系统为例，安装命令如下。

docker run 
   -p 9000:9000 
   -p 9001:9001 
   --name minio1 
   -v D:miniodata:/data 
   -e "MINIO_ROOT_USER=ROOTUSER" 
   -e "MINIO_ROOT_PASSWORD=CHANGEME123" 
   quay.io/minio/minio server /data --console-address ":9001"

相关参数解读：

  • docker run：表示启动运行容器
  • -p：表示为容器绑定一个本地的端口
  • -name：表示为容器创建一个本地的名字
  • -v：表示将文件路径设置为容器使用的持久卷位置。当 MinIO 将数据写入 /data时，该数据会镜像到本地路径~/minio/data, 使其能够在容器重新启动时保持持久化。您可以设置任何具有读取、写入和删除权限的文件路径来使用。
  • -e：表示设置登陆控制台的用户名和密码。其中控制台的访问地址为http://本机ip:9001，api 的访问地址为http://本机ip:9000。

如果没有 docker 容器，可以采用软件包方式进行安装，具体实现方式可以参考官网文档，地址如下。

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

服务启动成功之后，在浏览器中访问http://127.0.0.1:9001地址，会看到类似于如下界面。

输入上文设置的用户名和密码，即可登陆！

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 客户端依赖包。

<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>7.1.4</version>
</dependency>
2.3.3、添加相关配置

在application.properties文件中，添加 minio 相关的配置信息.

minio.endpoint=http://127.0.0.1:9000
minio.access-key=o1TJJL9noE69KIgZtKQ0
minio.secret-key=KAi91ZUYHXCzCn1XUiHJ3qQflp50XFqlTCFt6Ik3
minio.bucket-name=public-bucket
2.3.4、编写 Minio 客户端配置类

基于上文的配置信息，编写 Minio 客户端配置类。

@Configuration
public class MinioConfig {
    @Value("${minio.endpoint}")
    private String minioEndpoint;
    @Value("${minio.access-key}")
    private String minioAccessKey;
    @Value("${minio.secret-key}")
    private String minioSecretKey;
    @Bean
    public MinioClient minioClient() {
        return MinioClient.builder()
                .endpoint(minioEndpoint)
                .credentials(minioAccessKey, minioSecretKey)
                .build();
    }
}
2.3.5、编写上传和文件预览服务

接着利用 minioClient 客户端，编写上传和文件预览服务。

@RestController
public class FileController {
    @Value("${minio.bucket-name}")
    private String bucketName;
    @Autowired
    private MinioClient minioClient;
    /**
     * 文件上传
     * @param file
     * @return
     * @throws IOException
     */
    @PostMapping("/upload")
    public String upload(@RequestParam("file") MultipartFile file) {
        try {
            ObjectWriteResponse response = minioClient.putObject(
                    PutObjectArgs
                            .builder()
                            .bucket(bucketName)
                            .object(file.getOriginalFilename())
                            .stream(file.getInputStream(), file.getInputStream().available(), -1)
                            .contentType(file.getContentType())
                            .build()
            );
            return "upload file success，tagId:" + response.etag();
        } catch (Exception e) {
            e.printStackTrace();
            return "upload file error";
        }
    }
    /**
     * 构建预览地址
     * @param fileName
     * @return
     * @throws Exception
     */
    @GetMapping("/getPreviewUrl")
    public String getPreviewUrl(@RequestParam("fileName") String fileName) throws Exception {
        // 构建预览地址，默认15秒过期，无论是私有桶还是公有桶，文件通过链接都可以访问
        String url = minioClient.getPresignedObjectUrl(GetPresignedObjectUrlArgs.builder()
                .method(Method.GET)
                .bucket(bucketName) //存储桶
                .object(fileName) //文件名
                .expiry(15) // 设置过期时间，单位秒
                .build());
        return url;
    }
    /**
     * 构建永久访问地址
     * @param fileName
     * @return
     * @throws Exception
     */
    @GetMapping("/getPublicUrl")
    public String getDownloadUrl(@RequestParam("fileName") String fileName) throws Exception {
        // 构建永久访问地址，前提是这个存储桶允许公开访问
        String url = minioClient.getObjectUrl(bucketName, fileName);
        return url;
    }
}
2.3.6、编写上传页面

在resources/static目录下，创建index.html文件，编写上传页面。

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>文件上传</title>
</head>
<body>
<h1>文件上传</h1>
<form action="/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="file" required>
    <button type="submit">上传</button>
</form>
</body>
</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

5