MinIO 简介
MinIO 是一款基于 Apache License v2.0 开源协议的对象存储服务,兼容 Amazon S3 云存储服务接口。它非常适合用于存储海量非结构化数据(如图片、视频、日志文件等)。本教程针对 Windows 系统搭建本地 MinIO 服务,适合开发测试或小型项目部署场景。
下载与准备
访问 MinIO 官网,根据操作系统选择相应的版本,点击 MinIO Server/AIStor Server 和 MinIO Client/AIStor Client 的 Download 按钮下载对应文件。
说明:两版官网域名不同,Server/Client 的文字标题有差异,但下载文件一致;中文官网下载速度通常更快,优先推荐。
minio.exe:MinIO 服务端核心程序(必下载)mc.exe:MinIO 客户端工具(可选,仅在需要可视化界面或命令行管理时下载)
创建目录结构
建议在 D 盘根目录下创建一个名为 Minio 的文件夹,路径为 D:\Minio。在该文件夹内再创建三个子文件夹:
bin:存放 MinIO 可执行文件(minio.exe、mc.exe)data:存储 MinIO 服务的实际数据logs:存储服务运行日志(脚本启动时自动生成)
将下载好的 minio.exe 和 mc.exe 放入 D:\Minio\bin 目录下即可。
环境变量配置
在启动服务前,建议先设置管理员用户名和密码。这里提供两种方案:永久生效的环境变量或临时会话变量。
1. 永久生效(setx)
打开命令提示符,依次执行以下命令(密码长度必须大于 8 个字符):
setx MINIO_ROOT_USER minioadmin
setx MINIO_ROOT_PASSWORD minioadmin
注意:
setx设置的是系统级环境变量,修改后可能需要重启终端窗口才能生效。
2. 临时生效(set)
如果仅需在当前终端窗口生效,关闭即失效,可使用 set 命令:
set MINIO_ROOT_USER=minioadmin
set MINIO_ROOT_PASSWORD=minioadmin
启动服务
切换到 MinIO 的 bin 目录并启动服务。
方式一:命令行直接启动
按 Win+R 输入 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"
其中参数说明如下:
D:\Minio\data:替换为你实际的 data 文件夹路径。--console-address "127.0.0.1:9001":本地 MinIO 控制台前端访问地址,端口 9001 可根据实际情况调整。--address "127.0.0.1:9000":本地 MinIO 服务 API 调用地址,端口 9000 可根据实际情况调整。
启动后请勿关闭终端窗口,否则会导致服务中断。
方式二:批处理脚本一键启动
为了方便管理,可以创建一个 .bat 脚本文件放在 bin 目录下,内容如下:
@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_ROOT_USER/PASSWORD:在脚本运行时临时设置环境变量,优先级高于系统环境变量。minio.exe server ...:启动核心服务,指定数据目录和端口。> D:\Minio\logs\minio.log 2>&1:将标准输出和错误输出重定向到日志文件中,方便排查问题。
双击脚本即可启动服务,同样不要关闭弹出的终端窗口。
访问 Web 控制台
服务启动成功后,在浏览器地址栏输入 http://localhost:9001 即可进入 MinIO 的前端控制台页面。使用之前设置的用户名和密码登录,默认均为 minioadmin。登录后即可进行桶(Bucket)管理、文件上传等操作。


