好几个朋友问我Windows下装MinIO到底怎么搞,网上教程东一句西一句,不是缺启动参数就是没讲权限配置,照着抄完还是一堆坑。正好我最近在Windows Server和Win10/11上都完整跑过MinIO,从下载到Java集成踩了一遍,今天把整个过程整理成一篇能直接照着操作的记录,给同样需要在Windows环境搭对象存储的人省点时间。
MinIO是什么就不多解释了,一句话:一个兼容Amazon S3协议的开源对象存储服务,单文件(exe)就能跑,用来存图片、视频、备份包、日志文件都行,也可以当本地开发环境里的S3替代品。对于Windows环境来说,它最大的价值就是部署简单——不用装数据库、不用配集群,一个exe加一条命令,本地开发、内网测试、小规模生产都能扛住。这篇文章适合谁看?准备在Windows上跑MinIO做测试的、公司内网要用对象存储存文件的、以及Java开发想在Spring Boot里集成MinIO的,都可以直接参考。
1. 环境准备与安装方式选择
1.1 版本选择和下载渠道
MinIO官方对Windows的支持一直很到位,直接提供原生exe文件,不用装Docker Desktop也能跑。这一点在Windows Server上特别省事,因为很多服务器环境不允许装Docker,而且Docker Desktop本身在Windows上跑容器要开Hyper-V或者WSL2,对老服务器来说负担不小。我推荐的方案就是直接下载Windows版exe,官方下载地址在min.io/download,往下翻能找到Windows版本,文件名一般是minio.exe。
关于版本,这里要单独提一下。MinIO目前分两个大版本线:RELEASE版本是官方发布的稳定版,带具体日期编号,比如RELEASE.2024-xx-xxTxx-xx-xxZ这种格式,推荐生产环境用;另一个是实验性或者历史版本,不要碰。下载的时候注意别搞混了,认准RELEASE开头、日期最新的稳定版就行。有些教程让你用docker镜像拉取,Windows下如果要走Docker方式,镜像名是minio/minio,但我不建议你在Windows上用Docker跑MinIO,原因后面讲。
另外要特别提醒:MinIO本身是开源的,Apache 2.0许可,个人和企业使用都是免费的,官方收取费用的是企业版(包括额外的技术支持、审计日志、跨地域复制这些增值功能),社区版没有功能阉割,只是没有官方支撑。所以网上问"MinIO收费吗"可以放心,社区版一直免费。
1.2 为什么推荐Windows原生exe而不是Docker
如果你在Windows上装了Docker Desktop,跑MinIO确实就一条命令的事,但有几个实际问题:
第一,Docker Desktop在Windows上运行需要WSL2或者Hyper-V,这会额外消耗内存和CPU资源,而且虚拟机磁盘占空间。第二,Docker容器里的MinIO数据目录在Windows文件系统上做映射时,有时会出现io性能不稳定、文件锁异常的问题,尤其你如果后续要做断点续传或者大文件分片上传,这个问题会被放大。第三,Windows上跑Docker容器,重启之后容器可能没有自启动,还得手动docker start,运维上不方便。
而原生exe直接就是Windows进程,开机自启可以用NSSM注册成服务,数据目录直接指到NTFS分区,稳定性比Docker好一个档次。所以综合下来,Windows环境我都是直接用exe,不用Docker。至于WSL2里跑MinIO,也可以,但WSL2的网络模式和Windows宿主之间有NAT转换,外部机器访问MinIO的端口会麻烦一点,公司内网多人想共用这个存储服务就会很别扭。我的建议:Windows上跑MinIO,最省心就是exe直接跑。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装过程和启动配置详解
2.1 下载后的目录规划
下载minio.exe之后,建议不要随便扔在下载文件夹里,规划一个独立目录,比如 D:\MinIO\ 下面是这样的结构:
text复制D:\MinIO\
├── minio.exe
├── data\ # 数据存储目录
└── logs\ # 日志目录
data目录就是MinIO实际存放对象的根目录,这个目录可以在启动命令里通过参数指定,也可以配多个磁盘路径做跨盘存储。logs目录用来存放运行日志,后面排查问题会用到。为什么单独建logs目录?因为MinIO默认不输出持久化日志,控制台启动后日志直接打到stdout,如果你用命令行窗口启动,关掉窗口日志就丢了。重定向到文件方便回溯问题。
接下来设置环境变量。MinIO在Windows上启动时两个关键的账号变量是MINIO_ROOT_USER和MINIO_ROOT_PASSWORD,分别对应管理员的Access Key和Secret Key,这是用来登录Web控制台和调API的认证凭据。在命令行窗口里设置环境变量只会对当前会话生效,重启窗口就没了。更好的做法是在系统环境变量里设置,或者每次启动时通过命令行参数传入。
我建议用命令行参数方式,简单直接,也不会影响系统其他程序:
bash复制setx MINIO_ROOT_USER "admin"
setx MINIO_ROOT_PASSWORD "your-strong-password"
注意setx会把变量永久写入用户环境变量,如果只是临时测试,用set命令设置当前会话变量就够了:
bash复制set MINIO_ROOT_USER=admin
set MINIO_ROOT_PASSWORD=your-strong-password
2.2 启动命令的几种方式
启动MinIO最基础的方式是:
bash复制minio.exe server D:\MinIO\data --console-address ":9001"
这里说明一下,MinIO有两个端口:API端口默认9000,就是给应用程序上传下载对象用的S3兼容端口;控制台端口是Web管理后台,我这里指定9001。如果你不指定--console-address,新版MinIO会用随机端口打开控制台,那会非常难找。所以启动时一定要指定。
如果你在Windows上第一次跑,大概率会遇到防火墙弹窗询问是否允许访问,这个要勾选允许,否则局域网其他机器访问不到。启动成功之后,命令行会输出几行信息,其中包括API地址、控制台地址
