最近一段时间,后台收到不少读者在问“Windows下怎么装MinIO”。其实不只是个人开发者,很多中小团队在做内部工具、私有云盘、测试环境,或者想绕开云厂商的对象存储费用时,都倾向于在Windows服务器上先跑一套MinIO。今天这篇不打算讲太多漂亮话,直接把我实际折腾过的安装步骤、绕过的坑、以及后面跟Spring Boot对接的常用姿势一次性写清楚,希望能帮你少走几步弯路。
1. 为什么要在Windows上折腾MinIO
1.1 MinIO是什么,收费吗
MinIO是一个开源的高性能对象存储服务,兼容Amazon S3 API。你可以简单把它想成“自己服务器上的阿里云OSS”,数据不经过第三方,完全在你自己的机器上。官方有社区版,也有商业版,社区版保留了核心功能:桶存储、上传下载、预签名URL、生命周期管理、事件通知、跨区域复制这些全都包含,个人和企业商用都不收费。
很多人听到“不收费”会下意识怀疑,其实这个模式在开源圈很常见,真正收费的是企业订阅、技术支持、以及某些合规场景下的企业级授权。所以如果你只是内部使用、自己玩或者做开发测试,社区版就够了。也正是因为这点,MinIO成了很多小团队私有化的首选。
1.2 为什么推荐在Windows上先跑起来
虽然生产环境我一般建议Linux,但Windows场景依然很常见。我用过的场景包括:开发机上联调文件上传接口、给客户演示私有化产品、内网临时搭一个共享文件服务、以及用Windows Server跑一些旧系统时的数据中转。Windows的好处是可视化操作直观,不用记太多命令行,很多运维不熟Linux的团队也能轻松维护。
另外现在MinIO的Windows版本已经非常成熟,单文件exe,双击就能跑,半天就能把整个对象存储环境从零搭完,很适合快速验证你的业务代码是否兼容S3接口,再决定要不要迁移到Linux集群。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装前的环境准备与版本选择
2.1 下载哪个版本
MinIO官方下载页面很简洁,Windows版本会提供一个单独的exe文件。不建议下载那种带installer的绿色版,直接要那个二进制文件就行。文件名通常是minio.exe,大小在100MB上下,这个文件就是全部的服务端。
版本选择上,我个人的经验是:最新RELEASE版本功能全、修了近期Bug,但如果你要对接旧的SDK或者公司内部有一些历史接口,可能需要稍微留意。比如MinIO的几个大版本在API兼容性上基本没变化,但升级前最好还是看一眼Release Notes,别为了新功能平白踩坑。
提示:官网如果访问慢,可以用镜像站下载,但尽量别用非官方渠道的打包版本,一是可能有安全风险,二是某些“优化版”会修改二进制行为,排查问题的时候非常麻烦。
2.2 准备数据目录和端口
启动MinIO前,先规划两块内容:
- 数据目录:存放对象数据的物理路径,比如
D:\minio-data。建议放在数据盘,不要放C盘系统盘,后面上传量大容易把系统盘占满。 - 端口规划:默认API端口9000,Web控制台端口9001。如果你本机已有程序占用,可以用
--address和--console-address参数修改。
我见过有人下载完MinIO就直接在默认目录跑,结果把C盘塞满系统卡死,这是个很常见的低级事故。哪怕是测试环境,也建议数据目录单独建,至少后续清理时能一眼看清楚。
3. 一步步完成MinIO在Windows上的安装与启动
3.1 最简单的启动方式:命令行启动
先给一个最基础的启动命令,打开PowerShell或CMD,切换到minio.exe所在目录:
bash复制minio.exe server D:\minio-data --console-address ":9001"
执行之后,终端会打印出几行关键信息,包括API访问地址http://192.168.x.x:9000、控制台地址http://192.168.x.x:9001、以及默认的Access Key和Secret Key(老版本会随机生成)。命令行窗口不能关闭,关闭窗口MinIO进程就停了。
这招适合临时测试,但不适合长期运行。很多人卡在这一步:把命令行窗口关了再打开,服务又没了,于是觉得“这软件不好用”。其实是你没把它做成服务。
3.2 用环境变量设置固定账号密码
启动服务前,建议先设置两个环境变量,这样Control Panel登录、SDK对接时都有确定的账号密码,不会因为随机生成导致后续还得去翻日志找密钥。
powershell复制setx MINIO_ROOT_USER "myadmin"
setx MINIO_ROOT_PASSWORD "mypassword123"
然后重新打开一个PowerShell窗口再启动服务。注意:setx设置的是当前用户永久环境变量,如果设置
