Windows 本地部署 MinIO 对象存储服务
MinIO 是一款基于 Apache License v2.0 开源协议的对象存储服务,兼容 Amazon S3 云存储接口。它非常适合用于存储海量非结构化数据,如图片、视频或日志文件。本教程将演示如何在 Windows 系统上搭建本地 MinIO 服务,适用于开发测试及小型项目部署场景。
下载与准备
获取安装包
访问 MinIO 官网下载对应版本:
根据操作系统选择 MinIO Server/AIStor Server 和 MinIO Client/AIStor Client。建议优先使用中文官网,下载速度通常更快。
注意:两版官网域名不同,但下载文件一致。Server 端是核心程序,Client 端(mc.exe)可选,仅在需要命令行管理时下载。
目录规划
在 D 盘创建 Minio 文件夹,并在其下建立三个子目录:
bin:存放可执行文件(minio.exe、mc.exe)data:存储实际数据logs:存放运行日志
将下载的 minio.exe 放入 D:\Minio\bin 目录下即可。

配置环境变量
启动前需设置管理员账号和密码。MinIO 要求密码长度至少 8 位。
方式一:临时生效(推荐调试用)
在当前终端会话中有效,关闭即失效:
set MINIO_ROOT_USER=minioadmin
set MINIO_ROOT_PASSWORD=minioadmin
方式二:永久生效
通过系统环境变量设置,重启后依然有效:
setx MINIO_ROOT_USER minioadmin
setx MINIO_ROOT_PASSWORD minioadmin
提示:若仅需临时修改,建议使用
set;若希望长期固定,使用setx。注意setx命令需在管理员权限的 CMD 中运行以确保生效。
启动服务
方法一:命令行直接启动
切换到 bin 目录并执行启动命令:
cd /d D:\Minio\bin
minio.exe server D:\Minio\data --console-address "127.0.0.1:9001" --address "127.0.0.1:9000"
参数说明:
D:\Minio\data:数据持久化路径--console-address:Web UI 控制台端口(默认 9001)--address:API 服务端口(默认 9000)
启动后请勿关闭终端窗口,否则服务会中断。

方法二:批处理脚本一键启动
为了方便管理,可以创建一个 .bat 脚本。内容如下:
@echo off
set MINIO_ROOT_USER=minioadmin
set MINIO_ROOT_PASSWORD=minioadmin
minio.exe server D:\Minio\data --console-address ":9001" --address ":9000" > D:\Minio\logs\minio.log 2>&1
脚本逻辑解析:
@echo off:隐藏命令回显,让输出更简洁。set ...:在脚本运行时临时设置环境变量,无需全局配置。minio.exe server ...:启动核心服务。> ... 2>&1:将标准输出和错误日志统一重定向到minio.log文件中,方便排查问题。
双击运行该脚本即可后台启动服务,日志会自动保存至 logs 目录。
访问 Web 控制台
服务启动成功后,打开浏览器访问:
- 地址:
http://localhost:9001 - 用户名:
minioadmin(或你设置的自定义值) - 密码:
minioadmin(或你设置的自定义值)
首次登录后可进入主页面进行桶(Bucket)管理和用户配置。

常见问题与建议
- 端口占用:如果 9000 或 9001 端口被占用,请修改
--address和--console-address参数为其他可用端口。 - 防火墙:确保 Windows 防火墙允许相应端口的入站连接,否则外部无法访问。
- 日志查看:若启动异常,检查
D:\Minio\logs\minio.log中的报错信息。
通过以上步骤,你就可以在 Windows 上快速拥有一个可用的 MinIO 对象存储服务了。后续结合 mc 客户端或代码 SDK,即可轻松实现文件上传下载功能。

