MinIO教程（一）| MinIO的安装（Windows）

MinIO教程（一）| MinIO的安装（Windows）

• [一、MinIO 是什么？](#一、MinIO 是什么？)
• [二、MinIO 的核心定位：不止是 "文件服务器"](#二、MinIO 的核心定位：不止是 “文件服务器”)
• [三、MinIO 的核心特性（为什么适合当文件服务器？）](#三、MinIO 的核心特性（为什么适合当文件服务器？）)
• [四、MinIO 适用场景界定](#四、MinIO 适用场景界定)
• [五、MinIO 与主流存储方案的对比分析](#五、MinIO 与主流存储方案的对比分析)
• [六、Windows 环境下 MinIO 部署与配置](#六、Windows 环境下 MinIO 部署与配置)
• • [1. 下载 MinIO](#1. 下载 MinIO)
  • [2. 启动 MinIO](#2. 启动 MinIO)
  • [3. 汉化操作](#3. 汉化操作)
  • [4. MinIO 核心概念解析](#4. MinIO 核心概念解析)
  • [5. MinIO 基础操作指南（Web 控制台）](#5. MinIO 基础操作指南（Web 控制台）)
  • [6. MinIO 高级操作指南（mc命令行工具）](#6. MinIO 高级操作指南（mc命令行工具）)

一、MinIO 是什么？

MinIO 采用 Go 语言开发，是一款高性能、兼容 S3 协议的分布式对象存储系统，常被用作文件服务器，专门存储图片、视频、文档等 "非结构化数据"（没法存进数据库的文件类数据）。

二、MinIO 的核心定位：不止是 "文件服务器"

• 本质是 对象存储：和传统的 FTP 服务器、本地磁盘存储不同，MinIO 以 "对象" 为单位存储文件（每个对象包含文件数据 + 元数据，如文件名、大小、创建时间），而非按文件夹层级的文件系统。
• 天生适配文件服务器场景：因为支持海量文件存储、高并发上传下载，且能分布式部署，所以常被用来替代传统文件服务器，承接 Web 应用的文件存储需求。

三、MinIO 的核心特性（为什么适合当文件服务器？）

• 轻量易部署：单节点部署只需一个 JAR 包或二进制文件，无需复杂依赖；分布式部署也只需多台服务器配置集群，支持动态扩容。
• 兼容 S3 协议：这是核心优势！AWS S3 是对象存储的行业标准，MinIO 完全兼容其 API，意味着你写的代码能轻松迁移到 S3，或同时对接多个兼容 S3 的存储服务。
• 高性能：专门优化了大文件、高并发场景，支持 GB/TB 级文件快速上传下载，读写速度远超传统文件服务器。
• 高可用：分布式模式下支持纠删码（Erasure Code），比如 10 台服务器组成集群，哪怕坏了 3 台，数据也不会丢，还能正常访问（类似 RAID 但更灵活）。
• 支持分片与合并：虽然没有内置分片上传 API，但提供了 composeObject 接口，能轻松实现分片合并，完美适配大文件上传 + 断点续传场景。

四、MinIO 适用场景界定

1. 私有化部署场景：企业对数据私密性要求较高（如合同文档、内部研发资料），需将数据存储在自有服务器集群，MinIO 可通过分布式部署实现数据本地化管控。

2. 业务数据存储场景：电商平台商品图片、社交 APP 用户头像、教育平台课程视频等非结构化数据存储，MinIO 支持高并发读写，适配业务流量波动。

3. 开发测试场景：开发者需快速搭建轻量化存储服务用于功能测试，MinIO 单机部署仅需 1 个可执行文件，5 分钟内即可完成环境搭建。

4. 数据备份场景：企业核心业务数据需异地备份，MinIO 支持跨节点数据同步与多副本存储，保障数据冗余安全。

五、MinIO 与主流存储方案的对比分析

• MinIO的独特优势：在分布式存储领域中，是唯一能同时满足"轻量部署、S3兼容、低硬件成本、云原生适配"的方案，尤其在云原生 和大文件高并发场景中，无其他方案可替代。
• 其他方案核心壁垒：本地存储胜在"零成本零门槛"，NAS胜在"跨终端协作便捷性"，公有云对象存储胜在"零运维与全球分发"，分布式文件系统胜在"传统文件接口与分布式能力的结合"。

方案类型	突出差异化特点（独有的/显著优于其他方案）	适用场景
MinIO（分布式对象存储）	1. 轻量极致：单机部署仅需单个二进制文件，集群部署无复杂依赖； 2. S3协议完美兼容：无缝对接AWS生态，迁移成本趋近于零； 3. 纠删码轻量化实现：同等冗余级别下硬件成本低30%+； 4. 云原生无缝适配：Docker/K8s一键部署，支持动态扩缩容	1. 云原生/容器化环境下的文件存储（唯一轻量分布式选择 ）； 2. 需私有部署 且追求低硬件成本的分布式存储场景； 3. 需对接S3生态 或未来可能迁移至AWS的业务； 4. 大文件（GB/TB级）高并发上传下载场景（性能碾压其他方案）
本地存储（DAS架构）	1. 零门槛部署：无需额外配置，直接复用服务器本地硬盘； 2. 无网络开销：文件读写延迟极低，仅受硬盘IO限制； 3. 成本趋近于零：无需额外采购硬件/软件	1. 开发/测试环境临时文件存储 （最快上手无成本）； 2. 单机版应用本地数据存储 （如小型工具类软件）； 3. 非核心业务的日志、缓存等临时数据存储
NAS（网络附加存储）	1. 开箱即用：专用硬件+预制系统，通电配置即可提供文件共享； 2. 多终端跨系统兼容：完美支持Windows/Mac/Linux/移动端，共享无壁垒； 3. 一体化文件管理：内置权限管控、版本快照、增量备份，无需额外工具	1. 企业内部团队办公文件协作 （如文档、设计稿，协作体验最优）； 2. 家庭/小型办公多媒体集中存储 （照片、视频、音乐）； 3. 中小型企业固定容量的文件归档与共享（无需专业运维）
公有云对象存储（如华为云OBS、AWS S3）	1. 零运维负担：硬件维护、容灾备份、安全防护全由厂商负责； 2. 无限弹性扩容：存储容量随用量自动增长，无需规划硬件； 3. 增值服务丰富：自带CDN加速、内容审核、跨区域复制	1. 无专业IT运维团队的中小企业 （彻底免除运维成本）； 2. 流量波动大 （如电商大促、活动推广）的文件存储； 3. 需全球访问的内容分发场景（如跨境APP资源存储，全球节点覆盖最优）
分布式文件系统（如Ceph FS、GlusterFS）	1. 统一存储池：整合多品牌、多规格服务器存储资源，单一访问入口； 2. POSIX接口兼容：保留传统文件系统操作习惯，无需修改现有应用代码； 3. 极致扩展性：性能与容量随节点线性提升，支持PB级存储	1. 大型企业数据中心统一存储平台 （多资源整合能力最优）； 2. 大数据分析/AI训练 场景（需标准文件系统接口访问海量数据）； 3. 需保留复杂目录结构的分布式存储场景（唯一兼顾分布式与目录结构的方案）

六、Windows 环境下 MinIO 部署与配置

1. 下载 MinIO

硬件要求：Windows 7 及以上 64 位系统，建议 CPU 2 核及以上、内存 4GB 及以上，存储盘预留至少 10GB 可用空间（用于存储服务数据）。

软件下载：（推荐方式二）

• 方式一：访问 MinIO 官方下载页（https://min.io/download）（太慢了），
  下载核心服务端程序 minio.exe；若需命令行管理工具，可同步下载客户端 mc.exe（可选）。
  
• 方式二：访问 MinIO 国内镜像地址（https://www.minio.org.cn/）（速度飞起）
  下载核心服务端程序 minio.exe；若需命令行管理工具，可同步下载客户端 mc.exe（可选）。
  

2. 启动 MinIO

（1）规划目录

首先在本地磁盘（建议非系统盘，如 D 盘）创建标准化目录结构，用于统一管理程序与数据：

以下是我存放的位置（你们可以根据情况自行更改）

• 主目录：D:\Develop\Env\MinIO（存放部署相关文件）
• 程序目录：D:\Develop\Env\MinIO\bin（存放 minio.exe、mc.exe 等可执行文件）
• 数据目录：D:\Develop\Env\MinIO\data（用于存储 MinIO 管理的对象数据，避免临时目录导致数据丢失）
• 日志目录：D:\Develop\Env\MinIO\logs（用于存储服务启动日志，便于问题排查）

（2）创建启动脚本

创建一个txt文件，然后复制下面的命令（脚本中的位置根据你的存放的位置自行修改），在改成bat后缀

@echo off
:: 切换编码为 UTF-8，避免中文乱码
chcp 65001 > nul
echo 正在启动MinIO服务...
:: 切换至程序目录
cd D:\Develop\Env\MinIO\bin
:: 启动服务，指定数据目录、控制台端口
minio.exe server D:\Develop\Env\MinIO\data --console-address ":9001"
pause

然后放到 和 bin 目录同级别

（3）双击启动

访问 http://127.0.0.1:9001，用户名和密码默认都为 minioadmin

3. 汉化操作

目前没有汉化配置。有的话也是和源码相关的（忒麻烦），所以最快的方式就是浏览器翻译

4. MinIO 核心概念解析

1. 桶（Bucket） ：MinIO 的基本存储单元，用于对对象进行分类管理，类似文件系统中的 "文件夹"，但无层级嵌套限制（可通过对象名中的 "/" 模拟层级）。

   命名规则：3-63 个字符，仅支持小写字母、数字、横线，且不能以横线开头或结尾。

2. 对象（Object） ：MinIO 中存储的核心数据单元，对应实际的文件（如图片、文档），由 "文件内容 + 元数据" 组成。

   元数据包含文件大小、类型、创建时间等基础信息，支持自定义扩展（如给文件添加业务标签）。

3. API 服务端口：默认 9000 端口，用于客户端（如 Spring Boot 应用）通过 SDK 集成 MinIO，实现文件上传、下载等自动化操作。

4. Web 控制台端口：默认 9001 端口，提供可视化管理界面，支持手动创建桶、上传文件、配置权限等操作。

5. MinIO 基础操作指南（Web 控制台）

（1）创建存储桶

登录 Web 控制台后，点击左侧菜单栏 "Create Bucket"。输入桶名称（如 test-123）

你可以看看data下面，就出现了你创建的那个桶了

（2）对象操作---桶下面创建文件夹

前提是你创建文件夹以后，还得再到这个新文件夹里面上传一个资源才行，不然就属于无效

（3）对象操作---桶下面创建文件

你可以看看data下面，就出现了《API命名规范.txt》的这个文件夹

和windows的不一样，windows 就直接是文件了，而它是以文件夹方式的，里面还有一层，这个 xl.meta 才是《API命名规范.txt》的真正的数据

6. MinIO 高级操作指南（mc命令行工具）

MinIO 在 2024 年的版本更新中，对社区版的控制台界面进行了大幅阉割------ 仅保留最基础的 "对象浏览" 功能，图形化的权限配置、用户管理、存储桶高级设置等入口被全部移除。

官方明确要求，这些高级操作需通过 mc命令行工具 或 API 完成，社区用户若需图形化管理需转向其商业产品（如 AiStor）。

这一变化的核心原因是 MinIO 团队以 "简化控制台维护成本" 为由，将社区版的管理功能几乎全部迁移到命令行，本质上是推动用户向商业版付费。

这一块我就不多说了