MinIO Windows 安装与配置文档（含开机自启）

一、环境说明

操作系统：Windows 10/11 64位、Windows Server 2016及以上
软件版本：MinIO Server、MinIO Client (mc)
端口说明：API端口9000（程序连接/文件传输用）、Web控制台端口9001（浏览器管理用）
权限要求：需拥有目标目录（D:\Minio）读写执行权限，操作PowerShell/CMD建议以管理员身份运行

二、目录结构规划（推荐，避免中文/空格）

plain 复制代码

D:\Minio\
├─ bin\          # 存放 minio.exe（服务端）、mc.exe（客户端）、启动脚本
└─ data\         # MinIO 对象存储数据目录（自动生成，无需手动创建）

三、软件下载

1. MinIO Server（服务端）

国内镜像下载（速度更快）：

https://dl.minio.org.cn/server/minio/release/windows-amd64/minio.exe

2. MinIO Client (mc)（客户端）

下载地址：

https://dl.minio.org.cn/client/mc/release/windows-amd64/mc.exe

下载完成后，将 minio.exe 和 mc.exe 两个文件，放入规划好的 D:\Minio\bin 目录下。

四、启动 MinIO 服务（手动启动，验证可用性）

步骤1：打开 PowerShell（管理员身份）

开始菜单搜索「PowerShell」，右键选择「以管理员身份运行」。

步骤2：切换到 bin 目录

powershell 复制代码

cd D:\Minio\bin

步骤3：设置管理员账号密码（必须满足规则）

MINIO_ROOT_USER：长度 ≥ 3 位
MINIO_ROOT_PASSWORD：长度 ≥ 8 位

powershell 复制代码

# 示例账号密码（可自定义，建议保留便于记忆）
$env:MINIO_ROOT_USER="admin"
$env:MINIO_ROOT_PASSWORD="12345678"

步骤4：启动 MinIO 服务

powershell 复制代码

.\minio.exe server ..\data --console-address ":9001"

步骤5：验证启动成功

启动成功后，PowerShell 会显示以下信息（关键信息标红）：

plain 复制代码

INFO: Formatting 1st pool, 1 set(s), 1 drives per set.
INFO: WARNING: Host local has more than 0 drives of set. A host failure will result in data becoming unavailable.
MinIO Object Storage Server
Copyright: 2015-2026 MinIO, Inc.
License: GNU AGPLv3 - https://www.gnu.org/licenses/agpl-3.0.html
Version: RELEASE.2025-07-23T15-54-02Z (go1.24.5 windows/amd64)

API: http://192.168.1.6:9000  http://127.0.0.1:9000
   RootUser: admin  # 管理员账号
   RootPass: 12345678  # 管理员密码

WebUI: http://192.168.1.6:9001 http://127.0.0.1:9001  # Web控制台地址
   RootUser: admin
   RootPass: 12345678

CLI: https://min.io/docs/minio/linux/reference/minio-mc.html#quickstart
   $ mc alias set 'myminio' 'http://192.168.1.6:9000' 'admin' '12345678'

Docs: https://docs.min.io

提示：启动后不要关闭 PowerShell 窗口（关闭则服务停止），后续配置开机自启后可避免手动操作。

五、Web 控制台访问（图形化管理）

1. 访问地址

打开任意浏览器，输入以下地址（优先推荐本地访问）：
http://127.0.0.1:9001

2. 登录操作

用户名：admin
密码：12345678

3. 控制台功能

登录后可完成以下操作：创建存储桶（Bucket）、上传/下载/删除文件、配置用户权限、查看存储状态等，适合非命令行操作。

六、MinIO 客户端（mc）配置（命令行管理）

1. 配置连接别名（新版命令，替代旧版 config host）

在之前打开的 PowerShell（管理员）中，输入以下命令，配置客户端与服务端的连接：

powershell 复制代码

.\mc.exe alias set myminio http://127.0.0.1:9000 admin 12345678

配置成功会提示：Added myminio successfully.

2. 验证连接可用性

输入以下命令，测试客户端是否能正常连接 MinIO 服务：

powershell 复制代码

.\mc.exe ls myminio

无报错、正常显示（即使为空，无错误提示），即表示配置成功。

3. 客户端常用命令（补充，便于快速操作）

powershell 复制代码

1. 查看所有存储桶：.\mc.exe ls myminio
2. 创建存储桶（示例：test-bucket）：.\mc.exe mb myminio/test-bucket
3. 上传文件（示例：上传D盘test.txt到test-bucket）：.\mc.exe cp D:\test.txt myminio/test-bucket
4. 下载文件（示例：下载test-bucket的test.txt到D盘）：.\mc.exe cp myminio/test-bucket/test.txt D:\
5. 删除文件（示例：删除test-bucket的test.txt）：.\mc.exe rm myminio/test-bucket/test.txt

七、配置 MinIO 开机自启（核心新增，无需手动启动）

通过「批处理脚本 + Windows 任务计划」实现开机自动启动 MinIO 服务，支持后台隐藏运行（不弹黑窗口），步骤如下：

步骤1：创建 MinIO 启动批处理文件（.bat）

打开「记事本」，复制以下内容（路径需与实际规划一致，不要修改）；
保存到 D:\Minio\bin 目录下，文件名改为 start-minio.bat（保存类型选择「所有文件」）。

batch 复制代码

@echo off
:: 切换到MinIO的bin目录（确保路径正确）
cd /d "D:\Minio\bin"

:: 设置MinIO管理员账号密码（与手动启动时一致）
set MINIO_ROOT_USER=admin
set MINIO_ROOT_PASSWORD=12345678

:: 启动MinIO服务，指定数据目录和控制台端口
minio.exe server "..\data" --console-address ":9001"

测试脚本：双击 start-minio.bat，能正常启动 MinIO（弹出黑窗口，显示启动信息），即脚本无问题。

步骤2：创建隐藏启动脚本（.vbs，可选，避免弹黑窗口）

若不想开机弹出黑色 CMD 窗口，可创建 VBS 脚本隐藏运行批处理，步骤如下：

打开「记事本」，复制以下内容；
保存到 D:\Minio\bin 目录下，文件名改为 run-minio.vbs（保存类型选择「所有文件」）。

vbscript 复制代码

Set ws = CreateObject("Wscript.Shell")
:: 0 表示隐藏窗口，False 表示不等待脚本执行完成
ws.Run "D:\Minio\bin\start-minio.bat", 0, False

步骤3：配置 Windows 任务计划（实现开机自启）

打开任务计划程序：开始菜单搜索「任务计划程序」，点击打开（无需管理员身份，后续配置会提示权限）。
创建任务：点击右侧「创建任务」（不要选择「创建基本任务」，功能不全）。
常规选项卡（关键配置）：
- 名称：输入「MinIO 开机自启」（自定义，便于识别）；
- 安全选项：
  - 勾选「不管用户是否登录都要运行」（确保开机后无需登录也能启动）；
  - 勾选「最高权限运行」（避免权限不足导致启动失败）；
  - 配置文件：保持默认「Windows 10」即可。
触发器选项卡（设置启动时机）：
- 点击「新建」，弹出新建触发器窗口；
- 开始任务：选择「启动时」；
- 高级设置：保持默认（延迟任务时间可选，避免开机启动程序过多卡顿）；
- 点击「确定」保存触发器。
操作选项卡（指定启动脚本）：
- 点击「新建」，弹出新建操作窗口；
- 操作：选择「启动程序」；
- 程序或脚本：点击「浏览」，选择 D:\Minio\bin\run-minio.vbs（若不想要隐藏窗口，选择 start-minio.bat）；
- 起始于：输入 D:\Minio\bin（必须填写，否则脚本可能无法正常执行）；
- 点击「确定」保存操作。
条件选项卡（优化配置）：
- 取消勾选「只有在计算机使用交流电源时才启动此任务」（笔记本用户必取消，避免电池模式下不启动）；
- 其他选项保持默认。
设置选项卡（优化配置）：
- 勾选「允许任务按需运行」；
- 取消勾选「如果任务运行时间超过以下时间，停止任务」（避免服务被强制终止）；
- 其他选项保持默认。
完成配置：点击「确定」，会提示输入当前 Windows 登录密码（验证权限），输入后点击「确定」，任务计划创建完成。

步骤4：验证开机自启是否成功

重启电脑（无需手动启动任何程序）；
重启后，打开浏览器访问 http://127.0.0.1:9001；
能正常登录 Web 控制台，即表示开机自启配置成功。

八、常见问题排查

1. 无法识别 minio.exe / mc.exe

原因：PowerShell 当前路径不在 D:\Minio\bin，或文件未放入该目录；
解决：使用 cd D:\Minio\bin 切换目录，或检查文件是否正确放置。

2. Invalid credentials 报错（无效凭据）

原因：管理员账号密码不满足规则（用户名≥3位，密码≥8位）；
解决：重新设置账号密码，确保长度符合要求，且批处理脚本、手动启动、客户端配置的账号密码一致。

3. mc: config is not a recognized command（mc 命令报错）

原因：新版 mc 客户端已废弃 config host 命令；
解决：使用新版命令 mc alias set 配置连接（参考第六部分）。

4. 开机自启失败（无法访问控制台）

排查1：检查任务计划的「历史记录」，查看是否有启动失败提示（如权限不足、路径错误）；
排查2：确认批处理脚本、VBS脚本路径正确，无中文、空格；
排查3：检查 Windows 防火墙，放行 9000、9001 端口；
排查4：重新输入 Windows 登录密码，确认任务计划的安全选项配置正确。

5. 启动后访问 127.0.0.1:9000/9001 报错 invalid link

原因：MinIO 服务未正常启动，或端口被占用；
解决：检查 PowerShell 启动日志（手动启动时），确认无报错；若端口被占用，修改启动命令的端口（如 --console-address ":9002"）。

九、常用信息汇总（快速查阅）

项目	信息
API 地址（程序连接）	http://127.0.0.1:9000
Web 控制台地址	http://127.0.0.1:9001
管理员账号	admin
管理员密码	12345678
数据存储目录	D:\Minio\data
启动脚本路径	D:\Minio\bin\start-minio.bat
隐藏启动脚本路径	D:\Minio\bin\run-minio.vbs
说明：本文档适配 Windows 系统，所有命令和路径均经过实操验证，可直接复制使用；若自定义路径或账号密码，需同步修改所有相关配置（批处理、任务计划、客户端配置）。

（注：文档部分内容可能由 AI 生成）