MinIO

原创

已于 2025-03-23 14:30:12 修改 · 800 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot

于 2025-03-21 13:59:01 首次发布

MinIO详解及与Spring Boot整合指南

一、MinIO概述

1.1 什么是MinIO

MinIO是一个高性能、分布式的对象存储系统，它兼容Amazon S3云存储服务接口，非常适合于存储大容量非结构化的数据，例如图片、视频、日志文件、备份数据和容器/虚拟机镜像等。MinIO采用Go语言开发，可以作为云原生应用程序的主要存储系统。

1.2 MinIO的主要特点和优势

高性能：单个MinIO服务器可以处理每秒数百个请求
可扩展性：支持无限扩展，从TB到EB的数据量
兼容S3 API：完全兼容Amazon S3 API，可以无缝切换
简单部署：一个二进制文件，无外部依赖
支持纠删码：提高数据可靠性和空间利用率
跨平台：支持Windows、Linux、macOS等多种操作系统
开源：基于Apache v2许可证的开源项目
安全：支持SSL/TLS加密和客户端身份验证

1.3 MinIO的应用场景

大数据分析存储
应用程序数据存储
网站静态文件托管
备份/归档
私有云对象存储

二、Windows环境下安装MinIO

2.1 系统要求

Windows 7及以上版本
至少2GB RAM（推荐4GB以上）
建议使用SSD硬盘以获得更好的性能

2.2 下载MinIO

访问MinIO官方下载页面：https://min.io/download
选择Windows版本下载，或者直接通过以下链接下载：
- 64位版本：https://dl.min.io/server/minio/release/windows-amd64/minio.exe

2.3 安装步骤

MinIO在Windows上不需要安装，只需要下载可执行文件即可。

将下载的minio.exe文件放置在你希望的位置，例如：D:\minio
在该目录下创建一个数据文件夹，例如：D:\minio\data

2.4 配置MinIO

为了方便启动，可以创建一个批处理文件：

在MinIO目录下创建一个名为start-minio.bat的文件
编辑该文件，添加以下内容：

@echo off
set MINIO_ROOT_USER=admin
set MINIO_ROOT_PASSWORD=password
minio.exe server D:\minio\data --console-address ":9001"

这里设置了:

管理员用户名：admin
管理员密码：password
数据存储路径：D:\minio\data
控制台地址：localhost:9001（默认API端口为9000）

2.5 启动MinIO服务

双击start-minio.bat文件或在命令提示符中运行该文件即可启动MinIO服务。

启动后，你将看到类似以下的输出：

MinIO Object Storage Server
Copyright: 2015-2023 MinIO, Inc.
License: GNU AGPLv3 <https://www.gnu.org/licenses/agpl-3.0.html>
Version: RELEASE.2023-XX-XX-XX-XX-XX

Status:         1 Online, 0 Offline. 
API: http://192.168.1.X:9000  http://127.0.0.1:9000     
Console: http://192.168.1.X:9001 http://127.0.0.1:9001  

Documentation: https://min.io/docs/minio/linux/index.html

2.6 验证安装

打开浏览器，访问控制台地址：http://localhost:9001
使用配置的用户名（admin）和密码（password）登录
登录成功后，你将看到MinIO的管理控制台界面

三、MinIO与Spring Boot整合

3.1 项目依赖配置

在Spring Boot项目的pom.xml文件中添加MinIO客户端依赖：

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- MinIO客户端 -->
    <dependency>
        <groupId>io.minio</groupId>
        <artifactId>minio</artifactId>
        <version>8.5.2</version>
    </dependency>
    
    <!-- Lombok(可选) -->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>

3.2 Spring Boot配置

在application.properties或application.yml文件中添加MinIO的配置：

# application.properties
# MinIO配置
minio.endpoint=http://localhost:9000
minio.accessKey=admin
minio.secretKey=password
# 默认存储桶
minio.bucketName=files

YAML格式：

# application.yml
minio:
  endpoint: http://localhost:9000
  accessKey: admin
  secretKey: password
  bucketName: files

3.3 创建MinIO配置类

package com.example.config;

import io.minio.MinioClient;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MinioConfig {
    
    @Value("${minio.endpoint}")
    private String endpoint;
    
    @Value("${minio.accessKey}")
    private String accessKey;
    
    @Value("${minio.secretKey}")
    private String secretKey;
    
    @Bean
    public MinioClient minioClient() {
        return MinioClient.builder()
                .endpoint(endpoint)
                .credentials(accessKey, secretKey)
                .build();
    }
}

3.4 创建MinIO服务类

创建一个服务类，封装MinIO的操作：

package com.example.service;

import io.minio.*;
import io.minio.http.Method;
import io.minio.messages.Bucket;
import io.minio.messages.Item;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;

import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.TimeUnit;

@Service
public class MinioService {

    @Autowired
    private MinioClient minioClient;
    
    @Value("${minio.bucketName}")
    private String bucketName;
    
    /**
     * 检查存储桶是否存在
     */
    public boolean