springboot整合minio,实现文件上传与下载,且支持链接永久访问

本文档详细介绍了如何使用Docker部署MinIO,并在SpringBoot应用中集成MinIO进行文件上传和下载。首先,通过Docker命令拉取并启动MinIO服务。然后,在项目中引入MinIO的依赖,配置MinioClient,并提供文件上传和下载的接口。在文件上传中,检查存储桶是否存在并上传文件;在文件下载中,提供了直接下载和生成预签名URL的两种方式。最后,展示了生成预签名URL的代码片段,允许用户通过该URL直接下载文件。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

1、minio部署

1.1 拉取镜像
docker pull minio/minio
1.2 创建数据目录
mkdir -p /home/guanz/minio
mkdir -p /home/guanz/minio/midata
1.3 启动minio
docker run -d -p 9000:9000 -p 9001:9001 --restart=always -e MINIO_ACCESS_KEY=guanz -e MINIO_SECRET_KEY=guanz@123 -v $PWD/midata:/data  minio/minio server /data --console-address "192.168.1.139:9001"

2、项目搭建

2.1 引入jar
        <dependency>
            <groupId>io.minio</groupId>
            <artifactId>minio</artifactId>
            <version>8.0.3</version>
        </dependency>
2.2 application-dev.yml
spring
    minio:
    # Minio服务器地址
    endpoint: http://192.168.1.139:9000
    port: 9001
    create-bucket: true
    bucketName: push-test
    # Minio服务器账号
    accessKey: guanz
    # Minio服务器密码
    secretKey: guanz@123
    secure: false
    configDir: /home/push
    # 文件大小 单位M
    maxFileSize: 10
    expires: 604800
2.4 MinioConfig.java
package com.pavis.app.saasbacken.config;

import io.minio.MinioClient;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.stereotype.Component;

/**
 * @program: push-saas
 * @description:
 * @author: Guanzi
 * @created: 2021/11/02 13:47
 */
@Data
@Component
@ConfigurationProperties(prefix = "minio")
@Slf4j
@Configuration
public class MinioConfig {
    @ApiModelProperty("endPoint是一个URL,域名,IPv4或者IPv6地址")
    @Value("${spring.minio.endpoint}")
    private String endpoint;

    @ApiModelProperty("TCP/IP端口号")
    @Value("${spring.minio.port}")
    private int port;

    @ApiModelProperty("accessKey类似于用户ID,用于唯一标识你的账户")
    @Value("${spring.minio.accessKey}")
    private String accessKey;

    @ApiModelProperty("secretKey是你账户的密码")
    @Value("${spring.minio.secretKey}")
    private String secretKey;

    @ApiModelProperty("如果是true,则用的是https而不是http,默认值是true")
    @Value("${spring.minio.secure}")
    private Boolean secure;

    @ApiModelProperty("默认存储桶")
    @Value("${spring.minio.bucketName}")
    private String bucketName;

    @ApiModelProperty("配置目录")
    @Value("${spring.minio.configDir}")
    private String configDir;

    @ApiModelProperty("文件大小")
    @Value("${spring.minio.maxFileSize}")
    private Integer maxFileSize;

    @ApiModelProperty("签名有效时间")
    @Value("${spring.minio.expires}")
    private Integer expires;

    /**
     * 注入minio 客户端
     * @return
     */
    @Bean
    public MinioClient minioClient(){
        log.info("endpoint:{},port:{},accessKey:{},secretKey:{},secure:{}",endpoint, port, accessKey, secretKey,secure);
        return MinioClient.builder()
                .endpoint(endpoint)
                .credentials(accessKey, secretKey)
                .build();
    }
}

3、文件上传

3.1 关键代码
MinioController.java
/**
     * 文件上传
     * @param file
     * @return
     */
    @PostMapping("/upload")
    public Map<String, Object> upload(MultipartFile file){
        return minioService.upload(file);
    }
MinioServiceImpl.java
@Override
    public Map<String, Object> upload(MultipartFile file) {
        Map<String, Object> res = new HashMap<>();
        try {
            BucketExistsArgs bucketArgs = BucketExistsArgs.builder().bucket(bucketName).build();
            // todo 检查bucket是否存在。
            boolean found = minioClient.bucketExists(bucketArgs);

            PutObjectArgs objectArgs = PutObjectArgs.builder().object(file.getOriginalFilename())
                    .bucket(bucketName)
                    .contentType(file.getContentType())
                    .stream(file.getInputStream(), file.getSize(), -1).build();

            ObjectWriteResponse objectWriteResponse = minioClient.putObject(objectArgs);
            System.out.println(objectWriteResponse.etag());
            res.put("code", "1");
            res.put("mess", "ok");
            return res;
        } catch (Exception e) {
            e.printStackTrace();
            log.info(e.getMessage());
        }
        res.put("code", "0");
        return res;
    }

4、文件下载

@Override
    public void download(String filename, HttpServletResponse res) throws IOException, InvalidKeyException, InvalidResponseException, InsufficientDataException, NoSuchAlgorithmException, ServerException, InternalException, XmlParserException, ErrorResponseException {
        BucketExistsArgs bucketArgs = BucketExistsArgs.builder().bucket(bucketName).build();
        boolean bucketExists = minioClient.bucketExists(bucketArgs);
        log.info("bucketExists:{}", bucketExists);

        GetObjectArgs objectArgs = GetObjectArgs.builder().bucket(bucketName)
                .object(filename).build();
        System.err.println("objectArgs:" + JSON.toJSONString(objectArgs));
        try (GetObjectResponse response = minioClient.getObject(objectArgs)) {
            System.err.println("response:" + JSON.toJSONString(response));
            byte[] buf = new byte[1024];
            int len;
            try (FastByteArrayOutputStream os = new FastByteArrayOutputStream()) {
                while ((len = response.read(buf)) != -1) {
                    os.write(buf, 0, len);
                }
                os.flush();
                byte[] bytes = os.toByteArray();

                res.setCharacterEncoding("utf-8");
                res.setContentType("application/force-download");// 设置强制下载不打开
                res.addHeader("Content-Disposition", "attachment;fileName=" + filename);
                try (ServletOutputStream stream = res.getOutputStream()) {
                    stream.write(bytes);
                    stream.flush();
                }
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
}
下载地址:

image.png

5、文件永久链接下载

5.1 配置

image.png

5.2 关键代码
/**
    * 生成一个GET请求的分享链接。
    * 失效时间默认是7天。
    *
    * @param bucketName 存储桶名称
    * @param objectName 存储桶里的对象名称
    * @param expires    失效时间(以秒为单位),默认是7天,不得大于七天
    * @return
    */
   public String presignedGetObject(String bucketName, String objectName, Integer expires) throws IOException, InvalidKeyException, InvalidResponseException, InsufficientDataException, NoSuchAlgorithmException, ServerException, InternalException, XmlParserException, ErrorResponseException {
       BucketExistsArgs bucketArgs = BucketExistsArgs.builder().bucket(bucketName).build();
       boolean bucketExists = minioClient.bucketExists(bucketArgs);
       // boolean flag = bucketExists(bucketName);
       String url = "";
       if (bucketExists) {
           try {
               if (expires == null){
                   expires = 604800;
               }

               GetPresignedObjectUrlArgs getPresignedObjectUrlArgs = GetPresignedObjectUrlArgs.builder()
                       .method(Method.GET)
                       .bucket(bucketName)
                       .object(objectName)
                       // .expiry(expires)
                       .build();
               url = minioClient.getPresignedObjectUrl(getPresignedObjectUrlArgs);
               log.info("*******url2:{}",url);
           } catch (Exception e) {
               log.info("presigned get object fail:{}",e);
           }
       }
       return url;
   }
下载地址:
http://192.168.1.139:9000/push-test/qiyeku.jpg
至此,springboot+minio 结束。
<think>我们正在讨论如何在虚拟机中使用Docker部署MinIO。根据提供的引用内容,我们可以整理出以下步骤:1.首先,确保虚拟机中已安装Docker。如果没有安装,需要先安装Docker。2.拉取MinIO的Docker镜像(如果尚未存在,Dockerrun命令会自动拉取)。3.使用dockerrun命令启动MinIO容器,并配置相关参数。具体命令示例在引用[2]中给出:```bashdockerrun-p9000:9000--net=host--nameminio-d--restart=always-e"MINIO_ACCESS_KEY=minioadmin"-e"MINIO_SECRET_KEY=minioadmin"-v/usr/local/docker/minio/data:/data-v/usr/local/docker/minio/config:/root/.miniominioserver/data--console-address":9090"-address":9000"```解释参数:-`-p9000:9000`:将容器的9000端口映射到主机的9000端口(用于API访问)。-`--net=host`:使用主机网络模式,这样可以简化网络配置(但注意,如果使用主机网络模式,则-p端口映射可能无效,因为容器直接使用主机网络。根据需求,可以选择移除`--net=host`,或者保留并使用端口映射)。-`--nameminio`:容器名称。-`-d`:后台运行。-`--restart=always`:容器退出时总是重启。-`-e`:设置环境变量,这里设置访问密钥和秘密密钥(示例中为minioadmin,生产环境应更改)。-`-v`:挂载卷,将主机目录挂载到容器内,用于持久化存储数据和配置。-`minioserver/data`:启动MinIO服务器,数据目录为/data。-`--console-address":9090"`:控制台端口(Web管理界面)为9090。-`-address":9000"`:API端口为9000。注意:上述命令中同时指定了控制台地址和API地址,并使用了主机网络模式(--net=host)。如果使用主机网络模式,那么容器将使用宿主机的网络,此时端口映射(-p)是不必要的,因为容器直接使用主机端口。但命令中仍然有`-p9000:9000`,这可能会产生冲突。因此,建议根据实际情况选择:方案一:使用主机网络(移除-p参数)```bashdockerrun--net=host--nameminio-d--restart=always-e"MINIO_ACCESS_KEY=minioadmin"-e"MINIO_SECRET_KEY=minioadmin"-v/usr/local/docker/minio/data:/data-v/usr/local/docker/minio/config:/root/.miniominioserver/data--console-address":9090"-address":9000"```方案二:不使用主机网络(使用端口映射,移除--net=host)```bashdockerrun-p9000:9000-p9090:9090--nameminio-d--restart=always-e"MINIO_ACCESS_KEY=minioadmin"-e"MINIO_SECRET_KEY=minioadmin"-v/usr/local/docker/minio/data:/data-v/usr/local/docker/minio/config:/root/.miniominioserver/data--console-address":9090"-address":9000"```这里我们增加了9090端口的映射,以便访问控制台。步骤指南:1.创建用于持久化的目录(根据命令中的挂载点):```bashmkdir-p/usr/local/docker/minio/datamkdir-p/usr/local/docker/minio/config```2.执行dockerrun命令(选择上述方案之一)。例如选择方案二:```bashdockerrun-p9000:9000-p9090:9090\--nameminio\-d\--restart=always\-e"MINIO_ACCESS_KEY=minioadmin"\-e"MINIO_SECRET_KEY=minioadmin"\-v/usr/local/docker/minio/data:/data\-v/usr/local/docker/minio/config:/root/.minio\minioserver/data\--console-address":9090"\-address":9000"```3.等待容器启动,然后可以通过虚拟机IP:9090访问MinIO控制台(使用设置的访问密钥和秘密密钥登录)。注意:如果虚拟机有防火墙,确保开放9000和9090端口。此外,引用[1]中提到MinIO是对象存储,用于存储各种数据,并功能强大。部署完成后,可以整合SpringBoot等应用使用。[^1]:Docker部署minio存储及整合springboot使用。[^2]:Docker部署Minio(服务器上部署Minio)。§§相关问题§§1.如何修改MinIO访问密钥和秘密密钥?2.MinIO的数据持久化是如何工作的?3.如何在Docker中更新MinIO容器?4.MinIO控制台无法访问可能的原因是什么?</think>### 在虚拟机中使用Docker部署MinIO的指南 #### 1️⃣ **前提条件** - 已安装虚拟机(如VMware/VirtualBox) - 虚拟机中已安装Docker([官方安装指南](https://docs.docker.com/engine/install/)) - 预留至少1GB内存(MinIO要求) #### 2️⃣ **部署步骤** **(1) 创建持久化存储目录** ```bash mkdir -p /minio/data /minio/config ``` **(2) 启动MinIO容器** ```bash docker run -d \ -p 9000:9000 \ # API端口 -p 9090:9090 \ # 控制台端口 --name minio \ -v /minio/data:/data \ # 数据持久化 -v /minio/config:/root/.minio \ # 配置持久化 -e "MINIO_ROOT_USER=admin" \ # 登录用户名 -e "MINIO_ROOT_PASSWORD=your_strong_password" \ # 登录密码 --restart=always \ minio/minio server /data --console-address ":9090" ``` > 💡 说明: > - 替换`your_strong_password`为高强度密码 > - 数据将永久保存在虚拟机`/minio/data`目录[^1] **(3) 验证部署** ```bash docker ps | grep minio # 应显示运行中的容器 curl http://localhost:9000 # 返回XML响应即成功 ``` #### 3️⃣ **访问控制台** 1. 在虚拟机浏览器访问: ``` http://localhost:9090 ``` 2. 或通过宿主机访问(需配置端口转发): ``` http://<虚拟机IP>:9090 ``` 3. 使用步骤(2)设置的用户名密码登录 #### 4️⃣ **基本使用** - 登录后创建存储桶(Bucket) - 通过API端点`http://<IP>:9000`进行编程访问 - Spring Boot集成示例配置: ```yaml minio: endpoint: http://虚拟机IP:9000 access-key: admin secret-key: your_strong_password bucket: my-bucket ``` #### 5️⃣ **常见问题处理** - **端口冲突**:修改`-p`参数映射端口(如`-p 9001:9000`) - **权限不足**:添加`--user $(id -u):$(id -g)`到docker命令 - **磁盘空间**:确保虚拟机有足够存储(建议预留10GB+) > ⚠️ **安全提示**:生产环境务必修改默认密码,建议使用TLS加密传输[^2] [^1]: MinIO数据持久化通过Docker卷映射实现,确保容器重启后数据不丢失。 [^2]: Docker部署MinIO时可通过`-v`挂载SSL证书目录实现HTTPS访问
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值