模块:MINIO

Pigsty 内置了 MinIO 支持,一个本地 S3 对象存储开源替代,可用于 PGSQL 模块冷备份存储。

MinIO 是一个兼容 AWS S3 的多云对象存储软件,使用 AGPLv3 协议开源。

MinIO 可以用来存储文档、图片、视频和备份。Pigsty 原生支持部署各种 MinIO 集群,具备原生多节点多磁盘高可用支持,易于扩展、安全且开箱即用, 并且有过 10PB+ 级别的大规模生产环境部署用例。

MinIO 是 Pigsty 中的一个 可选模块。您可以将 MinIO 用作 PostgreSQL 备份 的可选存储仓库,作为默认本地 POSIX 文件系统仓库的补充。 如果使用 MinIO 备份仓库,MINIO 模块应在任何 PGSQL 模块之前安装。MinIO 需要受信任的 CA 证书才能工作,因此它依赖 NODE 模块。


快速开始

以下是一个最简单的 MinIO 单机单盘部署示例:

# 在配置清单中定义 MinIO 集群
minio: { hosts: { 10.10.10.10: { minio_seq: 1 } }, vars: { minio_cluster: minio } }
./minio.yml -l minio    # 在 minio 分组上部署 MinIO 模块

部署完成后,您可以通过以下方式访问 MinIO:

  • S3 APIhttps://sss.pigsty:9000(使用域名需要配置 DNS 解析)
  • Web 控制台https://<minio-ip>:9001(默认用户名/密码:minioadmin / S3User.MinIO
  • 命令行mcli ls sss/(管理节点上已预配置别名)

部署模式

MinIO 支持三种主要部署模式:

模式说明适用场景
单机单盘 (SNSD)单节点,单个数据目录开发、测试、演示
单机多盘 (SNMD)单节点,多块磁盘资源受限的小规模部署
多机多盘 (MNMD)多节点,每节点多块磁盘生产环境推荐

此外,您还可以使用多池部署来扩容现有集群,或部署多套集群


核心特性

  • S3 兼容:完全兼容 AWS S3 API,可与各种 S3 客户端和工具无缝集成
  • 高可用:原生支持多节点多磁盘部署,容忍节点和磁盘故障
  • 安全:默认启用 HTTPS 加密传输,支持服务端加密
  • 监控:开箱即用的 Grafana 监控面板和 Prometheus 告警规则
  • 易用:预配置的 mcli 客户端别名,一键部署和管理

使用方法

快速上手,如何上手使用 MinIO ?如何可靠地接入 MinIO?如何使用 mc / rclone 客户端工具?

集群配置

根据需求场景选择合适的 MinIO 部署类型,并对外提供可靠的接入。

参数列表

MinIO 模块提供了 21 个相关配置参数,用于定制所需的 MinIO 集群。

预置剧本

如何使用预置的 ansible 剧本来管理 MinIO 集群,常用管理命令速查。

管理预案

MinIO 集群管理 SOP:创建,销毁,扩容,缩容,节点故障与磁盘故障的处理。

监控告警

如何在 Pigsty 中监控 MinIO?如何使用 MinIO 本身的管控面板?有哪些告警规则值得关注?

指标列表

Pigsty MINIO 模块提供的完整监控指标列表与释义

常见问题

Pigsty MINIO 对象存储模块常见问题答疑


最后修改 2026-01-08: init commit (fec99d5)