Windows 本地部署 MinIO 对象存储服务
MinIO 是一款高性能的对象存储系统,兼容 Amazon S3 协议,非常适合用于存储图片、视频等非结构化数据。在开发测试或小型项目场景中,我们常需要在本地快速搭建一个 MinIO 服务。
获取安装包
建议直接访问 MinIO 官网下载对应系统的版本。服务端(Server)和客户端(Client)通常可以分开下载,但核心功能主要依赖服务端程序。
- minio.exe:MinIO 服务端核心程序,必须下载。
- mc.exe:MinIO 命令行客户端工具,可选,主要用于高级管理操作。
提示:优先选择英文官网下载,速度通常更稳定。
规划目录结构
为了保持环境整洁,建议在磁盘根目录下创建一个独立文件夹(例如 D:\Minio),并在其中规划三个子目录:
- bin:存放可执行文件(
minio.exe,mc.exe)。 - data:存储实际的数据文件,MinIO 启动时会将数据写入此处。
- logs:存放运行日志,方便排查问题。
将下载好的 minio.exe 放入 bin 目录即可。
启动服务
MinIO 支持通过命令行直接启动,也可以使用批处理脚本一键启动。两种方式本质相同,后者更适合长期运行。
方式一:命令行启动
打开 Windows 命令提示符(cmd),切换到 bin 目录并执行以下命令:
D:
cd D:\Minio\bin
.
minio.exe server D:\Minio\data --console-address "127.0.0.1:9001" --address "127.0.0.1:9000"
这里有两个关键参数需要注意:
--console-address "127.0.0.1:9001":指定 Web 控制台的访问端口,默认为 9001。--address "127.0.0.1:9000":指定 API 接口调用端口,默认为 9000。
启动后,终端窗口会显示服务运行状态。请勿关闭该窗口,否则服务会中断。
方式二:批处理脚本启动
为了方便管理,我们可以编写一个简单的 .bat 脚本。这不仅能自动设置环境变量,还能将日志重定向到文件。
新建一个文本文件,命名为 start_minio.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_...:设置管理员用户名和密码。注意密码长度至少为 8 位。minio.exe server ...:启动命令,同命令行方式。> ... 2>&1:将标准输出和错误输出都记录到minio.log文件中。
双击运行该脚本即可启动服务,日志会保存在 logs 目录下。
访问 Web 控制台
服务启动成功后,打开浏览器访问:


