Windows 本地部署 MinIO 对象存储及 WebUI 访问指南

MinIO 是一款基于 Apache License v2.0 开源协议的对象存储服务，兼容 Amazon S3 云存储接口。它非常适合用于存储海量非结构化数据，如图片、视频或日志文件。本教程将演示如何在 Windows 系统上搭建本地 MinIO 服务，适用于开发测试或小型项目场景。

下载与准备

直接访问 MinIO 官网 或 英文官网，选择 MinIO Server/AIStor Server 和 MinIO Client/AIStor Client 的 Download 按钮获取对应版本。

提示：中文官网在国内访问速度通常更快，建议优先使用。

下载后主要包含两个核心文件：

• minio.exe：服务端核心程序（必选）
• mc.exe：客户端管理工具（可选，用于命令行操作）

目录结构规划

为了保持环境整洁，建议在 D 盘创建主文件夹并划分子目录：

1. 在 D:\Minio 下新建三个文件夹：bin、data、logs
   • bin：存放可执行文件（minio.exe、mc.exe）
   • data：存储实际业务数据
   • logs：记录服务运行日志

将下载的 minio.exe 放入 bin 目录下即可。

配置管理员账号

启动前需要设置环境变量来定义登录凭证。MinIO 要求密码长度至少 8 位。

方式一：临时生效（推荐调试用）

直接在当前终端窗口输入以下命令，关闭终端即失效：

set MINIO_ROOT_USER=minioadmin
set MINIO_ROOT_PASSWORD=minioadmin

方式二：永久生效

若希望重启电脑后依然有效，使用 setx 命令：

setx MINIO_ROOT_USER minioadmin
setx MINIO_ROOT_PASSWORD minioadmin

注意：修改环境变量后可能需要重新打开终端窗口才能生效。

启动服务

切换到 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 "127.0.0.1:9001"：Web UI 控制台端口
• --address "127.0.0.1:9000"：API 服务端口

启动成功后请勿关闭终端窗口，否则服务会中断。

脚本一键启动

为了方便管理，可以创建一个批处理脚本（例如 start.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 ...：在脚本内部临时设置环境变量
• > D:\Minio\logs\minio.log 2>&1：将标准输出和错误信息统一写入日志文件，避免刷屏

双击运行该脚本即可启动服务，日志会保存在 logs 目录下。

访问 Web 控制台

浏览器地址栏输入 http://localhost:9001 即可进入管理页面。默认用户名和密码为之前设置的 minioadmin。

登录后即可看到仪表盘，开始创建桶（Bucket）和管理对象。