使用 Docker 快速搭建 MinIO 文件存储服务

在日常开发中，我们经常需要处理文件上传、下载、存储与访问的场景，比如图片、视频、日志文件、模型数据集等。传统的文件系统难以满足高并发、分布式部署以及云原生化的需求。而 MinIO 作为一款高性能、轻量级、兼容 Amazon S3 协议的对象存储服务，正是为此而生。

本文将带你从零开始，通过 Docker 部署 MinIO 服务，并结合 Java SDK 实现文件的上传与访问。

无论你是想在本地搭建一个轻量文件中心，还是为企业内部系统构建一个可扩展的对象存储方案，这篇文章都能帮你快速上手。

1 拉取 Minio 镜像
docker pull minio/minio:RELEASE.2025-04-22T22-12-26Z

2 启动 Minio 容器
我们假设你希望访问端口为 9000（API）和 9001（Web 控制台），可以这样运行：

docker run -d
--name minio
-p 9000:9000
-p 9001:9001
-v /Users/zhangyong/docker/minio/data:/data
-v /Users/zhangyong/docker/minio/config:/root/.minio
-e "MINIO_ROOT_USER=admin"
-e "MINIO_ROOT_PASSWORD=admin123456"
minio/minio:RELEASE.2025-04-22T22-12-26Z
server /data --console-address ":9001"
01 参数说明
-p 9000:9000：MinIO API 服务端口
-p 9001:9001：Web 控制台端口
-v /Users/zhangyong/docker/minio/data:/data：映射数据目录
-v /Users/zhangyong/docker/minio/config:/root/.minio：保存配置
MINIO_ROOT_USER、MINIO_ROOT_PASSWORD：管理员账号密码
server /data --console-address ":9001"：指定数据目录并启用控制台端口
02 启动后访问
控制台地址：http://localhost:9001
登录账号：admin
登录密码：admin123456

3 上传文件
在 MinIO（以及所有兼容 S3 的对象存储系统）中，桶（Bucket） 是最顶层的逻辑存储单元，可以理解为一个“命名空间”或“大文件夹”，它是所有对象（文件）的容器。

MinIO 不存在真正的目录结构，而是通过对象 key 的前缀来模拟目录层级。

例如，我们可以创建一个 bucket 叫 datasets ，数据集下面的文件对象如下：

datasets/
├── mydataset1/
│ ├── train/image1.jpg
│ └── train/image2.jpg
└── mydataset2/
├── data.csv
└── labels.txt
虽然看起来像目录树，但实际上存储系统中只有对象：

datasets/mydataset1/train/image1.jpg
datasets/mydataset1/train/image2.jpg
datasets/mydataset2/data.csv
datasets/mydataset2/labels.txt
MinIO 客户端（mc）或 SDK（Java/Python）在列举对象时，会自动把这些前缀识别为“目录”。

接下来，我们按照流程上传文件。

1、创建桶 datasets

2、创建新路径 mydataset1

3、上传图片

4 访问授权
1、修改桶的访问策略

图中，我们需要将访问策略从 Private 修改成 Public