跳到主要内容

MinIO 使用手册（Windows 快速上手）

本文基于现有命令，整理出在 Windows 上启动 MinIO 服务器、配置 mc 客户端、创建桶并上传数据集的完整步骤。

1. 环境准备​

  • 下载并放置可执行文件：minio.exe（服务器）与 mc.exe（MinIO Client），例如：C:\Minio。
  • 准备数据目录，例如：D:\MinIOData（首次启动时 MinIO 会在此处创建所需结构）。

2. 启动 MinIO 服务器​

设置管理员账户与密码（设置为系统环境变量，适用于后续新开的终端/会话）：

setx MINIO_ROOT_USER "minioadmin"
setx MINIO_ROOT_PASSWORD "minioadmin123"

启动 MinIO 服务（数据目录可按需调整，需先进入存放可执行文件的文件夹）：

minio.exe server D:\MinIOData

提示：setx 只对新打开的终端生效。如果你希望在当前终端立即生效，可临时使用 set（当前会话有效）：

set MINIO_ROOT_USER=minioadmin
set MINIO_ROOT_PASSWORD=minioadmin123

3. 配置 mc 客户端（alias）​

在本机以 http://127.0.0.1:9000 访问 MinIO 服务，使用上一步设置的凭据创建别名 myminio：

mc.exe alias set myminio http://127.0.0.1:9000 minioadmin minioadmin123

如果你的服务器使用的是 MinIO 默认的初始密码（minioadmin/minioadmin），则可改用：

mc.exe alias set myminio http://127.0.0.1:9000 minioadmin minioadmin

添加：连接远程 MinIO 服务（把 <host>、<AccessKey>、<SecretKey> 替换为实际值）：

# 远程（HTTP）示例
mc.exe alias set myminio http://<host>:9000 <AccessKey> <SecretKey>

# 远程（HTTPS）示例
mc.exe alias set myminio https://<host>:9000 <AccessKey> <SecretKey>

注意：确保服务器防火墙和端口开放可达；若使用自签名证书，请将证书加入系统信任，或在必要时为 mc 添加允许不受信证书的选项（根据 mc 版本可能为 --insecure）。

4. 创建桶（Bucket）​

示例：创建名为 yolodata 的桶。

mc.exe mb myminio/yolodata

5. 上传本地数据集​

将本地 D:\yolo_dataset 文件夹递归上传到刚创建的桶中：

mc.exe cp -r D:\yolo_dataset myminio/yolodata

5.1 从桶下载到本地​

将桶内 dataset/images/train 目录递归下载到当前目录下的 train 文件夹：

mc.exe cp --recursive myminio/dataset/images/train ./train

6. 验证与常用检查​

  • 列出桶/对象（可选）：
    • 列出桶：mc.exe ls myminio
    • 列出桶内对象：mc.exe ls myminio/yolodata
  • 浏览器访问服务：在浏览器中访问 http://127.0.0.1:9000，使用你设置的管理员账户登录。

7. 常见问题​

  • 新旧会话：使用 setx 设置的环境变量仅对新开的终端生效；若在同一窗口内立即启动服务，可先使用 set。
  • 端口占用：若 9000 端口被占用，调整服务地址或释放端口；创建 alias 时的地址需与实际服务地址一致。
  • 路径引号：Windows 路径包含空格或特殊字符时，请使用引号包裹（例如："D:\My Data\MinIOData"）。
  • 权限与防火墙：首次运行可能触发防火墙/权限提示，请允许本地网络访问或以管理员身份运行。

8. 删除桶与对象​

  • 非强制删除空桶（安全，桶必须为空，否则会失败）：
mc.exe rb myminio/mybucket
  • 强制删除桶（会先清空再删除，谨慎使用）：
mc.exe rb --force myminio/mybucket
  • 仅删除某路径下对象（示例，按需替换路径）：
mc.exe rm --recursive --force myminio/mybucket/path/

附录：完整命令清单（整理后）​

# 设置管理员账号与密码（对新会话生效）
setx MINIO_ROOT_USER "minioadmin"
setx MINIO_ROOT_PASSWORD "minioadmin123"

# 启动 MinIO 服务器
minio.exe server D:\MinIOData

# 本地 alias（使用自定义口令）
mc.exe alias set myminio http://127.0.0.1:9000 minioadmin minioadmin123

# 本地 alias（使用默认口令）
mc.exe alias set myminio http://127.0.0.1:9000 minioadmin minioadmin

# 远程 alias（HTTP）
mc.exe alias set myminio http://<host>:9000 <AccessKey> <SecretKey>

# 远程 alias（HTTPS）
mc.exe alias set myminio https://<host>:9000 <AccessKey> <SecretKey>

# 创建桶（如果还没创建）
mc.exe mb myminio/yolodata

# 上传本地数据集文件夹
mc.exe cp -r D:\yolo_dataset myminio/yolodata

# 从桶下载到本地（你新增的命令）
mc.exe cp --recursive myminio/dataset/images/train ./train

# 删除空桶（非强制）
mc.exe rb myminio/mybucket

# 强制删除桶（清空后删除）
mc.exe rb --force myminio/mybucket