一、为什么要用 MinIO？
MinIO 是一个与 AWS S3 100% 兼容的高性能对象存储，单文件即可运行，非常适合个人网盘、备份、日志归档、AI 训练数据集存储等场景。本文基于 开源 AGPLv3 版本，在 Windows 10/11 上演示完整部署流程，并汇总常见踩坑。
二、准备工作
| 项目 | 建议 |
|---|---|
| 操作系统 | Windows 10/11 64 位 |
| 磁盘空间 | ≥ 10 GB（取决于你打算存多少数据） |
| 网络 | 建议固定内网 IP，便于后续客户端访问 |
| 权限 | 普通管理员账户即可 |
三、下载与目录规划
1. 下载开源版
https://www.minio.org.cn/download.shtml#/windows
image.png
⚠️ 注意
- 不要从
subnet.min.io或企业门户下载，否则拿到的是商业版，会提示 license 错误。- 不要把 exe 放在有空格或中文的路径，例如
C:\Program Files，否则会踩路径解析坑。
四、设置 root 账号
MinIO 要求：
-
MINIO_ROOT_USER≥ 3 字符 -
MINIO_ROOT_PASSWORD≥ 8 字符
setx MINIO_ROOT_USER admin
setx MINIO_ROOT_PASSWORD minio123456
⚠️ 注意
setx写入的是 系统环境变量，必须关闭当前窗口并重新打开一个新的 PowerShell，变量才会生效。
如果想立即生效，也可在当前窗口用set做临时变量：
set MINIO_ROOT_USER=admin
set MINIO_ROOT_PASSWORD=minio123456
五、启动 MinIO
在新 PowerShell 中执行：
cd D:\app\minio\bin
.\minio.exe server D:\app\minio\data --console-address ":9001"
首次启动会看到类似日志：
INFO: Formatting 1st pool, 1 set(s), 1 drives per set.
RootUser: admin
RootPass: minio123456
WebUI: http://127.0.0.1:9001
浏览器访问 http://127.0.0.1:9001 即可登录控制台。
image.png
六、一键启动脚本（可选）
把下面内容保存成 D:\app\minio\minio_server.bat，双击即可启动：
@echo off
:: 临时变量，立即生效
set MINIO_ROOT_USER=admin
set MINIO_ROOT_PASSWORD=minio123456
D:\app\minio\bin\minio.exe server D:\app\minio\data --console-address ":9001"
pause
七、安装 mc 客户端（推荐）
# 下载 mc
Invoke-WebRequest -Uri "https://dl.min.io/client/mc/release/windows-amd64/mc.exe" `
-OutFile "C:\Windows\mc.exe"
# 添加别名
mc alias set local http://127.0.0.1:9000 admin minio123456
# 常用命令
mc mb local/photos # 建桶
mc cp a.jpg local/photos # 上传
mc ls local # 列桶
八、常见报错汇总
| 报错信息 | 原因 | 解决 |
|---|---|---|
Unable to validate license |
下载了商业版 | 重新下载开源版 |
Invalid credentials |
环境变量未生效或长度不够 | 重新设置并重开窗口 |
The filename, directory name, or volume label syntax is incorrect |
路径有空格或中文 | 把 minio.exe 和数据目录放在纯英文无空格路径 |
端口已被占用 |
9000/9001 被其他程序占用 | 换成 --address ":9002" --console-address ":9003"
|
九、安全与运维小贴士
-
强密码：生产环境请把
minio123456换成 12 位以上混合密码。 - 防火墙：如需外网访问，放行 TCP 9000 与 9001。
-
HTTPS：把证书放到
C:\Users\<用户名>\.minio\certs目录即可启用 HTTPS。 -
数据备份：定期把
D:\app\minio\data整个目录做异地备份。 - 升级：定期关注 MinIO Releases，直接替换 exe 即可平滑升级。
十、结语
至此，一台 Windows 单机 MinIO 对象存储就部署完毕，既能在局域网内当私有云盘，也能给 AI 框架、备份脚本、Web 应用当 S3 后端。祝你使用愉快，踩坑不迷路！
如果本文帮到你，欢迎点赞 + 收藏，评论区交流更多玩法！
