Minio图床介绍和使用

① 什么是Minio?

MinIO 是一个开源的对象存储服务器。这意味着它允许你在互联网上存储大量数据，比如文件、图片、视频等，而不需要依赖传统的文件系统。MinIO 的特点在于它非常灵活、易于使用，同时也非常强大，可以在你的应用程序中方便地集成。

② 为什么使用Minio?

• 可伸缩性和性能： MinIO 允许你在需要时轻松地扩展存储容量，无需中断服务。它具有出色的性能，可以处理大量的并发读取和写入请求。
• 开源和自由： MinIO 是开源软件，遵循 Apache License 2.0 许可证，这意味着你可以自由地使用、修改和分发它。
• 容器化部署： MinIO 提供了容器化部署的支持，可以在各种平台上快速部署和运行，包括本地开发机、云服务器和容器编排环境（如 Docker）。
• 兼容性： MinIO 提供了 S3 兼容的 API，这意味着它可以与任何兼容 Amazon S3 的应用程序无缝集成，为你的应用程序提供强大的对象存储能力。
• 易用性： MinIO 的配置和管理非常简单，它提供了直观的Web控制台和命令行工具，帮助你方便地管理存储桶和对象。

总的来说，MinIO 是一个灵活、高性能、易用且开源的对象存储解决方案，适用于各种规模的应用程序，特别是那些需要大规模数据存储和访问的项目。

③ 如何使用Minio?

Tips : 前置条件，安装了Docker

下载安装及数据卷配置

#  查看Minio镜像
docker search minio

# 选择发行版进行拉取安装
docker pull minio/minio:RELEASE.2023-09-30T07-02-29Z

# 查看是否成功拉取镜像
docker image

# 创建数据卷挂载目录
mkdir /minio

# 数据映射挂载
docker run -d \
 -p 9000:9000 \
 -p 9090:9090 \
 --name minio \
 -v /minio/data:/data \
 -e "MINIO_ROOT_USER=robin123456" \
 -e "MINIO_ROOT_PASSWORD=robin123456" \
 minio/minio:RELEASE.2023-09-30T07-02-29Z server /data --console-address ":9090"

# 查看容器是否成功创建并且运行
docker ps

-p 9000:9000 将宿主机的9000端口映射到容器的9000端口 Minio默认的HTTP端口是9000
-p 9090:9090 将宿主机的9090端口映射到容器的9090端口，Minio的Web端口位9090
-v 设置数据卷映射
-e 设置Minio的初始化配置信息，用户名密码。。
server /data --console-address “:9090” ,启动 MinIO 服务器，并将数据存储在容器内的/data目录。–console-address ":9090"表示 MinIO 的Web 控制台将在容器的 9090 端口上运行

登录到MinioWeb端

localhost:9090/login

访问测试 域名:端口号+桶名+图片名称

使用Java代码进行文件上传

1. POM 依赖引入

<!-- 对象存储 Minio -->
<dependency>
  <groupId>io.minio</groupId>
  <artifactId>minio</artifactId>
  <version>8.2.1</version>
</dependency>

2. yml配置文件

# minio 文件配置
minio:
  endpoint: http://127.0.0.1:9000 # Minio 服务器地址
  accessKey: robin123456 # 账号
  secretKey: robin123456 # 密码
  bucketName: test # 桶名

# spring 大文件上传配置
spring:
  servlet:
    multipart:
      max-file-size: 10MB # 限制单个上传文件的最大大小为 10MB。如果上传的文件大小超过这个值，将会被拒绝上传。
      max-request-size: 10MB # 限制整个上传请求的最大大小为 10MB。这包括所有上传文件的大小之和。如果请求总大小超过这个值，将会被拒绝。

3. Config配置类（更方便的读取yml配置文件的配置信息）

@ConfigurationProperties(prefix = "minio")
@Component
@Data
public class MinioProperties {
    private String endpoint;
    private String accessKey;
    private String secretKey;
    private String bucketName;
}

4. Minio 客户端配置 类

@Configuration
public class MinioConfig {
    @Autowired
    private MinioProperties minioProperties;

    @Bean
    public MinioClient minioClient() {
        // 构建 Minio 客户端
        return MinioClient.builder()
                .endpoint(minioProperties.getEndpoint())
                .credentials(minioProperties.getAccessKey(), minioProperties.getSecretKey())
                .build();
    }
}

5. Minio上传图片工具类

@Component
@Slf4j
public class MinioUtil {

    @Autowired
    private MinioProperties minioProperties;

    @Autowired
    private MinioClient minioClient;

    /**
     * 上传文件
     * @param file
     * @return
     * @throws Exception
     */
    public String uploadFile(MultipartFile file) throws Exception {
        // 判断文件是否为空
        if (file == null || file.getSize() == 0) {
            log.error("==> 上传文件异常：文件大小为空 ...");
            throw new RuntimeException("文件大小不能为空");
        }

        // 文件的原始名称
        String originalFileName = file.getOriginalFilename();
        // 文件的 Content-Type
        String contentType = file.getContentType();

        // 生成存储对象的名称（将 UUID 字符串中的 - 替换成空字符串）
        String key = UUID.randomUUID().toString().replace("-", "");
        // 获取文件的后缀，如 .jpg
        String suffix = originalFileName.substring(originalFileName.lastIndexOf("."));

        // 拼接上文件后缀，即为要存储的文件名
        String objectName = String.format("%s%s", key, suffix);

        log.info("==> 开始上传文件至 Minio, ObjectName: {}", objectName);
        
        // 上传文件至 Minio
        minioClient.putObject(PutObjectArgs.builder()
                .bucket(minioProperties.getBucketName())
                .object(objectName)
                .stream(file.getInputStream(), file.getSize(), -1)
                .contentType(contentType)
                .build());

        // 返回文件的访问链接
        String url = String.format("%s/%s/%s", minioProperties.getEndpoint(), minioProperties.getBucketName(), objectName);
        log.info("==> 上传文件至 Minio 成功，访问路径: {}", url);
        return url;
    }
}

6. 后端接口开发上传。

只需要将接口入参数据类型设置为MultipartFile对象，然后调用Service传参，使用上面的MinioUtil工具类进行文件上传即可，最后接口返回图片上传后的访问路径。

友情提示

常见错误提示 ERROR Unable to validate credentials inherited from the shell environment: Invalid credentials\n","stream":"stdout","time":"2024-03-18T07:00:21.5512296Z<br /> 密码字符不能少于8位