Windows 系统安装使用

通过 Windowscmd 窗口安装 MinIO

  1. 打开 Windowscmd 窗口,并 cdMinIO 安装文件所在目录。
  2. 运行以下命令:

.\minio.exe server .\ --console-address ":9000" --address ":9090"
9000 表示 ui 端口
9090 表示 接口端口

在这里插入图片描述

Linux 系统

后台启动命令
nohup ./minio server ./data/ --console-address ":9090" --address ":9000" >./data/minio.log 2>&1 &
其中 nohup ... >./data/minio.log 2>&1 & 表示后台启动,通用命令
./minio server ./data/ 表示minio 启动命令,第三部分表示文件读取位置。

MinIO 整合 spring boot

导入MinIO 依赖

<dependency>
   <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
    <version>8.2.2</version>
  </dependency>

配置配置文件,方便修改

minio:
  url: xxxx  # MinIO 服务地址
  accessKey: minioadmin	# MinIO 用户
  secretKey: minioadmin	# MinIO 密码
  bucketName: csv-file	# 俑名称

创建配置类

/**
 * MinIo 配置文件
 */
@Data
@Configuration
@ConfigurationProperties(prefix = "minio")
public class MinIoConfig {

    /**
     * 服务地址(服务接口地址)
     */
    private String url;

    /**
     * 用户名
     */
    private String accessKey;

    /**
     * 密码
     */
    private String secretKey;

    /**
     * 存储桶名称
     */
    private String bucketName;


    @Bean
    public MinioClient getMinioClient() {
        return MinioClient.builder().endpoint(url).credentials(accessKey, secretKey).build();
    }
    
}

MinIO 工具类

接口类,这里只提供两个方法(下载和获取文件访问url)

/**
 * 文件上传接口
 * 
 * @author admin
 */
public interface ISysFileService
{
    /**
     * 文件上传接口
     * 
     * @param file 上传的文件
     * @return 访问地址
     * @throws Exception
     */
    public String uploadFile(MultipartFile file) throws Exception;

    /**
     * 返回文件 URL
     *
     * @param fileName 文件名
     * @return
     */
    public String getPresignedObjectUrl(String fileName) throws Exception;
}

接口实现类

/**
 * Minio 文件存储
 *
 * @author admin
 */
@Primary
@Service
public class MinioSysFileServiceImpl implements ISysFileService {

    @Autowired
    private MinIoConfig minIoConfig;

    @Autowired
    private MinioClient client;

    /**
     * 本地文件上传接口
     *
     * @param file 上传的文件
     * @return 访问地址
     * @throws Exception
     */
    @Override
    public String uploadFile(MultipartFile file) throws Exception {
        String fileName = MinIOFileUploadUtils.extractFilename(file);
        PutObjectArgs args = PutObjectArgs.builder()
                .bucket(minIoConfig.getBucketName())
                .object(fileName)
                .stream(file.getInputStream(), file.getSize(), -1)
                .contentType(file.getContentType())
                .build();
        client.putObject(args);
        return fileName;
    }

    /**
     * 返回文件 URL
     *
     * @param fileName 文件名
     * @return
     */
    @Override
    public String getPresignedObjectUrl(String fileName) throws Exception {
        String url = client.getPresignedObjectUrl(
                GetPresignedObjectUrlArgs.builder()
                        .method(Method.GET)
                        .bucket(minIoConfig.getBucketName())
                        .object(fileName)
                        .build());
        return url;
    }

}

文件处理工具类

/**
 * 文件上传工具类
 *
 * @author admin
 */
public class MinIOFileUploadUtils {
    /**
     * 默认大小 50M
     */
    public static final long DEFAULT_MAX_SIZE = 50 * 1024 * 1024;

    /**
     * 默认的文件名最大长度 100
     */
    public static final int DEFAULT_FILE_NAME_LENGTH = 100;

    /**
     * 根据文件路径上传
     *
     * @param baseDir 相对应用的基目录
     * @param file    上传的文件
     * @return 文件名称
     * @throws IOException
     */
    public static final String upload(String baseDir, MultipartFile file) throws IOException {
        try {
            return upload(baseDir, file, MimeTypeUtils.DEFAULT_ALLOWED_EXTENSION);
        } catch (Exception e) {
            throw new IOException(e.getMessage(), e);
        }
    }

    /**
     * 文件上传
     *
     * @param baseDir          相对应用的基目录
     * @param file             上传的文件
     * @param allowedExtension 上传文件类型
     * @return 返回上传成功的文件名
     * @throws FileSizeLimitExceededException       如果超出最大大小
     * @throws FileNameLengthLimitExceededException 文件名太长
     * @throws IOException                          比如读写文件出错时
     * @throws InvalidExtensionException            文件校验异常
     */
    public static final String upload(String baseDir, MultipartFile file, String[] allowedExtension)
            throws FileSizeLimitExceededException, IOException, FileNameLengthLimitExceededException,
            InvalidExtensionException {
        int fileNamelength = file.getOriginalFilename().length();
        if (fileNamelength > MinIOFileUploadUtils.DEFAULT_FILE_NAME_LENGTH) {
            throw new FileNameLengthLimitExceededException(MinIOFileUploadUtils.DEFAULT_FILE_NAME_LENGTH);
        }

        assertAllowed(file, allowedExtension);

        String fileName = extractFilename(file);

        File desc = getAbsoluteFile(baseDir, fileName);
        file.transferTo(desc);
        String pathFileName = getPathFileName(fileName);
        return pathFileName;
    }

    /**
     * 编码文件名
     */
    public static final String extractFilename(MultipartFile file) {
        String fileName = file.getOriginalFilename();
        String extension = getExtension(file);
//        fileName = DateUtils.datePath() + "/" + IdUtils.fastUUID() + "." + extension;
        fileName = IdUtils.fastUUID() + "." + extension;

        return fileName;
    }

    private static final File getAbsoluteFile(String uploadDir, String fileName) throws IOException {
        File desc = new File(uploadDir + File.separator + fileName);

        if (!desc.exists()) {
            if (!desc.getParentFile().exists()) {
                desc.getParentFile().mkdirs();
            }
        }
        return desc.isAbsolute() ? desc : desc.getAbsoluteFile();
    }

    private static final String getPathFileName(String fileName) throws IOException {
        String pathFileName = "/" + fileName;
        return pathFileName;
    }

    /**
     * 文件大小校验
     *
     * @param file 上传的文件
     * @throws FileSizeLimitExceededException 如果超出最大大小
     * @throws InvalidExtensionException      文件校验异常
     */
    public static final void assertAllowed(MultipartFile file, String[] allowedExtension)
            throws FileSizeLimitExceededException, InvalidExtensionException {
        long size = file.getSize();
        if (DEFAULT_MAX_SIZE != -1 && size > DEFAULT_MAX_SIZE) {
            throw new FileSizeLimitExceededException(DEFAULT_MAX_SIZE / 1024 / 1024);
        }

        String fileName = file.getOriginalFilename();
        String extension = getExtension(file);
        if (allowedExtension != null && !isAllowedExtension(extension, allowedExtension)) {
            if (allowedExtension == MimeTypeUtils.IMAGE_EXTENSION) {
                throw new InvalidExtensionException.InvalidImageExtensionException(allowedExtension, extension,
                        fileName);
            } else if (allowedExtension == MimeTypeUtils.FLASH_EXTENSION) {
                throw new InvalidExtensionException.InvalidFlashExtensionException(allowedExtension, extension,
                        fileName);
            } else if (allowedExtension == MimeTypeUtils.MEDIA_EXTENSION) {
                throw new InvalidExtensionException.InvalidMediaExtensionException(allowedExtension, extension,
                        fileName);
            } else if (allowedExtension == MimeTypeUtils.VIDEO_EXTENSION) {
                throw new InvalidExtensionException.InvalidVideoExtensionException(allowedExtension, extension,
                        fileName);
            } else {
                throw new InvalidExtensionException(allowedExtension, extension, fileName);
            }
        }
    }

    /**
     * 判断MIME类型是否是允许的MIME类型
     *
     * @param extension        上传文件类型
     * @param allowedExtension 允许上传文件类型
     * @return true/false
     */
    public static final boolean isAllowedExtension(String extension, String[] allowedExtension) {
        for (String str : allowedExtension) {
            if (str.equalsIgnoreCase(extension)) {
                return true;
            }
        }
        return false;
    }

    /**
     * 获取文件名的后缀
     *
     * @param file 表单文件
     * @return 后缀名
     */
    public static final String getExtension(MultipartFile file) {
        String extension = FilenameUtils.getExtension(file.getOriginalFilename());
        if (StringUtils.isEmpty(extension)) {
            extension = MimeTypeUtils.getExtension(file.getContentType());
        }
        return extension;
    }
}

我踩过的坑

问题描述(访问有效期过期)

在第一次使用 MinIO 来实现文件上传时,发现MinIO是真的很好用,简单便利。然后用了一段时间后发现一个对我来说很大影响的问题,MinIO 的文件访问URL 有限期之后 7 天,意味着七天之后就不能访问文件了,这对我的项目有很大的影响。自己傻傻的百度了一堆修改访问策略为永久的方法,而且按照其他人的博客修改了访问策略之后也不能马上知道这个方法是否有效,因此每次都是等一段时间后再看看URL 是否还有效,就这样反复折磨了一个多月,最后还是出现过期情况。一度想过要不算了吧,不用 MinIO 了,但是自己又懒得去找其他框架再修改代码。后来终于受不了了,打算找个教程视频看看别人是如何处理这个问题的。看了很多视频还是没有人谈到这个问题,基本都是说 MinIO的优势,怎么上传和下载的。但是我需要的是能让项目永久访问文件,比如头像,这种情况我并不像下载文件到本地。不知道怎么的,我就想到了这个问题的解决方案,然后 MinIO 真好用。啧啧啧

解决方案

我原来的思路是将文件上传 MinIO 服务器,上传成功后保存文件访问 URL 到数据库中,这样当我需要用到这个文件(头像)时,就可以直接读取数据库中的 URL
解决思路就是修改保存到数据库的数据为文件名,当需要用到这个文件(头像)时,从数据库中读取到文件名,然后再通过 MinIO提供的 api 接口获取到最新的 URL 地址。
总的来说就是每次用到 URL 都为最新的,这样就不需要考虑它的有效期问题了。
我真是个铁憨憨,这么简单都想不到。

Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐