① 什么是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代码进行文件上传
- POM 依赖引入
<!-- 对象存储 Minio -->
<dependency>
<groupId>io.minio</groupId>
<artifactId>minio</artifactId>
<version>8.2.1</version>
</dependency>
- 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。这包括所有上传文件的大小之和。如果请求总大小超过这个值，将会被拒绝。
- Config配置类（更方便的读取yml配置文件的配置信息）
@ConfigurationProperties(prefix = "minio")
@Component
@Data
public class MinioProperties {
private String endpoint;
private String accessKey;
private String secretKey;
private String bucketName;
}
- 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();
}
}
- 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;
}
}
- 后端接口开发上传。
只需要将接口入参数据类型设置为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位
