MinIO Windows 安装与配置文档

一、环境说明

• 操作系统：Windows 10/11 64 位、Windows Server 2016 及以上
• 软件版本：MinIO Server、MinIO Client (mc)
• 端口说明：API 端口 9000、Web 控制台端口 9001

二、目录结构规划

plaintext

D:\Minio\
├─ bin\          # 存放 minio.exe、mc.exe
└─ data\         # 对象存储数据目录

三、软件下载

1. MinIO Server

国内镜像下载地址：https://dl.minio.org.cn/server/minio/release/windows-amd64/minio.exe

2. MinIO Client (mc)

https://dl.minio.org.cn/client/mc/release/windows-amd64/mc.exe

将下载后的两个文件放入 D:\Minio\bin 目录。

四、启动 MinIO 服务

打开 PowerShell，进入 bin 目录：

powershell

cd D:\Minio\bin

1. 设置账号密码（必须满足规则）

• MINIO_ROOT_USER：长度 ≥3
• MINIO_ROOT_PASSWORD：长度 ≥8

powershell

$env:MINIO_ROOT_USER="admin"
$env:MINIO_ROOT_PASSWORD="12345678"

2. 启动服务命令

powershell

.\minio.exe server ..\data --console-address ":9001"

3. 启动成功标识

plaintext

API: http://192.168.1.6:9000  http://127.0.0.1:9000
WebUI: http://192.168.1.6:9001 http://127.0.0.1:9001
RootUser: admin
RootPass: 12345678

五、Web 控制台访问

访问地址：http://127.0.0.1:9001

• 用户名：admin
• 密码：12345678

可在控制台中创建 Bucket、上传 / 下载文件、管理权限等。

六、MinIO 客户端（mc）配置

1. 配置连接别名

新版 mc 使用 alias set 替代旧版 config host：

powershell

.\mc.exe alias set myminio http://127.0.0.1:9000 admin 12345678

2. 验证连接

powershell

.\mc.exe ls myminio

无报错即表示配置成功。

七、常见问题说明

1. 无法识别 minio.exe

   • 原因：当前 PowerShell 路径不在 D:\Minio\bin
   • 解决：使用 cd D:\Minio\bin 切换目录

2. Invalid credentials 报错

   • 原因：账号密码长度不满足规则
   • 解决：用户名≥3 位，密码≥8 位

3. mc: config is not a recognized command

   • 原因：新版 mc 废弃 config host 命令
   • 解决：使用 alias set 命令

八、常用信息汇总

• API 地址：http://127.0.0.1:9000
• Web 控制台：http://127.0.0.1:9001
• 管理员账号：admin
• 管理员密码：12345678
• 数据存储目录：D:\Minio\data