L05_后端_MinIO 安装使用入门指南（实战版）-优快云博客

MinIO 安装使用入门指南（实战版）

MinIO 是基于 Go 开发的高性能对象存储，兼容 S3 协议，适合存储图片、视频、备份数据等非结构化文件（支持 1KB-5TB 大小），国内阿里、腾讯、华为等企业均有使用。本文以「实战」为核心，带你快速完成 MinIO 安装、配置及 Spring Boot 集成。

1、MinIO Server 安装（4种常用方式）

MinIO 仅需一个运行程序，部署极简单，推荐优先选择 Docker 方式（跨系统且无需配置环境）。

1.1 Docker 安装（推荐）

适用于 Windows/Linux/MacOS，需先安装 Docker。

执行启动命令（直接复制运行）：

# Windows 系统
docker run -p 9000:9000 -p 9001:9001 -e "MINIO_ACCESS_KEY=admin" -e "MINIO_SECRET_KEY=password" minio/minio server /data --console-address ":9001"

# Linux/MacOS 系统（指定本地存储目录，示例为 /Users/yourDir/minio，需替换为自己的目录）
docker run -p 9000:9000 -p 9001:9001 -e "MINIO_ACCESS_KEY=admin" -e "MINIO_SECRET_KEY=password" minio/minio server /Users/yourDir/minio --console-address ":9001"

9000 端口：API 访问端口（程序调用用）
9001 端口：Web UI 管理端口（可视化操作）
账号密码：admin/password（实际生产需修改）

1.2 本地安装（Windows/Linux/MacOS）

Windows（PowerShell 中执行）

# 1. 下载 MinIO 程序（国外资源较慢，可手动从官网下载）
Invoke-WebRequest -Uri "https://dl.min.io/server/minio/release/windows-amd64/minio.exe" -OutFile "C:\minio.exe"

# 2. 设置账号密码环境变量
setx MINIO_ROOT_USER admin
setx MINIO_ROOT_PASSWORD password

# 3. 启动服务（F:\Data 为存储目录，可替换）
C:\minio.exe server F:\Data --console-address ":9001"

Linux

# 1. 下载并授权
wget https://dl.min.io/server/minio/release/linux-amd64/minio
chmod +x minio

# 2. 启动服务（/Users/yourDir/minio 为存储目录，可替换）
MINIO_ROOT_USER=admin MINIO_ROOT_PASSWORD=password ./minio server /Users/yourDir/minio --console-address ":9001"

MacOS

# 1. 下载并授权
wget https://dl.min.io/server/minio/release/darwin-amd64/minio
chmod +x minio

# 2. 启动服务（F:\Data 为存储目录，可替换）
MINIO_ROOT_USER=admin MINIO_ROOT_PASSWORD=password ./minio server F:\Data --console-address ":9001"

2、MinIO Web UI 基础操作

启动服务后，通过浏览器访问 http://127.0.0.1:9001，输入账号 admin、密码 password 登录。

2.1 新建存储桶（Bucket）

存储桶是文件的「容器」，需先创建才能上传文件：

点击首页 Create Bucket 按钮；
输入存储桶名称（如 ly_test），点击 Create。

2.2 设置公开访问（readonly 规则）

默认文件需授权才能访问，实际场景常需「直接通过 URL 访问」，需添加规则：

点击存储桶右上角的 Configure Bucket（设置图标）→ 选择 Access Rules；
点击 Add Access Rule，设置 Prefix 为 /、Access 为 readonly，点击 Save。

2.3 上传/访问文件

上传：点击存储桶内的 Upload → Upload File，选择本地文件上传；
访问：文件访问 URL 格式为 http://127.0.0.1:9000/{存储桶名}/{文件名}（注意用 9000 端口）。
示例：若存储桶为 ly_test，文件名为 test.jpg，则 URL 为 http://127.0.0.1:9000/ly_test/test.jpg。