还在用第三方对象存储？自己搭个一模一样的玩玩吧！

本文，将带你使用 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) 安装

1. 首先我们要创建两个文件目录：一个用来存放 MinIO 的配置文件，一个用来存储我们上传文件数据。

mkdir -p /home/minio/config
mkdir -p /home/minio/data

• /home/minio/config 用于存放 MinIO 的配置文件
• /home/minio/data 用于存储上传的文件数据

2. 接下来我们可以通过如下命令拉取最新版镜像并创建 MinIO 容器运行 。如果需要下载指定版本可以点击前往DockerHub仓库选择下载。

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指令将无法成功运行，并会报错提示找不到镜像。

3. 最后在浏览器中访问 http://服务器IP:9001，即可访问到MinIO的控制台。

可以输入账号 admin，密码 password 进行登录，进入首页。

可以发现它的界面和我们使用的一些第三方对象存储服务非常相似，接下来我们也要进行一系列的配置~

(3) 配置

1. 创建一个 Bucket 存储桶，用于稍后文件的上传操作。

2. 前往创建用于远程操作的AccessKey 和 SecretKey.

3. 创建并保存好生成Access Key 和 Secret Key.

4. 默认配置下，访问存储桶是需要请求授权的。但是在实际场景下，我们往往希望允许直接访问，此时就需要添加一条 readonly 访问规则。

进入配置存储桶界面

进行配置，添加只读规则

至此，我们已经基本完成了MinIO的简单配置，当然如果想要更安全，同样是可以像使用第三方对象存储服务一样创建用户组，分配权限等诸如此类的操作。

(4) 测试

1. 我们上传一张图片并访问来测试一下是否搭建成功。

2. 可以看到成功上传了图片

3. 接下来我们在浏览器访问 http://服务器IP:9000/{bucket存储桶名字}/{name图片后缀名} 来进行访问。例如我刚上传的文件 {bucket} 是 guanzhi，{name} 是 csdn.png，所以最终的访问路径是 http://服务器IP:9000/guanzhi/csdn.png。

测试成功，能够正常使用，接下来我们来学习一下如何在Java项目中使用吧~

四.在项目中使用

(1) 引言

官方文档上有介绍多种语言的SDK使用指南，本篇我们只学习如何在Java的Maven项目中进行使用 ，其他语言的同学可以跟着官方文档尝试一下~

(2) 初步尝试

1. 首先在我们创建的Maven项目中引入如下依赖

 <!-- MinIO 客户端 -->
<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>8.5.9</version>
</dependency>

2. 接下来我们尝试一下官方给出的demo（已经添加详细注释，可以查看下述示例代码）

@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. 可以发现运行成功。

查看控制台，可以看成功上传了文件。

(3) 在SpringBoot中使用

我们来简单写一个文件上传功能。

1. 项目中除了上述依赖，我们还需要引入如下依赖

        <!-- 实现对 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>

2. 新建 MinIO 配置类，创建 MinioClient Bean

@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();
    }
}

3. 在application.yml中编写配置

# 对象存储服务配置
file:
  # MinIO自搭建对象存储服务
  minio:
    endpoint: http://服务器ip:9000 #存储服务域名
    accessKey: 1AYD2DY8qPz5vp0WmQtJ 
    secretKey: BQeSptD5wO9vPIwtthNg5BbFswPx7WhsPh1Slp0M
    bucket: guanzhi   #存储桶名称

4. 编写controller

@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);
    }
}

5. 启动SpringBoot项目，测试接口,可以看到后端正确响应了文件Url.

6. 可以看到控制台存储桶中也有文件

7. 在浏览器中我们也成功的通过返回的url访问到了图片

至此，我们已经完成了服务器的搭建，赶紧用起来吧~