2. MinIO 核心概念：对象存储基础、Bucket、Object、Endpoint、Access Key/Secret Key

在深入 MinIO 集群架构之前，必须建立对对象存储模型及其核心概念的清晰认知。MinIO 完全遵循 Amazon S3 兼容的对象存储语义，理解这些基础概念是后续进行服务边界划分与高可用设计的前提。

2.1 对象存储基础模型

与传统文件系统（如 ext4、NTFS）或块存储（如 SAN）不同，对象存储采用扁平化的地址空间。数据不再通过目录树路径定位，而是通过 Bucket + Object Key 的唯一组合进行访问。这种模型天然支持大规模水平扩展，消除了目录深度对性能的影响。

2.2 Bucket（桶）

Bucket 是对象存储中用于容纳对象的逻辑容器，类似于文件系统中的顶级目录，但具有全局唯一的命名约束。在 MinIO 中，Bucket 是权限控制、生命周期管理和存储策略的基本作用域。

2.3 Object（对象）

Object 是对象存储中的基本数据单元，由三部分组成：数据（Data）、元数据（Metadata） 和 唯一标识符（Key）。MinIO 支持任意类型的二进制数据，单个对象最大可达 5TB。

• Data： 文件的实际二进制内容，可以是图片、视频、日志、数据库备份等。
• Metadata： 系统元数据（Content-Type、Content-Length、ETag）和用户自定义元数据（以 x-amz-meta- 为前缀）。
• Key： 对象的唯一标识符，在 Bucket 内唯一。Key 可以包含 / 字符模拟目录结构，但本质仍是扁平寻址。

# 使用 mc 命令上传对象并查看元数据
mc cp report-2025.pdf myminio/data-bucket/

# 查看对象元数据
mc stat myminio/data-bucket/report-2025.pdf

# 输出示例：
# Name      : report-2025.pdf
# Date      : 2025-01-15 10:30:00 UTC
# Size      : 2.4 MiB
# ETag      : "d41d8cd98f00b204e9800998ecf8427e"
# Content-Type : application/pdf

2.4 Endpoint（端点）

Endpoint 是客户端访问 MinIO 服务的网络入口地址。在集群架构中，Endpoint 的设计直接决定了服务边界的划分方式。

2.5 Access Key / Secret Key（访问密钥）

Access Key 和 Secret Key 是 MinIO 的身份凭证，用于 API 请求的签名认证。该机制完全兼容 AWS Signature V4 协议，确保请求的完整性和防篡改。

• Access Key： 用户标识，类似于用户名，长度 20 字符，可公开。
• Secret Key： 签名密钥，类似于密码，长度 40 字符，必须严格保密。
• 根用户： MinIO 启动时创建的第一个用户，拥有全部管理权限。
• IAM 用户： 通过 MinIO IAM 系统创建，可附加细粒度策略。

# 设置环境变量（Linux/macOS）
export MINIO_ROOT_USER=admin
export MINIO_ROOT_PASSWORD=your-secret-key-here

# 启动 MinIO 服务
minio server /data --console-address ":9001"

# 使用 mc 配置访问凭证
mc alias set myminio http://localhost:9000 admin your-secret-key-here

2.6 核心概念关系总结

以下表格梳理了 MinIO 核心概念之间的层次关系与依赖，帮助理解它们在集群架构中的角色定位。