本文，将带你使用 MinIO + Docker 来从零搭建一个文件存储服务，并在 SpringBoot 项目中上传图片到 MinIO 中。
一.为什么要自己搭建？
对于个人学习来说，当然是攻击风险 。第三方对象存储服务通常会收取费用，尤其随着数据量的增加，费用也会相应增加，而通过自己搭建文件存储服务器，可以有效控制成本。其实费用还好，个人小项目访问量不大花不了多少钱，最重要的是被攻击刷流量就GG了。例如：
个人小博客被攻击：
某知名up主被刷爆：
虽然个人小项目一般不会被攻击，但就问你看到-1.5w慌不慌？接下来让我们来学习一下如何使用MinIO搭建一个自己的文件存储服务器吧~
二.为什么使用MinIO？
MinIO 是一个高性能 的轻量级对象存储服务器。它具有分布式，高可用性和水平扩展的特点，它非常适合用于大规模数据存储和分析。其优点包括低延迟、高吞吐量、易于部署和管理。
怕很拉跨不敢用？
截止目前，MinIO 在 Github 上有 43.7k Star。
国内阿里巴巴、腾讯、百度、华为、中国移动、中国联通等企业都有在使用 MinIO，甚至不少商业公司二次开发 MinIO 来提供商业化的云存储产品。
看人家主页介绍多自信：MinIO 是世界上最快的对象存储，没有之一
三.搭建MinIO
(1) 引言
MinIO 的官方文档上介绍了多种下载方式:
本文我们只介绍如何使用 Docker 基于CentOS 服务器来进行服务的搭建 ，如果未安装Docker可以通过本文（点击跳转）来了解和安装Docker，或者在官方文档挑选自己擅长的方式进行搭建~
(2) 安装
- 首先我们要创建两个文件目录：一个用来存放 MinIO 的配置文件，一个用来存储我们上传文件数据。
sh
mkdir -p /home/minio/config
mkdir -p /home/minio/data/home/minio/config用于存放 MinIO 的配置文件/home/minio/data用于存储上传的文件数据
- 接下来我们可以通过如下命令拉取最新版镜像并创建 MinIO 容器运行 。如果需要下载指定版本可以点击前往DockerHub仓库选择下载。
sh
docker run -p 9000:9000 -p 9001:9001 \
-d --restart=always \
-e "MINIO_ACCESS_KEY=admin" \
-e "MINIO_SECRET_KEY=password" \
-v /home/minio/data:/data \
-v /home/minio/config:/root/.minio \
minio/minio server \
/data \
--console-address ":9001" 运行效果：
命令行解释：
MINIO_ACCESS_KEY和MINIO_SECRET_KEY为UI界面登录账号密码-d将容器以后台（守护进程）模式运行，并与终端分离。--restart=always选项指定容器在停止后总是自动重启。/home/minio/data挂载的存储上传文件的目录/home/minio/config挂载的配置文件minio/minio server使用MinIO 镜像并启动/data要使用的数据目录--console-address指定UI 界面的端口9000:9000映射服务器端口9001:9001映射UI界面端口
补充说明：
Docker的run指令会首先在本地查找指定的镜像，如果本地没有找到对应的镜像，则会自动去远程镜像仓库拉取该镜像并在本地运行。
当不带有标签（tag）的镜像名称时，Docker默认会使用latest标签来拉取最新版本的镜像。例如，如果运行
docker run ubuntu，Docker会首先在本地查找名为ubuntu:latest的镜像是否存在，如果不存在，则会从默认的远程镜像仓库（如Docker Hub）拉取最新版本的ubuntu镜像，并在本地运行。如果指定了具体的标签或版本号，例如
docker run ubuntu:18.04，Docker会尝试在本地查找名为ubuntu:18.04的镜像，如果本地没有找到，则会从远程镜像仓库拉取对应的镜像。需要注意的是，如果在远程镜像仓库中找不到指定的镜像，或者无法连接到远程镜像仓库，Docker的run指令将无法成功运行，并会报错提示找不到镜像。
- 最后在浏览器中访问 http://服务器IP:9001，即可访问到MinIO的控制台。
可以输入账号 admin，密码 password 进行登录，进入首页。
可以发现它的界面和我们使用的一些第三方对象存储服务非常相似，接下来我们也要进行一系列的配置~
(3) 配置
- 创建一个 Bucket 存储桶，用于稍后文件的上传操作。
- 前往创建用于远程操作的AccessKey 和 SecretKey.
- 创建并保存好生成Access Key 和 Secret Key.
- 默认配置下，访问存储桶是需要请求授权的。但是在实际场景下，我们往往希望允许直接访问，此时就需要添加一条 readonly 访问规则。
进入配置存储桶界面
进行配置，添加只读规则
至此，我们已经基本完成了MinIO的简单配置，当然如果想要更安全，同样是可以像使用第三方对象存储服务一样创建用户组，分配权限等诸如此类的操作。
(4) 测试
- 我们上传一张图片并访问来测试一下是否搭建成功。
- 可以看到成功上传了图片
- 接下来我们在浏览器访问
http://服务器IP:9000/{bucket存储桶名字}/{name图片后缀名}来进行访问。例如我刚上传的文件{bucket}是 guanzhi，{name}是 csdn.png，所以最终的访问路径是http://服务器IP:9000/guanzhi/csdn.png。
测试成功，能够正常使用，接下来我们来学习一下如何在Java项目中使用吧~
四.在项目中使用
(1) 引言
官方文档上有介绍多种语言的SDK使用指南，本篇我们只学习如何在Java的Maven项目中进行使用 ，其他语言的同学可以跟着官方文档尝试一下~
(2) 初步尝试
- 首先在我们创建的Maven项目中引入如下依赖
xml
<!-- MinIO 客户端 -->
<dependency>
<groupId>io.minio</groupId>
<artifactId>minio</artifactId>
<version>8.5.9</version>
</dependency>- 接下来我们尝试一下官方给出的demo（已经添加详细注释，可以查看下述示例代码）
java
@SpringBootTest
class DemoApplicationTests {
@Test
void demo() {
try {
// 1.创建MinIO客户端，与其建立连接，用于我们上传文件操作
// Create a minioClient with the MinIO server playground, its access key and secret key.
MinioClient minioClient = MinioClient.builder()
.endpoint("http://服务器ip:9000") // 地址为服务器ip+端口号
.credentials("1AYD2DY8qPz5vp0WmQtJ",
"BQeSptD5wO9vPIwtthNg5BbFswPx7WhsPh1Slp0M") // 我们配置并保存的 AccessKey 和 SecretKey
.build();
// 2.创建存储桶，这一步我们可以直接在界面手动创建一次即可，因此可以省略
// Make 'asiatrip' bucket if not exist.
boolean found = minioClient.bucketExists(BucketExistsArgs.builder().bucket("guanzhi").build());
if (!found) {
// Make a new bucket called 'asiatrip'.
minioClient.makeBucket(MakeBucketArgs.builder().bucket("guanzhi").build());
} else {
System.out.println("Bucket 'guanzhi' already exists.");
}
// 3. 上传文件
// Upload '/home/user/Photos/asiaphotos.zip' as object name 'asiaphotos-2015.zip' to bucket 'asiatrip'.
minioClient.uploadObject(
UploadObjectArgs.builder()
.bucket("guanzhi") // 上传到哪个存储桶？
.object("pom.xml") // 上传的文件命名为什么？
.filename("C:\\code\\demo\\pom.xml") // 上传文件的路径？
.build());
System.out.println(
"'C:\\code\\demo\\pom.xml' is successfully uploaded as "
+ "object 'pom.xml\"' to bucket 'guanzhi'.");
} catch (MinioException e) {
System.out.println("Error occurred: " + e);
System.out.println("HTTP trace: " + e.httpTrace());
} catch (IOException | NoSuchAlgorithmException | InvalidKeyException e) {
throw new RuntimeException(e);
}
}
}- 可以发现运行成功。
查看控制台，可以看成功上传了文件。
(3) 在SpringBoot中使用
我们来简单写一个文件上传功能。
- 项目中除了上述依赖，我们还需要引入如下依赖
xml
<!-- 实现对 Spring MVC 的自动化配置 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependency>
<!-- lombok插件-->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>- 新建 MinIO 配置类，创建 MinioClient Bean
java
@Configuration
@ConfigurationProperties(prefix = "file.minio")
@Data
public class MinioConfiguration {
private String accessKey;
private String secretKey;
private String endpoint;
private String bucket;
@Bean
public MinioClient minioClient() {
return MinioClient.builder()
.endpoint(endpoint)
.credentials(accessKey, secretKey)
.build();
}
}- 在application.yml中编写配置
yml
# 对象存储服务配置
file:
# MinIO自搭建对象存储服务
minio:
endpoint: http://服务器ip:9000 #存储服务域名
accessKey: 1AYD2DY8qPz5vp0WmQtJ
secretKey: BQeSptD5wO9vPIwtthNg5BbFswPx7WhsPh1Slp0M
bucket: guanzhi #存储桶名称- 编写controller
java
@RestController
@RequestMapping("/file")
public class FileController {
@Resource
private MinioClient minioClient;
@Resource
private MinioConfiguration minioConfiguration;
/**
* 上传文件
*/
@PostMapping("/upload")
public String upload(@RequestParam("file") MultipartFile file) throws Exception {
// 上传
String path = UUID.randomUUID() + file.getOriginalFilename(); // 文件名，使用 UUID 随机
minioClient.putObject(PutObjectArgs.builder()
.bucket(minioConfiguration.getBucket()) // 存储桶
.object(path) // 文件名
.stream(file.getInputStream(), file.getSize(), -1) // 文件内容
.contentType(file.getContentType()) // 文件类型
.build());
// 拼接路径
return String.format("%s/%s/%s", minioConfiguration.getEndpoint(), minioConfiguration.getBucket(), path);
}
}- 启动SpringBoot项目，测试接口,可以看到后端正确响应了文件Url.
- 可以看到控制台存储桶中也有文件
- 在浏览器中我们也成功的通过返回的url访问到了图片
至此，我们已经完成了服务器的搭建，赶紧用起来吧~