SpringBoot三十六：整合MinIo文件服务

什么是MinIo

Minio是Apcche旗下的一款开源的轻量级文件服务器，基于对象存储，协议是基于Apache License v2.0，开源可用于商务。

Minio主要用来存储非结构化的数据，类似文件，图片，照片，日志文件，各类备份文件等，按照官网描述，文件的大小从几KB到5TB。

Minio提供了非常方便，友好的界面，并且文档也是非常丰富，具体可以参考它的文档：https://docs.min.io/cn/

为什么选择MinIo

在之前开发中曾使用了分布式文件服务FASTDFS和阿里云的OSS对象存储来存储。奈何OSS太贵，FASTDFS搭建配置又太繁琐，今天给大家推荐一款极易上手的高性能对象存储服务MinIo。

MinIO 是高性能的对象存储，兼容 Amazon S3接口，充分考虑开发人员的需求和体验；支持分布式存储，具备高扩展性、高可用性；部署简单但功能丰富。官方的文档也很详细。它有多种不同的部署模式（单机部署，分布式部署）。

为什么说 MinIO 简单易用，原因就在于它的启动、运行和配置都很简单。可以通过 docker 方式进行安装运行，也可以下载二进制文件，然后使用脚本运行。

安装MinIo

推荐使用 docker 一键安装：

docker run -it -p 9000:9000 --name minio \
-d --restart=always \
-e "MINIO_ACCESS_KEY=admin" \
-e "MINIO_SECRET_KEY=admin123456" \
-v /mnt/minio/data:/data \
-v /mnt/minio/config:/root/.minio \
minio/minio server /data

注意：

• 密钥必须大于8位，否则会创建失败
• 文件目录和配置文件一定要映射到主机，你懂得

整合Nginx

server{
    listen 80;
    server_name minio.javakf.com.cn;
    location /{
        proxy_set_header Host $http_host;
        proxy_pass http://localhost:9000;
    }
    location ~ /\.ht {
        deny  all;
    }
}

这样，通过浏览器访问配置的地址，使用指定的 MINIO_ACCESS_KEY 及 MINIO_SECRET_KEY 登录即可。

简单看了一下，功能还算可以，支持创建Bucket，文件上传、删除、分享、下载，同时可以对Bucket设置读写权限。

整合SpringBoot

Minio支持接入JavaScript、Java、Python、Golang等多种语言，这里我们选择最熟悉的Java语言，使用最流行的框架 SpringBoot。

pom.xml引入

<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>7.0.2</version>
</dependency>

application.properties配置

# MinIo文件服务器
min.io.endpoint = http://minio.javakf.com.cn
min.io.accessKey = admin
min.io.secretKey = admin123456

MinIoProperties.java 配置实体

@Data
@ConfigurationProperties(prefix = "min.io")
public class MinIoProperties {

	private String endpoint;
	private String accessKey;
	private String secretKey;

}

工具类

@Component
@Configuration
@EnableConfigurationProperties({ MinIoProperties.class })
public class MinIoUtils {

	private MinIoProperties minIo;

	public MinIoUtils(MinIoProperties minIo) {
		this.minIo = minIo;
	}

	private static MinioClient instance;

	@PostConstruct
	public void init() {
		try {
			instance = new MinioClient(minIo.getEndpoint(), minIo.getAccessKey(), minIo.getSecretKey());
		} catch (InvalidPortException e) {
			e.printStackTrace();
		} catch (InvalidEndpointException e) {
			e.printStackTrace();
		}
	}

	/**
	 * 判断 bucket是否存在
	 * 
	 * @param bucketName
	 * @return
	 */
	public static boolean bucketExists(String bucketName) {
		try {
			return instance.bucketExists(bucketName);
		} catch (Exception e) {
			e.printStackTrace();
		}
		return false;
	}

	/**
	 * 创建 bucket
	 * 
	 * @param bucketName
	 */
	public static void makeBucket(String bucketName) {
		try {
			boolean isExist = instance.bucketExists(bucketName);
			if (!isExist) {
				instance.makeBucket(bucketName);
			}
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	/**
	 * 文件上传
	 * 
	 * @param bucketName
	 * @param objectName
	 * @param filename
	 */
	public static void putObject(String bucketName, String objectName, String filename) {
		try {
			instance.putObject(bucketName, objectName, filename, null);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	/**
	 * 文件上传
	 * 
	 * @param bucketName
	 * @param objectName
	 * @param stream
	 */
	public static void putObject(String bucketName, String objectName, InputStream stream) {
		try {
			instance.putObject(bucketName, objectName, stream, null);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	/**
	 * 删除文件
	 * 
	 * @param bucketName
	 * @param objectName
	 */
	public static void removeObject(String bucketName, String objectName) {
		try {
			instance.removeObject(bucketName, objectName);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
	// 省略各种CRUD
}

目前SDK不支持文件夹的创建，如果想创建文件夹，只能通过文件的方式上传并创建。

minIoUtils.putObject("javakf","test/1.jpg","C:\\1.jpg");

一个实例只能有一个账号，如果想使用多个账号，需要创建多个实例。此外 minio还支持单主机，多块磁盘以及分布式部署，不过对于大部分单体应用来说，单体已经够用了。