Minio搭建并在SpringBoot中使用完成用户头像的上传

devtools/2025/3/4 8:28:32/

Minio使用搭建并上传用户头像到服务器操作,学习笔记

Minio介绍

minio官网

  • MinIO是一个开源的分布式对象存储服务器,支持S3协议并且可以在多节点上实现数据的高可用和容错。它采用Go语言开发,拥有轻量级、高性能、易部署等特点,并且可以自由选择底层存储介质。

  • MinIO的主要特点包括:

1、高性能:MinIO基于GO语言编写,具有高速、轻量级、高并发等性能特点,还支持多线程和缓存等机制进行优化,可以快速地处理大规模数据。

2、可扩展性:MinIO采用分布式存储模式,支持水平扩展,通过增加节点数量来扩展存储容量和性能,支持自动数据迁移和负载均衡。

3、安全性:MinIO提供了多种安全策略,如访问控制列表(ACL)、服务端加密(SSE)、传输层安全性(TLS)等,可以保障数据安全和隐私。

4、兼容性:MinIO兼容AWS S3 API,还支持其他云服务提供商的API,比如GCP、Azure等,可以通过简单的配置实现互操作性。

5、简单易用:MinIO的部署和管理非常简单,只需要运行一个二进制包即可启动服务,同时提供了Web界面和命令行工具等方便的管理工具。

  • S3协议是Amazon Web Services (AWS) 提供的对象存储服务(Simple Storage Service)的API协议。它是一种 RESTful风格的Web服务接口,使用HTTP/HTTPS协议进行通信,支持多种编程语言和操作系统,并实现了数据的可靠存储、高扩展性以及良好的可用性。

Minio安装 (linux+docker)

//拉取镜像
docker pull quay.io/minio/minio// 创建数据存储目录
mkdir -p ~/minio/data// 创建minio
docker run -p 9001:9000 -p 9090:9090 --name minio --restart=always -v ~/minio/data:/data -e "MINIO_ROOT_USER=admin" -e "MINIO_ROOT_PASSWORD=yourpassword." -d quay.io/minio/minio server /data --console-address ":9090"
  • 参数解析
  1. docker run 运行容器

    启动一个新的 Docker 容器,如果镜像不存在,会自动拉取。

  2. -p 9001:9000 -p 9090:9090(端口映射)
    • -p 9001:9000
    • 将容器内部的 9000 端口 映射到 宿主机的 9001 端口,9000 是 MinIO 的 API 访问端口。
    • 这意味着你可以通过 http://localhost:9001 访问 MinIO 的 API。
    • -p 9090:9090
    • 将 容器内部的 9090 端口 映射到 宿主机的 9090 端口,9090 是 MinIO 的 Web 管理控制台端口。
    • 你可以通过 http://localhost:9090 访问 MinIO 的管理界面。

  3. –name minio(容器名称)
    • --name minio 给该容器命名为 minio,这样之后可以通过 docker stop minio / docker start minio 来管理它,而不需要使用容器 ID。

  4. –restart=always(自动重启)
    • --restart=always 让容器 始终自动重启,包括:
    • Docker 进程重启后,容器也会自动重启。
    • 容器异常退出时,Docker 也会自动重启它。
    • 但如果你 手动停止容器 (docker stop minio),它不会重启。

  5. -v ~/minio/data:/data(数据持久化)
    • -v ~/minio/data:/data 挂载数据卷,把 宿主机 ~/minio/data 目录映射到 容器内 /data 目录:
    • 这样 MinIO 存储的数据不会随着容器删除而丢失。
    • ~/minio/data 目录存储 MinIO 内部的对象数据。

  6. -e “MINIO_ROOT_USER=admin”(环境变量)
    • -e 传递环境变量,设置 MinIO 的 管理员用户名 为 admin。

  7. -e “MINIO_ROOT_PASSWORD=yourpassword.”(环境变量)
    • 设定 MinIO 管理员密码 为 自己设置.。

  8. -d quay.io/minio/minio(后台运行 & 指定镜像)
    • -d 让容器 后台运行(detach mode)。
    • quay.io/minio/minio 指定 MinIO 官方镜像(托管在 quay.io,类似于 docker.io)。

  9. server /data --console-address “:9090”(启动 MinIO 服务器)
    • server /data 指定 MinIO 使用 /data 目录 作为存储路径(前面 -v ~/minio/data:/data 绑定的目录)。
    • --console-address “:9090” 设置 MinIO Web 管理控制台 监听 9090 端口。

登录并创建桶

1、登录

在这里插入图片描述

2、创建桶

在这里插入图片描述
在这里插入图片描述

3、设置权限

在这里插入图片描述
在这里插入图片描述

在springBoot中使用 后端

1、导入坐标
<dependency><groupId>io.minio</groupId><artifactId>minio</artifactId><version>8.5.2</version>
</dependency>
2、controller
java">@RestController
@RequestMapping("/admin/system")
public class FileUploadController {@Autowiredprivate FileUploadService fileUploadService;@PostMapping("/upload")//MultipartFile file 这个名字要和前端的name对应上. 我用的是element plus 默认的名字就是filepublic Result<String> fileUpload(MultipartFile file){//最后返回的是文件minio文件预览的浏览器的路径, 给前端作回显用// 见下面的我标红的图像String fileUrl=fileUploadService.fileUpload(file);return Result.build(fileUrl, ResultCodeEnum.SUCCESS);}
}
  • 返回的fileUrl 就是我标红的路径, 就是文件上传到的真实地方,方便前端作回显示
    在这里插入图片描述
  • 如果你用的不是Element plus 作上传, 记得名字要匹配了. 这里都是属于SpringMVC的知识 , 变量的名字都一样不要 @RequestParm 注解也行
<form id="uploadForm"><input type="file" name="file"> <!-- 这里的 name="file" 要和 @RequestParam("file") 一致 --><button type="button" onclick="javascript language-javascript">uploadFile()">上传</button>
</form>
3、service
java">@Service
public class FileUploadServiceImpl implements FileUploadService {//使用配置文件的方式读,minio的配置, 不硬编码@Autowiredprivate MinioProperties minioProperties;@Overridepublic String fileUpload(MultipartFile file) {String fileUrl= null;try {MinioClient  minioClient =MinioClient.builder().endpoint(minioProperties.getEndpointUrl())  // MinIO 服务器地址.credentials(minioProperties.getAccessKey(), //  账号minioProperties.getSecureKey()) //密码.build();// 不存在桶就创建boolean found =minioClient.bucketExists(BucketExistsArgs.builder().bucket(minioProperties.getBucketName()).build());
//                不能用下滑线连接,拼接访问路径会出错if (!found) {// 创建minioClient.makeBucket(MakeBucketArgs.builder().bucket(minioProperties.getBucketName()).build());}//创建日期文件夹//DataUtil 来自Hutool工具类库String path = DateUtil.format(new Date(), "yyyyMMdd");//生成随机文件名String uuid = UUID.randomUUID().toString().replaceAll("-", "");String fileName=path+'/'+uuid+file.getOriginalFilename();minioClient.putObject(PutObjectArgs.builder().bucket(minioProperties.getBucketName())  //桶名称.object(fileName)  //文件名// 采用的是已经知道文件大小的读     -1 表示 不限制分块大小(自动选择最佳方式).stream(file.getInputStream(), file.getSize(), -1)//设置 文件的 MIME 类型)//让 MinIO 知道如何处理和预览这个文件。.contentType(file.getContentType()).build());//手动拼接url,给前端,方便前端作回显示fileUrl = minioProperties.getEndpointUrl()+"/"+minioProperties.getBucketName()+'/'+fileName;} catch (Exception e) {e.printStackTrace();}//我们是在新增用户的时候给用户添加头像的,你给前端访问路径了, 前端会映射到头像(avator这个字段上), 一点击新增用户,直接就把这个url带到mysql中了, 所有这里就不用写mapper了return fileUrl;}
}
  • 其中 用到DataUtil工具类,需要导入hutool
<!--        生成验证码 ,日期时间等--><dependency><groupId>cn.hutool</groupId><artifactId>hutool-all</artifactId><version>5.5.2</version></dependency>
4、 配置文件内容

在配置文件中添加Minio的相关配置

# 自定义配置
spzx:minio:# 别用https,如果你没有申请过ssl证书,就http就可以# 用户名和密码都是 在docker构建 minio的时候设置的endpointUrl: http://服务器ip:9000      accessKey: 你的用户名secreKey: 你设置的密码bucketName: 给桶起个名字
5、 MinioProperties读配置文件

将构建MinioClient所对应的参数定义到配置文件中,然后通过该实体类封装该配置文件中的内容.

java">@Data // 需要提供get方法
@ConfigurationProperties(prefix = "spzx.minio")
public class MinioProperties {
//和yml声明的属性保持一致private String endpointUrl;  // minio的urlprivate String accessKey;  //账号private String secureKey;// 密码private String bucketName; //桶的名字
}
  • 记得在启动类中 加上@EnableConfigurationProperties
java">@SpringBootApplication
@ComponentScan(basePackages = {"com.chen"})
// 让spring能扫到我们自己写的配置类
@EnableConfigurationProperties(value = {MinioProperties.class})
public class SpzxManagerApplication {public static void main(String[] args) {SpringApplication.run(SpzxManagerApplication.class,args);}
}

前端 vue

<template><el-form-item label="头像"><!--         element plus     默认上传的name就是file, 和你controller启的名字对应上 --><el-uploadclass="avatar-uploader"action="http://localhost:8501/admin/system/upload":show-file-list="false":headers="headers":on-success="loadSuccess"><img v-if="sysUser.avatar" :src="sysUser.avatar" class="avatar"/><el-icon v-else class="avatar-uploader-icon"><Plus/></el-icon></el-upload></el-form-item>
</template>	      
//定义用户数据模型
const defaultSysUserForm = {id: '',userName: "",password: "",name: "",phone: "",avatar: "",   // 操作用户的头像description: ""
}
const sysUser = ref(defaultSysUserForm)
//上传成功的回调函数
const loadSuccess = (response) => {//这里response 就是我们后端封装的 result对象//给响应式对象复制//loadSuccess(response) 是上传成功的回调函数// response.data 包含上传成功后的文件 URL(即头像地址)。// 这样 sysUser.value.avatar 就能保存 新头像的 URL,从而在前端显示最新上传的头像。sysUser.value.avatar = response.data
}

http://www.ppmy.cn/devtools/164410.html

相关文章

工程化与框架系列(6)--前端模块化工程详解

前端模块化工程详解 &#x1f9e9; 前端模块化是现代Web开发的核心理念之一&#xff0c;它帮助我们组织和管理日益复杂的前端代码。本文将详细探讨前端模块化工程的各个方面&#xff0c;从基础概念到实际应用。 模块化概述 &#x1f31f; &#x1f4a1; 小知识&#xff1a;模…

每日一题——接雨水

接雨水问题详解 问题描述 给定一个非负整数数组 height&#xff0c;表示每个宽度为 1 的柱子的高度图。计算按此排列的柱子&#xff0c;下雨之后能接多少雨水。 示例 示例 1&#xff1a; 输入&#xff1a;height [0,1,0,2,1,0,1,3,2,1,2,1] 输出&#xff1a;6 解释&#…

Ubuntu 下 nginx-1.24.0 源码分析 - ngx_str_rbtree_insert_value

ngx_str_rbtree_insert_value 声明 在 src\core\ngx_string.h void ngx_str_rbtree_insert_value(ngx_rbtree_node_t *temp,ngx_rbtree_node_t *node, ngx_rbtree_node_t *sentinel); ngx_str_node_t *ngx_str_rbtree_lookup(ngx_rbtree_t *rbtree, ngx_str_t *name,uint32_t …

PostgreSQL的基本使用

参考视频&#xff1a;零基础入门PostgreSQL教程 文章目录 一、PostgreSQL是什么&#xff1f;二、基本使用1.下载2.操作 一、PostgreSQL是什么&#xff1f; PostgreSQL 是一个免费的对象-关系数据库服务器&#xff0c;在灵活的BSD许可证下发行。 二、基本使用 1.下载 2.操作 …

在 Ubuntu 下通过 Docker 部署 Mastodon 服务器

引言 大家好&#xff0c;我是Hitch。今天咱们来聊聊如何在 Ubuntu 系统上通过 Docker 部署 Mastodon 服务器。Mastodon 是一个开源的社交网络平台&#xff0c;像 Twitter 但更自由。Docker 是一个强大的容器化工具&#xff0c;可以让我们轻松地打包和部署应用。接下来&#xf…

在已有的原生 App 里嵌入 Flutter 页面的方法

在原生 App 中嵌入 Flutter 页面&#xff0c;通常使用 Flutter 提供的**平台通道&#xff08;Platform Channels&#xff09;**来实现原生代码与 Flutter 之间的交互。具体实现方式依赖于原生 App 的平台&#xff08;如 Android 或 iOS&#xff09;&#xff0c;下面是两种常见的…

基于POI的Excel下拉框自动搜索,包括数据验证的单列删除

目录 目标 例子 1.搜索下拉框页 2.数据源页 3.效果 代码以及注意事项 1.代码 2.注意事项 1.基于Excel的话&#xff0c;相当于加入了一个【数据验证】 2.代码中的一些方法说明 目标 期望在Excel利用代码创建具备自动搜索功能的下拉框 例子 1.搜索下拉框页 2.数据源…

macOS 设置屏幕常亮 不休眠

Apple M1 Pro macOS Sonoma设置“永不”防止进入休眠 macOS Sonoma 设置“永不” 防止进入休眠