分类: 参考

PGSQL 是 Pigsty 的核心模块：通过 Ansible 清单声明 PostgreSQL 集群，以 Patroni 与 etcd 提供高可用编排，以 pgBackRest 提供备份/PITR，并通过 HAProxy、VIP、DNS、PgBouncer 与完整可观测性栈提供数据库服务。 本页按 Pigsty v4.5.0 源码组织入口。具体默认值只在 参数参考 中维护，避免在模块首页复制一份会漂移的参数快照。 建模与配置 集群模型：集群、实例、身份与角色。 架构：Patroni、etcd、服 …

Pigsty v5.0 文档聚焦 Pigsty 自身：架构、安装、部署、配置、运维，以及每个正式模块的完整手册。 v5.0 文档预览 OINK 0.6.0 本地优先 按 ⌘+ 加 K（macOS）或 Ctrl+ 加 K 可随时打开离线搜索与命令面板。 开始使用 认识 Pigsty 了解功能、架构、设计理念、适用场景与项目背景。 功能特性 · 核心概念 · 系统架构 · 高可用 · 备份恢复 快速上手 从一台全新的 Linux 主机开始，完成配置与首次部署。 安装 · 配置 · 执行剧本 · 离线 …

在 Pigsty 中，您可以使用不同 “风味” 的 PostgreSQL 分支替换 “原生 PG 内核”，实现特殊的功能与效果。 Pigsty 支持多种 PostgreSQL 内核和兼容分支，让您能够在同一套运维体系中获得兼容性、多主复制、图查询、MPP 数仓、透明加密等不同能力。 需要注意的是，不同内核在 Pigsty 中的交付深度并不完全一致： 像 PostgreSQL、Citus、Babelfish、IvorySQL、PolarDB、AgensGraph、pgEdge 已经有较明确的模板与 …

当前 MYSQL 模块是什么成熟度？ Pilot 试点模块，定位「简单、廉价、够用」的 MySQL 集群。部署收敛、高可用切换、每日备份、监控告警四大核心能力经过系统性实测（含故障注入与完全停机演练）；恢复类破坏性流程刻意保留为手工操作并配有 操作手册。不追求与 PGSQL 模块同级的完备度：没有 PITR、没有接入层 VIP/DNS、没有自动扩缩容。用于严肃生产环境前，请按业务要求验证并演练恢复流程。 为什么固定 MySQL 8.4，不能选版本？ MYSQL 是「固定平台」而不是通用安装器 …

MYSQL 模块的指标来自 mysqld_exporter（原始指标，mysql_ 前缀）与 vmalert 衍生规则（mysql:ins:* / mysql:cls:*）。Dashboard 与告警优先建立在衍生指标之上，本页是衍生指标的完整字典。 公共标签 所有指标携带 job=mysql 与身份标签 cls / ins / ip / topology（取值 standalone 或 innodb_cluster）。实例级衍生指标保留全部身份标签，集群级指标聚合到 cls + …

MYSQL 模块复用 Pigsty 的可观测性基座：指标经 mysqld_exporter 进入 VictoriaMetrics，错误日志经 Journald/Vector 进入 VictoriaLogs，Grafana 提供 5 个预置 Dashboard，vmalert 加载 68 条衍生规则与 27 条告警规则。 采集架构 每个 MySQL 节点运行一个 mysqld_exporter（端口 9104），以最小权限监控账号（dbuser_monitor@'127.0.0.1'）采集服务器与 …

MYSQL 模块提供两个剧本：mysql.yml 负责部署与收敛，mysql-rm.yml 负责受保护的退役与下线。前者重复执行会向声明状态收敛；后者是独立的生命周期操作，每次真实执行前都必须重新核对范围、备份与精确确认值。 mysql.yml 对选中集群执行「检查 → 安装 → 引导 → 接入 → 业务对象 → 备份 → 监控」的完整收敛： ./mysql.yml -l my-test --check # 预检：校验声明与现场，不做变更 ./mysql.yml -l my-test # 收敛一 …

本页覆盖 MYSQL 模块的日常运维操作。总原则：声明状态改清单，收敛现场跑剧本——成员掉线、AdminAPI 状态漂移等多数异常，重跑一次 ./mysql.yml -l <集群> 即可自愈；只有三类破坏性场景（替换成员、恢复备份、完全停机恢复）需要按本页手册人工介入。 速查手册 操作 命令 部署 / 收敛集群 ./mysql.yml -l <集群> 预检（不改现场） ./mysql.yml -l <集群> --check 本机 root 会话 mysql …

MYSQL 部署角色刻意只公开 11 项参数，移除角色另有 2 项受保护运维参数。软件版本、端口、目录、字符集、TLS 路径与定时器表达式由角色统一固定，内存基线按节点规格推导；需要调整服务器行为时使用 mysql_parameters。 参数概览 参数 层级 默认值 说明 mysql_cluster 集群 必填 集群名与身份 mysql_seq 实例 必填 单机 1；HA 连续 1..3 mysql_root_password 集群 DBUser.Root 本地 root 密码 …

MYSQL 模块通过清单（Inventory）声明集群，mysql.yml 将现场收敛到声明状态。本页介绍拓扑规划与全部配置项的写法；参数细节见 参数参考。 部署前检查 目标节点已完成 NODE 纳管，共享 CA 已安装到 /etc/pki/ca.crt（由 node_ca 负责，MySQL 角色只签发叶证书）； 软件仓库包含 mysql 模块：node_repo_modules: node,infra,mysql，或本地仓库已缓存 repo_extra_packages: [mysql]； 平 …

MySQL 是世界上最流行的开源关系型数据库之一。Pigsty 的 MYSQL 模块在纳管节点上部署固定的 原生 MySQL 8.4 LTS 平台：单机实例，或基于 Group Replication 的三节点单主 InnoDB Cluster，并统一管理 TLS、备份、监控与生命周期。 当前状态：Pilot 试点模块 MYSQL 是补充性的试点模块，定位是「简单、廉价、够用」的 MySQL 集群，不追求与 PGSQL 模块同级的完备性。 核心能力（部署收敛、高可用切换、每日备份、监控告警）已经 …

当前 KAFKA 模块是什么成熟度？ 当前角色已实现生产级 v1 基线：动态 KRaft、完整集群护栏、冷启动/修复、Broker 串行准入与 Controller 动态加入、成员退役（含死节点）、故障节点三步替换、严格滚动、TLS/SCRAM/ACL、Topic/User 声明式收敛、内部凭据/证书轮换以及完整监控链路。 它不是托管 Kafka 产品。生产仍需使用 kafka_security: scram、奇数 Controller、足够 Broker/RF/minISR，并补充容量规划 …

KAFKA 模块使用两类指标源，都注册在同一 job=kafka 采集任务下：JMX 目标（带 role 标签）采集每个 JVM 的内部状态；协议 Exporter 目标（无 role 标签）通过 Kafka 协议采集逻辑集群、Topic、Partition 与 Consumer Group 状态。协议 Exporter 只放在 kafka_seq 最小的至多两个 Broker-capable 节点上，单 Broker 集群只运行一个。 JMX 配置采用白名单，只导出 JVM 基线和有界的 …

Pigsty 为 KAFKA 模块提供指标、日志、Dashboard 与告警一体化的可观测能力。监控同时覆盖 Kafka JVM 内部状态与 Kafka 协议视角，避免只看到进程存活而看不到 Partition、ISR 与 Consumer Lag，也避免只看到集群元数据而看不到 JVM、请求队列与 KRaft Controller 健康。 采集架构 KAFKA 模块使用两个互补的 Exporter： 采集面 服务/方式 Job 节点范围 主要内容 JVM 与 Kafka 内部 JMX …

KAFKA 角色刻意只公开 15 项持久参数。拓扑、Listener、安全实现、存储子目录、复制安全与 Exporter 放置等细节由角色统一推导，不能作为额外持久变量覆盖。 参数概览 参数 层级 默认值 说明 kafka_cluster 集群 必填 Kafka 集群身份 kafka_seq 实例 必填 集群内唯一 KRaft node.id kafka_role 实例 combined combined、broker 或 controller kafka_cluster_id 集群 未设置 接 …

KAFKA 模块使用 15 项持久公开参数表达集群意图，其余拓扑、监听器、存储子目录、复制安全、授权与 Exporter 放置由角色统一推导。首次部署建议先完成 快速上手；完整字段见 参数参考。 先规划，后格式化 kafka_seq 会写入 KRaft node.id；新集群的随机 Cluster ID、初始 Controller Identity、安全模式与初始复制策略会写入 Bootstrap Manifest。存储格式化后，不要随意修改身份、安全模式或 Controller 集合。角色会验 …

Kafka 是一个分布式事件流平台。Pigsty 的 KAFKA 模块使用 RPM/DEB 软件包，在纳管节点上部署 Apache Kafka 4.1+ 动态 KRaft 集群，并统一管理安全、资源、生命周期与可观测性。 当前状态：Beta 模块 当前 Kafka 模块处于 Beta 状态。用于严肃生产环境前请务必充分测试，确保满足业务需求。 包括动态 KRaft、严格滚动、TLS/SCRAM/ACL、声明式 Topic/User、凭据与证书轮换，以及完整监控链路。 模块能力 KAFKA 模块当 …

VIBE 模块提供一套 浏览器化开发环境，包含 Code-Server、JupyterLab、Node.js、Claude Code 与 Codex CLI， 并可与 JUICE 共享存储和 PGSQL 数据库能力配合使用。 VIBE 依赖 NODE 与 INFRA： NODE 负责基础软件与 Python uv 环境 INFRA 提供 Nginx 反向代理、Grafana 等可视化入口 组件一览 组件 说明 本地端口 访问路径 Code-Server VS Code 浏览器版 8443 …

端口冲突怎么办？ 同一节点上的多个实例必须使用不同的 port。示例： juice_instances: fs1: path: /fs1 meta: postgres://... port: 9567 fs2: path: /fs2 meta: postgres://... port: 9568 为什么 data 变更不生效？ data 仅用于 juicefs format --no-update，文件系统创建后不会再更新。 如需切换后端，请手动迁移与重新格式化。 如何添加新实例？ 在配置中新 …

JuiceFS 实例通过 juicefs mount --metrics 暴露 Prometheus 指标。 在 JUICE 模块中，指标监听地址为 0.0.0.0:<port>，默认端口 9567。 监控架构 JuiceFS Mount (metrics: 0.0.0.0:<port>) ↓ VictoriaMetrics (scrape) ↓ Grafana Dashboard 若已部署 INFRA，juice_register 会自动写入抓取目标： …

JUICE 模块参数共 2 项： juice_cache：共享缓存目录 juice_instances：实例定义字典 参数概览 参数 类型 级别 说明 juice_cache path C JuiceFS 共享缓存目录 juice_instances dict I JuiceFS 实例定义字典（可为空） 级别说明：C 为集群级别，I 为实例级别。 默认参数 参数定义于 roles/juice/defaults/main.yml： …

概念与实现 JuiceFS 由 元数据引擎 与 数据存储 两部分组成。 当前版本中，meta 会原样透传给 juicefs 作为元数据引擎 URL，生产场景通常使用 PostgreSQL。 数据存储通过 data 参数传入 juicefs format 选项决定。 JUICE 模块执行逻辑与关键命令： # 格式化（仅首次创建有效） juicefs format --no-update <data> "<meta>" "<name>" # 挂载 juicefs mount …

JuiceFS 是一款高性能、POSIX 兼容的分布式文件系统，可以将对象存储/数据库挂载为本地文件系统。 JUICE 模块依赖 NODE 的基础设施与软件仓库，通常使用 PGSQL 作为元数据引擎。 数据存储可以使用 PostgreSQL（数据写入 jfs_blob 表），或 MINIO 模块提供的 Silo / S3 等对象存储。监控集成依赖 INFRA 的 VictoriaMetrics。 flowchart LR subgraph Client["应用/用户"] app["POSIX 访 …

谁能执行Docker命令？ 默认情况下，Pigsty 会将当前远程节点执行剧本的管理用户（即目标节点上 ssh 远程登陆的用户），以及参数 node_admin_username 中指定的管理用户加入到 Docker 操作系统用户组中。 在这个用户组（docker）中的所有用户，可以使用 docker CLI 命令对 Docker 发起管理。 如果你想让其他用户也可以执行 Docker 命令，可以将该操作系统用户加入到 docker 组中： usermod -aG docker …

本页快照记录 DOCKER 模块的 123 类监控指标；实际运行时的指标集合会随软件包版本、启用的采集器和目标状态变化。 Metric Name Type Labels Description builder_builds_failed_total counter ip, cls, reason, ins, job, instance Number of failed image builds builder_builds_triggered_total counter ip, cls, …

DOCKER 模块提供了 8 个配置参数。 参数概览 DOCKER 参数组用于 Docker 容器引擎的部署与配置，包括启用开关、数据目录、存储驱动、镜像加速以及监控。 参数 类型 级别 说明 docker_enabled bool G/C/I 在当前节点上启用 Docker？默认不启用 docker_data path G/C/I Docker 数据目录，默认为 /data/docker docker_storage_driver enum G/C/I Docker 存储驱动，默认为 …

Pigsty 内置了 Docker 支持，您可以用它来快速部署容器化的应用软件。 上手 Docker 是一个 可选模块。在 Pigsty 中，Docker 是否安装由节点上的 docker_enabled 控制，默认不启用。 docker-ce 上游仓库归属于 infra 模块。若你需要在离线仓库中显式加入 Docker 包，可通过 repo_extra_packages 指定 docker 包别名（映射为 docker-ce 与 docker-compose-plugin）。 …

Docker 是最流行的容器化平台，提供了标准化的软件交付能力。 Pigsty 本身并不依赖 Docker 部署任何组件，相反，它提供了部署安装 Docker 的能力，这是一个 可选模块。 Pigsty 提供一系列 Docker 软件/工具/应用模板，供您按需选用。 这允许用户快速拉起各种容器化的无状态软件工具模板，加装各种功能。 您可以使用外部由 Pigsty 托管的高可用数据库集群，将无状态的应用放入容器之中。 在执行 configure 时，Pigsty 会根据 region（如中国大陆网 …

Redis移除失败：ABORT due to redis_safeguard enabled 这意味着正准备移除的 Redis 实例打开了防误删保险：当 redis_safeguard 设置为 true 时，redis-rm.yml 会无条件拒绝执行。 该开关不会探测实例是否正在运行。 确认精确的 -l/redis_port 目标、近期备份以及 redis_rm_data 的取值后，通过 -e redis_safeguard=false 覆盖保护并执行移除。该参数只解除保险，不会替您验证目标或 …

本页快照记录 REDIS 模块的 275 类监控指标；实际运行时的指标集合会随软件包版本、启用的采集器和目标状态变化。 Metric Name Type Labels Description ALERTS Unknown cls, ip, level, severity, instance, category, ins, alertname, job, alertstate N/A ALERTS_FOR_STATE Unknown cls, ip, level, severity, …

监控面板 REDIS 模块提供了 3 个监控面板 Redis Overview：redis 集群概览 Redis Cluster：redis 集群详情 Redis Instance：redis 实例详情 监控 Pigsty 提供了三个与 REDIS 模块有关的监控仪表盘： Redis Overview Redis Overview：关于所有 Redis 集群/实例的详细信息 Redis Cluster Redis Cluster：关于单个 Redis 集群的详细信息 Redis Cluster …

REDIS 模块的参数列表，共有 22 个参数，分为两个部分： REDIS：19 个参数，用于 Redis/Valkey 集群的部署与配置 REDIS_REMOVE：3 个参数，控制 Redis 集群的移除 架构变化：Pigsty v3.6+ 自 Pigsty v3.6 起，redis.yml 剧本不再包含移除功能，移除相关参数已迁移至独立的 redis_remove 角色和 redis-rm.yml 剧本。 参数概览 REDIS 参数组用于 Redis 集群的部署与配置，包括身份标识、实例定义 …

概念 Redis 的实体概念模型与 PostgreSQL 几乎相同，同样包括 集群（Cluster） 与 实例（Instance） 的概念。注意这里的 Cluster 指的不是 Redis 原生集群方案中的集群。 REDIS 模块与 PGSQL 模块核心的区别在于，Redis 通常采用 单机多实例 部署，而不是 PostgreSQL 的 1:1 部署：一个物理/虚拟机节点上通常会部署 多个 Redis 实例，以充分利用多核 CPU。因此 配置 和 管理 Redis 实例的方式与 PGSQL 稍 …

REDIS 是 Pigsty 的 Redis 兼容缓存模块。您可以通过 redis_type 选择 Redis 或 Valkey，默认仍为 redis。 两种引擎都支持主从复制、Sentinel 与原生集群模式，并复用相同的配置路径、实例服务名、监控和日志入口。 redis_type: redis # 默认；也可设置为 valkey 角色会安装所选引擎与 redis-exporter，实例进程分别使用 redis-server / redis-cli 或 valkey-server / …

MINIO 模块默认部署哪个引擎？ v4.5.0 当前源码部署并且只部署 Silo，minio_type 唯一合法值是 silo。MINIO 是兼容模块名，不表示运行 MinIO 服务端。 新建集群建议显式写出 minio_type: silo。 minio_type: minio 与 minio_type: rustfs 都会在身份检查阶段失败。 外部 MinIO、RustFS 或其他 S3 服务仍可作为 pgBackRest 仓库，但不由当前 MINIO 角色管理。 升级由旧版本管理的 …

MINIO 模块通过 /minio/metrics/v3 采集 Silo 指标。指标集合会随服务端版本和实际启用功能变化，因此本页列出当前仪表盘与告警依赖的稳定接口，不把某个版本的完整抓取快照当作长期契约。 稳定身份标签 所有对象存储目标都使用以下 Pigsty 标签： 标签 含义 示例 job 固定模块命名空间 minio flavor 实际后端 silo cls minio_cluster 集群标识 minio ins <minio_cluster>-<minio_seq> 实例标识 …

管理界面 Silo 默认通过 minio_admin_port（9001）提供管理界面，可直接访问 https://<node-ip>:9001。 部分配置模板还会通过 m.pigsty 暴露管理入口。登录凭证由 minio_access_key 与 minio_secret_key 指定。 HTTPS 与证书信任 对象存储默认使用 Pigsty CA 签发的 HTTPS 证书。浏览器和容器客户端必须信任该 CA；生产环境不要以忽略证书校验代替正确配置证书信任。 采集链路 Silo 沿用 …

MINIO 模块共有 22 个公开参数，分为两个部分： MINIO：19 个参数，用于部署 Silo 对象存储集群 MINIO_REMOVE：3 个参数，控制对象存储集群的移除 架构变化：Pigsty v3.6+ 自 Pigsty v3.6 起，minio.yml 剧本不再包含移除功能，移除相关参数已迁移至独立的 minio_remove 角色和 minio-rm.yml 剧本。 参数概览 MINIO 参数组用于配置 Silo 对象存储集群，包括身份、存储路径、端口、认证凭据以及存储桶和用户置备 …

在部署 MINIO 模块之前，需要在 配置清单 中定义 Silo 对象存储集群。当前角色要求 minio_type: silo，支持以下清单部署模式： 单机单盘：SNSD：单机单盘模式，可以使用任意目录作为数据盘，仅作为开发、测试、演示使用。 单机多盘：SNMD：折中模式，在单台服务器上使用多块磁盘 (>=2)，仅当资源极为有限时使用。 多机单盘：MNSD：多台服务器各使用一个独立数据盘，提供紧凑的节点级高可用能力。 多机多盘：MNMD：多机多盘模式，标准生产环境部署，具有最好的可靠性，但需要多 …

当您 配置 并执行 剧本 部署 Silo 后，可以参考本页通过 S3 与 mcli 兼容接口使用它。 部署集群 首先在 配置清单 中定义单机单盘对象存储集群，并显式锁定引擎： minio: { hosts: { 10.10.10.10: { minio_seq: 1 } }, vars: { minio_cluster: minio, minio_type: silo } } 然后，针对定义的分组（这里为 minio）执行 Pigsty 提供的 minio.yml 剧本即可： …

MINIO 是 Pigsty 中 S3 兼容对象存储的兼容模块名。当前角色部署 Silo，并且 minio_type 只接受 silo。 Silo 沿用 MinIO 的 S3/Admin API、MINIO_* 环境变量、磁盘格式与 mcli 客户端接口，可用作 PostgreSQL pgBackRest 备份仓库。模块名、参数前缀和监控 job 继续使用 MINIO / minio_*，以保持现有清单和运维入口兼容。 重要 minio 与 rustfs 不再是有效的 minio_type，会在 …

etcd集群起什么作用？ etcd 是一个分布式的、可靠的键-值存储，用于存放系统中最为关键的数据，Pigsty 使用 etcd 作为 Patroni 的 DCS（分布式配置存储）服务，用于存储 PostgreSQL 集群的高可用状态信息。 Patroni 将通过 etcd，实现集群故障检测、自动故障转移、主从切换，集群配置管理等功能。 etcd 对 PostgreSQL 集群的高可用至关重要；其自身的可用性取决于多数派成员持续可达。生产环境通常把成员分散到独立故障域，并采用 3 或 5 个投 …

本页快照记录 ETCD 模块的 177 类监控指标；实际运行时的指标集合会随软件包版本、启用的采集器和目标状态变化。 Metric Name Type Labels Description etcd:ins:backend_commit_rt_p95_5m Unknown cls, ins, instance, job, ip N/A etcd:ins:wal_fsync_rt_p95_5m Unknown cls, ins, instance, job, ip N/A …

监控面板 ETCD 模块提供了一个监控面板：Etcd Overview。 ETCD Overview Dashboard ETCD Overview：ETCD 集群概览 这个监控面板提供了 ETCD 状态的关键信息：最值得关注的是 ETCD Aliveness，它显示了 ETCD 集群整体的服务状态。 红色的条带标识着实例不可用的时间段，而底下蓝灰色的条带标识着整个集群处于不可用的时间段。 告警规则 Pigsty 针对 Etcd 提供了以下五条预置告警规则，定义于 …

ETCD 模块的参数列表，共有 13 个参数，分为两个部分： ETCD：10 个参数，用于 etcd 集群的部署与配置 ETCD_REMOVE：3 个参数，控制 etcd 集群的移除 架构变化：Pigsty v3.6+ 自 Pigsty v3.6 起，etcd.yml 剧本不再包含移除功能，移除相关参数已迁移至独立的 etcd_remove 角色。v4.0 起默认启用 RBAC 认证，新增 etcd_root_password 参数。 参数概览 ETCD 参数组用于 etcd 集群的部署与配置， …

在部署 Etcd 之前，你需要在 配置清单 中定义一个 Etcd 集群，通常来说，你可以选择： 单节点：没有高可用性，适用于开发、测试、演示，或者依赖外部 S3 备份进行 PITR 的无高可用单机部署 三节点：具有基本的高可用性，可以容忍一个节点的故障，适用于中小规模的生产环境 五节点：具有更好的高可用性，可以容忍两个节点的故障，适用于大规模生产环境 偶数成员的 Etcd 集群在技术上有效，但不会比少一个成员的奇数集群提高故障容忍数，反而会增加部署与仲裁成本。 因此，生产环境通常采用单节点、三节 …

ETCD 是一个分布式的、可靠的键-值存储，用于存放系统中最为关键的配置数据。 Pigsty 使用 etcd 作为 DCS（分布式配置存储），它对于 PostgreSQL 的高可用性与自动故障转移至关重要。 ETCD 模块依赖 NODE 模块，同时被 PGSQL 模块依赖。因此在安装 ETCD 模块之前，您需要安装 NODE 模块将节点纳管。 在部署任何 PGSQL 集群之前，你必须先部署一套 ETCD 集群，因为 PostgreSQL 高可用所需的 patroni 和 vip-manager …

如何配置主机节点上的NTP服务？ NTP 对于生产环境各项服务非常重要，如果没有配置 NTP，您可以使用公共 NTP 服务，或管理节点上的 Chronyd 作为标准时间。 如果您的节点已经配置了 NTP，可以通过设置 node_ntp_enabled 为 false 来保留现有配置，不进行任何变更。 否则，如果您有互联网访问权限，可以使用公共 NTP 服务，例如 pool.ntp.org。 如果您没有互联网访问权限，可以使用以下方式，确保所有环境内的节点与管理节点时间是同步的，或者使用其他内网 …

本页快照记录 NODE 模块的 727 类监控指标；实际运行时的指标集合会随软件包版本、启用的采集器和目标状态变化。 Metric Name Type Labels Description ALERTS Unknown alertname, ip, level, severity, ins, job, alertstate, category, instance, cls N/A ALERTS_FOR_STATE Unknown alertname, ip, level, severity, …

Pigsty 当前在 NODE 仪表盘目录中提供 10 个监控面板和完善的告警规则。 监控面板 NODE 仪表盘目录当前包含 10 个监控仪表板；其中 JuiceFS 与 Claude Code 面板只有在部署并产生相应指标后才会有数据。 NODE Overview 展示当前环境所有主机节点的总体情况概览。 NODE Cluster 显示特定主机集群的详细监控数据。 Node Instance 呈现单个主机节点的详细监控信息。 NODE Alert 集中展示环境中所有主机的告警信息。 NODE …

NODE 模块负责将主机节点调整到期待的目标状态，并将其纳入 Pigsty 的监控系统中。 参数组 功能说明 NODE_ID NODE_ID 相关参数 NODE_DNS NODE_DNS 相关参数 NODE_PACKAGE NODE_PACKAGE 相关参数 NODE_TUNE NODE_TUNE 相关参数 NODE_SEC NODE_SEC 安全相关参数 NODE_ADMIN NODE_ADMIN 相关参数 NODE_TIME NODE_TIME 相关参数 NODE_VIP NODE_VIP …

Pigsty 使用 IP 地址 作为 节点 的唯一身份标识，该 IP 地址应当是数据库实例监听并对外提供服务的内网 IP 地址。 node-test: hosts: 10.10.10.11: { nodename: node-test-1 } 10.10.10.12: { nodename: node-test-2 } 10.10.10.13: { nodename: node-test-3 } vars: node_cluster: node-test 该 IP 地址必须是数据库实例监听并对外 …

配置目标服务器，纳管主机节点，并将其调整至描述的状态。也包括节点上的 VIP，HAProxy 以及监控组件。

本章节介绍 Pigsty 部署的日常管理和运维操作。

INFRA 模块中包含了哪些组件？ 严格按当前源码区分，infra 角色直接管理以下组件： Nginx：暴露 Grafana、VictoriaMetrics（VMUI）、Alertmanager 等 WebUI，并托管本地 YUM/APT 仓库。 DNSMasq：提供 DNS 注册与解析。 VictoriaMetrics 套件：VictoriaMetrics、VMAlert、VictoriaLogs 与 VictoriaTraces。 Alertmanager、Blackbox …

注意：Pigsty v4.0 已将 Prometheus/Loki 替换为 VictoriaMetrics/Logs/Traces。以下指标清单仍基于 v3.x 生成，仅供排查旧版本问题参考。若需获取最新指标，请在 https://p.pigsty (VMUI) 或 Grafana 中直接查询，后续版本会重新生成与 Victoria 套件一致的指标速查表。 INFRA 指标 INFRA 模块包含有 964 类可用监控指标。 Metric Name Type Labels Description …

本文介绍 Pigsty 中 INFRA 模块的监控面板与告警规则。 监控面板 Pigsty 针对 Infra 模块提供了以下监控面板： 面板 描述 Pigsty Home Pigsty 监控系统主页 INFRA Overview Pigsty 基础设施自监控概览 Nginx Instance Nginx 监控指标与日志 Grafana Instance Grafana 监控指标与日志 VictoriaMetrics Instance VictoriaMetrics 抓取/查询状态 VMAlert …

INFRA 模块负责配置 Pigsty 的基础设施组件：本地软件源、Nginx、DNSMasq、VictoriaMetrics、VictoriaLogs、Grafana、Alertmanager、Blackbox Exporter 等监控告警基础设施。 Pigsty v4.x 使用 VictoriaMetrics 替代 Prometheus，使用 VictoriaLogs 替代 Loki，实现了更优秀的可观测性方案。 参数组 功能说明 META Pigsty 元信息：版本、管理 IP、区域、语言 …

配置说明 INFRA 主要用于提供 监控 基础设施，对于 PostgreSQL 数据库是 可选项。 除非手工配置了对 INFRA 节点上 DNS/NTP 服务的依赖，否则 INFRA 模块故障通常不影响 PostgreSQL 数据库集群运行。 单个 INFRA 节点足以应对绝大部分场景。生产环境建议使用 2～3 个 INFRA 节点实现高可用。 通常出于提高资源利用率的考虑，PostgreSQL 高可用依赖的 ETCD 模块可以与 INFRA 模块共用节点。 使用 3 个以上的 INFRA 节点 …

配置 | 管理 | 剧本 | 监控 | 参数 概览 每一套 Pigsty 部署都会提供一套基础架构组件，为纳管的节点与数据库集群提供服务，组件包括： 组件 端口 描述 Nginx 80/443 Web 服务门户、本地软件仓库与统一入口 Grafana 3000 可视化平台，提供监控大屏、巡检与数据应用 VictoriaMetrics 8428 时序数据库与 VMUI，可兼容 Prometheus API VictoriaLogs 9428 集中式日志数据库，接收 Vector 推送的结构化日志 …

Pigsty 提供补充扩展仓库，在 PGDG 官方仓库基础上提供额外的扩展包。 YUM 仓库 适用于 EL 8/9/10 及其兼容系统（RHEL、Rocky、AlmaLinux、CentOS 等）。 添加仓库 # 添加 GPG 公钥 curl -fsSL https://repo.pigsty.io/key | sudo tee /etc/pki/rpm-gpg/RPM-GPG-KEY-pigsty >/dev/null # 添加仓库配置 curl -fsSL …

Pigsty 在初始化 PostgreSQL 集群时，会默认安装和启用一些核心扩展。 默认安装的扩展 通过 pg_packages 默认安装的扩展： 扩展 说明 pg_repack 在线处理表膨胀，重要的维护工具 wal2json 逻辑解码输出 JSON 格式变更，CDC 场景常用 pgvector 向量数据类型与索引，默认随 pgsql-main 安装 pg_extensions 的默认值为空数组 []。如需安装其他扩展，可以按需声明，例如： 扩展 说明 postgis 地理空间数据库扩展 …

我当前执行安装的用户为何不能使用 pg 管理别名？ 从 Pigsty v4.0 开始，使用 pg 管理别名管理全局的 Patroni / PostgreSQL 集群的权限被收紧到了管理节点上的管理员分组（admin）。 node.yml 剧本创建的管理员（dba）默认具有此权限，而其他用户如果想要获得这个权限，需要你显式地将该用户加入到 admin 组中。 sudo usermod -aG admin <username> PGSQL初始化失败：Fail to wait for …

移除扩展涉及两个层面：删除扩展对象（数据库层面）和 卸载软件包（操作系统层面）。 删除扩展对象 使用 DROP EXTENSION 从数据库中删除扩展： -- 删除扩展 DROP EXTENSION pgvector; -- 如果有依赖对象，需要级联删除 DROP EXTENSION pgvector CASCADE; 警告：CASCADE 会删除所有依赖于该扩展的对象（表、函数、视图等），请谨慎使用。 查看扩展依赖 删除前建议先检查依赖关系： -- 查看依赖于某扩展的对象 SELECT …

扩展更新涉及两个层面：软件包更新（操作系统层面）和 扩展对象更新（数据库层面）。 更新软件包 使用包管理器更新扩展的软件包： # EL 系统 sudo yum update pgvector_18* # Debian/Ubuntu 系统 sudo apt update && sudo apt upgrade postgresql-18-pgvector 使用 Pigsty 批量更新： # 更新指定集群的扩展包 ./pgsql.yml -l pg-meta -t pg_extension -e …

安装扩展软件包后，需要在数据库中执行 CREATE EXTENSION 才能使用扩展功能。 查看可用扩展 安装扩展软件包后，可以查看可用的扩展： -- 查看所有可用扩展 SELECT * FROM pg_available_extensions; -- 查看特定扩展 SELECT * FROM pg_available_extensions WHERE name = 'vector'; -- 查看已启用的扩展 SELECT * FROM pg_extension; 创建扩展 使用 CREATE …

部分扩展需要预加载动态库或配置参数后才能使用，本节介绍如何配置扩展。 预加载扩展 大多数扩展安装后可直接使用 CREATE EXTENSION 启用，但部分使用 PostgreSQL Hook 机制的扩展需要 预加载。 预加载通过 shared_preload_libraries 参数指定，修改后需 重启数据库 生效。 需要预加载的扩展 以下是常见的需要预加载的扩展： 扩展 说明 timescaledb 时序数据库扩展，必须放在最前面 citus 分布式数据库扩展，必须放在最前面 …

在安装扩展前，需要确保扩展软件包已下载到本地仓库或可从上游获取。 默认行为 Pigsty 默认会把基础 PostgreSQL 18 内核包下载到本地软件仓库。默认额外下载集为 repo_extra_packages_default: [ pgsql-main ]，包含 PostgreSQL 内核、客户端、过程语言，以及 pg_repack、wal2json、pgvector 等基础扩展包。 如果需要 575 个扩展目录中的其他扩展，请显式加入 repo_extra_packages；Pigsty …

Pigsty 使用 包别名 机制简化扩展的安装与管理。 包别名机制 管理扩展涉及多个层面的名称映射： 层面 示例 pgvector 示例 postgis 扩展名 vector postgis, postgis_topology, … 包别名 pgvector postgis RPM 包名 pgvector_18 postgis36_18* DEB 包名 postgresql-18-pgvector postgresql-18-postgis-3* Pigsty 提供 包别名 抽象层，让用户无需关 …

扩展是 PostgreSQL 的灵魂所在。Pigsty 收录了 575 个预编译、开箱即用的扩展插件，充分释放 PostgreSQL 的潜能。 扩展是什么 PostgreSQL 扩展（Extension）是一种模块化机制，允许在不修改核心代码的情况下增强数据库功能。 一个扩展通常包含三部分： 控制文件（.control）：必需，包含扩展元数据 SQL 脚本（.sql）：可选，定义函数、类型、操作符等数据库对象 动态库（.so）：可选，提供 C 语言实现的高性能功能 扩展可以为 …

Pigsty 提供四种预置的 Patroni/PostgreSQL 配置模板，针对不同的使用场景进行了参数优化： 模板 CPU 核心 适用场景 特点 /docs/pgsql/template/oltp.yml 4-128C OLTP 事务处理 高并发、低延迟、高吞吐 /docs/pgsql/template/olap.yml 4-128C OLAP 分析处理 大查询、高并行、长事务 /docs/pgsql/template/crit.yml 4-128C 一致性优先业务 一致性优先、详细审计 …

Pigsty 提供 575 个已打包扩展，覆盖时序、地理、向量、全文检索、分析、特性增强等 16 大类别，开箱即用。 在 Pigsty 中使用扩展涉及四个核心步骤：下载、安装、配置/加载 与 启用。 pg-meta: hosts: { 10.10.10.10: { pg_seq: 1, pg_role: primary } } vars: pg_cluster: pg-meta pg_databases: - name: meta extensions: [ postgis, …

您可以在 PostgreSQL 集群上绑定一个可选的 L2 VIP —— 前提条件是：集群中的所有节点都在一个二层网络中。 这个 L2 VIP 强制使用 Master - Backup 模式，Master 始终指向在数据库集群主库实例所在的节点。 这个 VIP 由 VIP-Manager 组件管理，它会从 DCS （etcd） 中直接读取由 Patroni 写入的 Leader Key，从而判断自己是否是 Master。 启用VIP 在 PostgreSQL 集群上定义 …

PGSQL 模块需要在 Pigsty 管理的节点上安装（即节点已经配置了 NODE 模块），同时还要求您的部署中有一套可用的 ETCD 集群来存储集群元数据。 在单个节点上安装 PGSQL 模块将创建一个独立的 PGSQL 服务器/实例，即 主实例。 在额外节点上安装将创建 只读副本，可以作为备用实例，并用于承载分担只读请求。 您还可以创建用于 ETL/OLAP/交互式查询的 离线 实例， 使用 同步备库 和 法定人数提交 来提高数据一致性， 甚至搭建 备份集群 和 延迟集群 以快速应对人为失误 …

PGSQL 模块包含有 638 类可用监控指标。 Metric Name Type Labels Description ALERTS Unknown category, job, level, ins, severity, ip, alertname, alertstate, instance, cls N/A ALERTS_FOR_STATE Unknown category, job, level, ins, severity, ip, alertname, instance, cls …

Pigsty 为 PostgreSQL 提供了诸多开箱即用的 Grafana 监控仪表盘： Demo & Gallery。 当前源码共提供 31 个 PostgreSQL 相关面板：files/grafana/pgsql 中有 29 个 PostgreSQL / PGCAT 面板，files/grafana/app 中另有 2 个 PGLOG 面板。它们按层次分为总览、集群、实例、数据库四大类，按数据来源分为 PGSQL、PGCAT、PGLOG 三类。 总览 总览 集群 实例 数据库 …

本文介绍了 Pigsty 的监控系统架构，包括监控指标，日志，与目标管理的方式。以及如何 监控现有PG集群 与远程 RDS服务。 监控概览 Pigsty 使用现代的可观测技术栈对 PostgreSQL 进行监控： 使用 Grafana 进行指标可视化和 PostgreSQL 数据源。 使用 VictoriaMetrics 来采集 PostgreSQL / Pgbouncer / Patroni / HAProxy / Node 的指标 使用 VictoriaLogs 来记录 PostgreSQL …

参数配置与参考文档

Pigsty 内置了一个剧本 pgsql-migration.yml，基于逻辑复制来实现在线数据库迁移。 通过预生成的自动化脚本，应用停机时间可以缩减到几秒内。但请注意，逻辑复制需要 PostgreSQL 10 以上的版本才能工作。 当然如果您有充足的停机时间预算，那么总是可以使用 pg_dump | psql 的方式进行停机迁移。 定义迁移任务 想要使用 Pigsty 提供的在线迁移剧本，您需要创建一个定义文件，来描述迁移任务的细节。 请查看任务定义文件示例作为参考： …

数据库管理与运维任务

Pigsty 的访问控制文档已按用途拆分： 访问控制概念：角色模型、默认权限、数据库 ACL 和实例隔离边界。 访问控制配置：pg_default_roles、pg_users、pg_default_privileges 等参数。 身份认证：HBA、SCRAM、证书认证与凭据管理。 HBA 配置：PostgreSQL 与 PgBouncer 规则语法。 用户管理：在现有集群中创建、更新和删除用户。 dbrole_offline 只提供独立的只读对象权限，不会自动限制实例范围。若要仅允许其访问离线 …

Pigsty 中基于主机的身份认证 HBA（Host-Based Authentication）详解。 认证是 访问控制 与 默认权限 的基础，PostgreSQL 支持多种 认证 方法。 这里主要介绍 HBA：Host Based Authentication，HBA 规则定义了哪些用户能够通过哪些方式从哪些地方访问哪些数据库。 客户端认证 要连接到 PostgreSQL 数据库，用户必须先经过认证（默认使用密码）。 您可以在连接字符串中提供密码（不安全）或使用 PGPASSWORD 环境变 …

分离读写操作，正确路由流量，稳定可靠地交付 PostgreSQL 集群提供的能力。 服务 是一种抽象：它是数据库集群对外提供能力的形式，并封装了底层集群的细节。 服务对于生产环境中的 稳定接入 至关重要，在 高可用 集群自动故障时方显其价值，单机用户 通常不需要操心这个概念。 单机用户 “服务” 的概念是给生产环境用的，个人用户/单机集群可以不折腾，直接拿实例名/IP 地址访问数据库。 例如，Pigsty 默认的单节点 pg-meta.meta 数据库，就可以直接用下面三个不同的用户连接上去。 …

在这里的上下文中，数据库指的是使用 SQL 命令 CREATE DATABASE 创建的，数据库集簇内的逻辑对象。 一组 PostgreSQL 服务器可以同时服务于多个 数据库 （Database）。在 Pigsty 中，你可以在集群配置中 定义 好所需的数据库。 Pigsty 会对默认模板数据库 template1 进行修改与定制，创建默认模式，安装默认扩展，配置默认权限，新创建的数据库默认会从 template1 继承这些设置。 默认情况下，所有业务数据库都会被1:1添加到 …

在这里的上下文中，用户指的是使用 SQL 命令 CREATE USER/ROLE 创建的，数据库集簇内的逻辑对象。 在 PostgreSQL 中，用户直接隶属于数据库集簇而非某个具体的数据库。因此在创建业务数据库和业务用户时，应当遵循"先用户，后数据库"的原则。 定义用户 Pigsty 通过两个配置参数定义数据库集群中的角色与用户： pg_default_roles：定义全局统一使用的角色和用户 pg_users：在数据库集群层面定义业务用户和角色 前者用于定义了整套环境中共用的角色与用户，后 …

PostgreSQL 安全由身份认证、权限控制、网络边界、加密通信、数据保护和运维流程共同构成。Pigsty 提供这些机制的配置入口，但部署方仍需根据环境完成加固、验证和持续审计。 概念与边界 主题 内容 安全与合规 默认状态、能力边界与加固路径 身份认证 HBA、SCRAM、证书认证与凭据管理 访问控制 内置角色、默认权限、数据库 ACL 与实例访问边界 加密通信 CA、TLS、服务端身份验证与证书轮换 数据安全 页校验和、复制、备份、PITR、审计与日志 合规实践 上线检查、控制映射与证据要 …

分离读写操作，正确路由流量，稳定可靠地交付 PostgreSQL 集群提供的能力。 服务 是一种抽象：它是数据库集群对外提供能力的形式，并封装了底层集群的细节。 服务对于生产环境中的 稳定接入 至关重要，在 高可用 集群自动故障时方显其价值，单机用户 通常不需要操心这个概念。 单机用户 “服务” 的概念是给生产环境用的，个人用户/单机集群可以不折腾，直接拿实例名/IP 地址访问数据库。 例如，Pigsty 默认的单节点 pg-meta.meta 数据库，就可以直接用下面三个不同的用户连接上去。 …

Pigsty 是一个“配置驱动”的 PostgreSQL 平台：所有行为都来自 ~/pigsty/conf/*.yml 清单与 PGSQL 参数 的组合。 只要写好配置，你就能在几分钟内复刻出一套包含实例、用户、数据库、访问控制、扩展与调优策略的定制集群。 配置入口 准备清单：复制 pigsty/conf/*.yml 模板或从零开始编写 Ansible Inventory，将集群分组（all.children.<cls>.hosts）与全局变量（all.vars）写入同一个文件。 定义参数：在 …

demo/wool 是面向中国区低配云主机的单节点示例，默认使用 region: china、PostgreSQL 18 与 tiny 调优参数。 配置概览 配置名称：demo/wool 节点数量：单节点 建议规格：约 2C/2G 的测试主机 相关配置：meta、slim ./configure -c demo/wool [-i <private_ip>] 配置内容 源文件地址：pigsty/conf/demo/wool.yml --- …

demo/saas 是一个传统的功能丰富单节点示例，预置多组业务用户、数据库和应用入口，用于展示 PostgreSQL、Silo、Redis、Docker 与 Portal 的组合方式。 配置概览 配置名称：demo/saas 节点数量：单节点 模块：INFRA、ETCD、MINIO、PGSQL、REDIS、DOCKER 相关配置：rich、supabase ./configure -c demo/saas [-i <primary_ip>] 配置内容 源文件地址 …

demo/remote 不部署本地 PostgreSQL 集群，而是在 INFRA 节点上声明多个 pg_exporters，用于接入远程 PostgreSQL、PolarDB 或云 RDS。 配置概览 配置名称：demo/remote 本地节点数量：1 个 INFRA 节点 Exporter 示例端口：20001～20016 相关文档：PG Exporter ./configure -c demo/remote [-i <infra_ip>] 配置内容 源文件地址 …

build/dev 配置模板是 Pigsty 的三节点本地构建开发环境，用于在 EL9、Debian 12、Ubuntu 24 三类节点上验证仓库构建与包下载流程。 此配置仅供开发者和贡献者使用。 配置概览 配置名称： build/dev 节点数量：三节点（el9, d12, u24） 配置说明：本地构建开发环境，默认 PostgreSQL 18，构建 infra,node,pgsql 模块 适用系统：el9, d12, u24 适用架构：x86_64, aarch64 相关配置 …

build/oss 配置模板是 Pigsty 开源版离线软件包的构建环境配置，用于在多个操作系统上批量构建离线安装包。 此配置仅供开发者和贡献者使用。 配置概览 配置名称： build/oss 节点数量： 七节点（el9, el10, d12, d13, u22, u24, u26） 配置说明：Pigsty 开源版离线软件包构建环境 适用系统：el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64 启用方式： cp conf/build/oss.yml …

demo/mysql 是原生 MySQL 8.4 LTS 试点模块的四节点示例，与 conf/mysql.yml 中通过 OpenHalo 提供 MySQL 协议兼容的 PostgreSQL 内核不是同一实现。 配置概览 配置名称：demo/mysql 节点数量：4 个 my-meta：单节点 MySQL 8.4 my-test：三节点、单主模式 InnoDB Cluster，每个成员运行 MySQL Router 模块状态：MYSQL PILOT，不计入正式模块数量 平台边界：支持声明的 …

demo/kafka 在四个节点上声明两套 Kafka 4.x dynamic KRaft 集群：单节点明文开发集群 kf-meta，以及三节点 TLS/SCRAM/ACL 演示集群 kf-test。 配置概览 配置名称：demo/kafka 节点数量：4 个 kf-meta：单节点 combined Broker/Controller，明文模式 kf-test：3 个 combined 节点，TLS/SCRAM/ACL，Topic 副本数 3、min.insync.replicas=2 模块状 …

demo/redis 在一份配置中演示 Pigsty Redis 模块支持的 standalone/replica、Sentinel 与原生 Cluster 模式。 配置概览 配置名称：demo/redis 节点数量：4 个 集群：redis-ms、redis-meta、redis-test 相关配置：demo/demo ./configure -c demo/redis -s 配置内容 源文件地址：pigsty/conf/demo/redis.yml --- …

demo/minio 配置模板演示如何部署四节点 x 四盘位、总计十六盘的高可用 S3 对象存储集群。模板沿用 MINIO 模块的兼容命名，并显式设置 minio_type: silo；v4.5.0 当前源码只接受这一取值，部署与移除角色也都默认使用 silo。删除前仍应把该值连同精确目标、集群身份和数据盘路径一并核对。 更多教程，请参考 MINIO 模块文档。 配置概览 配置名称： demo/minio 节点数量： 四节点 配置说明：高可用多节点多盘 S3 对象存储集群演示（当前默认 …

demo/kernel 配置模板用于在一套配置中演示 Pigsty 支持的主要 PostgreSQL 内核与兼容分支。它面向功能验证和内核差异测试，不是生产模板。 配置概览 配置名称： demo/kernel 节点数量：10 个节点，其中 1 个同时承载 INFRA/ETCD 与 pg-citus 配置说明：PostgreSQL 内核矩阵演示，覆盖 Citus、IvorySQL、Babelfish、PolarDB、Percona …

demo/demo 配置模板是 Pigsty 公开演示站点使用的配置文件，展示了如何对外暴露网站、配置 SSL 证书、安装全部扩展插件。 如果您希望在云服务器上搭建自己的公开服务，可以参考此配置模板。 配置概览 配置名称： demo/demo 节点数量： 单节点 配置说明：Pigsty 公开演示站点配置 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64 相关配置：meta，rich 启用方式： ./configure -c …

demo/debian 配置模板是针对 Debian 和 Ubuntu 发行版优化的配置模板。 配置概览 配置名称： demo/debian 节点数量： 单节点 配置说明：Debian/Ubuntu 专用配置模板 适用系统：d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta，demo/el 启用方式： ./configure -c demo/debian [-i <primary_ip>] 配置内容 源文件地址 …

demo/el 配置模板是针对 Enterprise Linux 系列发行版（RHEL、Rocky Linux、Alma Linux、Oracle Linux）优化的配置模板。 配置概览 配置名称： demo/el 节点数量： 单节点 配置说明：Enterprise Linux 专用配置模板 适用系统：el8, el9, el10 适用架构：x86_64, aarch64 相关配置：meta，demo/debian 启用方式： ./configure -c demo/el [-i …

demo/bare 是最小化的 Pigsty 配置示例，只保留三个核心分组和三个全局参数，用于展示一份可工作的 Inventory 骨架。 配置概览 配置名称：demo/bare 节点数量：单节点 模块：INFRA、ETCD、PGSQL 相关配置：meta、slim ./configure -c demo/bare [-i <primary_ip>] 配置内容 源文件地址：pigsty/conf/demo/bare.yml --- all: children: infra: { hosts: { …

ha/citus 配置模板部署一套完整的 Citus 分布式 PostgreSQL 集群，包含 1 个基础设施节点、1 组协调节点和 5 组工作节点（共 12 个 Citus 节点），提供透明的水平扩展与数据分片能力。 配置概览 配置名称： ha/citus 节点数量： 13 节点（1 基础设施 + 1 协调组 × 2 + 5 工作组 × 2） 配置说明：Citus 分布式 PostgreSQL 高可用集群 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 …

ha/dual 模板使用双节点部署，实现一主一备的"半高可用"架构。如果您只有两台服务器，这是一个务实的选择。 配置概览 配置名称： ha/dual 节点数量： 双节点 配置说明：两节点有限高可用部署，允许特定一台服务器宕机 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：ha/trio，slim 启用方式： ./configure -c ha/dual [-i <primary_ip>] 配置生成后， …

三节点是实现多数派高可用的最小规格。ha/trio 将 INFRA、ETCD、PGSQL 与 Silo 分布在三台服务器上；PostgreSQL、ETCD 和对象存储都可以在一台服务器宕机时继续服务。 配置概览 配置名称： ha/trio 节点数量： 三节点 配置说明：三节点标准高可用架构，包含三节点单盘 Silo 与统一 S3 高可用入口 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置 …

ha/safe 基于三节点高可用拓扑，示范 TLS、客户端证书、口令检查、备份加密和 CRIT 参数模板等安全配置。它是可修改的配置样例，不是合规认证模板。 配置概览 配置名称：ha/safe 节点数量：3 个 INFRA、etcd 和 PostgreSQL 节点；可选延迟副本 适用系统：el8、el9、el10、d12、d13、u22、u24、u26 适用架构：x86_64；部分安全扩展没有 ARM64 软件包 相关配置：ha/trio、ha/full 生成配置： ./configure -c …

上手路线 顺序 要解决的问题 入口 1 Pigsty 由哪些模块组成？ 积木式架构，PGSQL 架构，PGSQL 集群模型 2 怎么先跑起来？ 快速上手，图形界面，快速上手 PostgreSQL 3 配置文件该怎么看？ 声明式配置，配置清单，配置参数 4 生产部署要准备什么？ 架构规划，资源准备，管理机制 5 怎么部署多节点集群？ 生产部署，执行剧本，PGSQL 剧本 6 日常怎么管库？ PGSQL 日常管理，集群管理，用户管理，数据库管理 7 怎么验证可靠性？ PG 高可用，Patroni 管 …

ha/full 配置模板是 Pigsty 推荐的沙箱演示环境，使用四个节点部署两套 PostgreSQL 集群，用于测试和演示 Pigsty 各方面的能力。 Pigsty 大部分教程和示例都基于此模板的沙箱环境。 配置概览 配置名称： ha/full 节点数量： 四节点 配置说明：四节点完整功能演示环境，带有两套 PostgreSQL 集群、Silo、Redis 等组件示例 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, …

ha/octo 使用 vagrant/spec/deci.rb 的前八个节点，构造一套紧凑的高可用仿真环境。它用于验证多模块共置、VIP、远程备份和较大成员规模，不应未经容量、安全和故障域评审直接作为生产蓝图。 配置概览 配置名称：ha/octo 节点地址：10.10.10.10 ～ 10.10.10.17 INFRA：3 节点；仅首节点构建并服务本地软件仓库，三节点可按注释另行安装 Docker ETCD：5 节点，部署在后五个节点 对象存储：8 节点单盘集群；模板未覆盖 …

ha/simu 配置模板是一个 20 节点的生产环境仿真配置，需要强大的宿主机方可运行。 配置概览 配置名称： ha/simu 节点数量： 20 节点，pigsty/vagrant/spec/simu.rb 配置说明：20 节点的生产环境仿真配置，需要强大的宿主机方可运行。 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 启用方式： ./configure -c ha/simu [-i <primary_ip>] …

您可以在 configure 时使用 -c 指定配置模板；参数值为相对 conf/ 的路径且不带 .yml 后缀。如果没有指定，将使用默认的 meta 模板。 分类 模板 单机模板 meta、rich、fat、slim、infra、vibe、docker 内核模板 pgsql、pg19、mssql、polar、ivory、agens、pgedge、mysql（OpenHalo）、mongo、pgtde、oriole 高可用模板 …

mongo 配置模板是一个 PostgreSQL 部署模式，而不是独立的 Pigsty 模块。它由以下组件组成： 由标准 PGSQL 模块管理的 PostgreSQL 18 documentdb 扩展及其预加载库 通过 Pigsty Docker APP 工作流部署的无状态 FerretDB 代理 所有数据、高可用、备份、监控与生命周期管理仍由 PostgreSQL 负责；FerretDB 只提供 MongoDB 线协议兼容端点。 快速开始 模板默认部署在单节点 10.10.10.10 上 …

以下为 Pigsty 中各模块组件使用的默认端口及其对应参数，您可以按需调整，或者作为内部防火墙精细配置的参考。 模块 组件 端口 参数 状态 NODE node_exporter 9100 node_exporter_port ✅ 默认启用 NODE haproxy 9101 haproxy_exporter_port ✅ 默认启用 NODE vector 9598 vector_port ✅ 默认启用 NODE keepalived_exporter 9650 …

oriole 配置模板使用 OrioleDB 存储引擎替代 PostgreSQL 默认的 Heap 存储，提供无膨胀、高性能的 OLTP 能力。 配置概览 配置名称： oriole 节点数量： 单节点 配置说明：OrioleDB 无膨胀存储引擎配置 PostgreSQL 大版本：16、17、18 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式： ./configure -c …

本文汇总 Pigsty v4.x 各模块剧本入口与执行要点，详细任务标签请进入对应模块 playbook 文档。 模块剧本导航 模块 数量 剧本 INFRA 3 deploy.yml infra.yml infra-rm.yml NODE 2 node.yml node-rm.yml ETCD 2 etcd.yml etcd-rm.yml PGSQL 7 pgsql.yml pgsql-rm.yml pgsql-user.yml pgsql-db.yml pgsql-monitor.yml …

pgtde 配置模板使用 Percona PostgreSQL 数据库内核，提供透明数据加密 (Transparent Data Encryption, TDE) 能力。 配置概览 配置名称： pgtde 节点数量： 单节点 配置说明：Percona PostgreSQL 透明数据加密配置 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式： ./configure -c pgtde …

本文是 Pigsty v4.x 的参数导航页，不重复展开每个参数的详细解释。 参数细节请进入各模块的 param 页面查看。 按照当前源码与参数参考页逐项对账，10 个正式模块合计 373 个公开参数。原生 MySQL 8.4 仍是试点模块，其 13 个公开参数单列，不计入正式模块合计。 模块参数导航 模块 参数组 参数量 说明 PGSQL 9 124 PostgreSQL 高可用集群配置 INFRA 10 73 软件仓库与 Victoria 可观测基础设施 NODE 11 73 节点初始化、系 …

Pigsty FHS Pigsty 的主目录默认放置于 ~/pigsty，该目录下的文件结构如下所示： ~/pigsty 源码树 app/应用模板资源bin/管理与运维脚本files/victoria/规则与运维脚本grafana/Grafana 仪表盘postgres/PostgreSQL 管理脚本migration/数据迁移任务定义pki/自签名 CA 与证书roles/Ansible 角色实现templates/Ansible 模板文件vagrant/Vagrant 沙箱定义 …

mysql 配置模板使用 OpenHalo 数据库内核替代原生 PostgreSQL，提供 MySQL 线缆协议与 SQL 语法兼容能力。 配置概览 配置名称： mysql 节点数量： 单节点 配置说明：OpenHalo MySQL 兼容内核配置 适用系统：EL 8/9/10、Debian 12/13、Ubuntu 22/24/26 适用架构：x86_64、aarch64 相关配置：meta 启用方式： ./configure -c mysql [-i <primary_ip>] 配置内容 源文 …

正式模块 模块 类别 状态 文档入口 简介 PGSQL 核心 GA /docs/pgsql 高可用 PostgreSQL 集群，内置备份、监控、SOP 与扩展生态。 INFRA 核心 GA /docs/infra 本地软件仓库 + VictoriaMetrics/Logs/Traces + Grafana 等基础设施。 NODE 核心 GA /docs/node 节点初始化与收敛：系统调优、管理员、HAProxy、Vector、Keepalived 等。 ETCD 核心 GA …

pgedge 配置模板使用 pgEdge 数据库内核替代原生 PostgreSQL，提供面向边缘场景的分布式与多主复制能力。 完整教程请参考：pgEdge 内核使用说明；所有内核分支的差异与版本口径见 PGSQL 内核总览。 配置概览 配置名称： pgedge 节点数量： 单节点 配置说明：pgEdge（PG18）分布式内核配置模板 适用系统：d12, d13, u22, u24, u26（PG18 包）；EL/RPM 平台请以当前 PGSQL 仓库的 pgedge_18 包可用性为准 适用架构 …

Pigsty 运行于 Linux 操作系统上，支持 amd64/x86_64 与 arm64/aarch64 架构，支持 EL，Debian，Ubuntu 三大主流 Linux 发行版。 Pigsty 不使用任何虚拟化容器化技术，直接运行于裸操作系统上。我们为三大主流 Linux 发行版生命周期内的主流大版本与两种架构提供支持。 概述 Pigsty 推荐使用的操作系统版本：Rocky Linux 9.8 / 10.2、Debian 12.15 / 13.6、Ubuntu 22.04.5 / …

agens 配置模板使用 AgensGraph 数据库内核替代原生 PostgreSQL，提供属性图模型与 Cypher 查询能力。 完整教程请参考：AgensGraph 内核使用说明 配置概览 配置名称： agens 节点数量： 单节点 配置说明：AgensGraph（PG17）图数据库内核配置 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta、pgsql 启用方式： ./configure …

ivory 配置模板使用瀚高的 IvorySQL 数据库内核替代原生 PostgreSQL，提供 Oracle 语法与 PL/SQL 兼容能力。 完整教程请参考：IvorySQL (Oracle兼容) 内核使用说明 配置概览 配置名称： ivory 节点数量： 单节点 配置说明：使用 IvorySQL Oracle 兼容内核 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式： …

当前版本暂未提供 cloudberry 配置模板。 如果你需要该模板，请先参考： 内核版本：Cloudberry 配置模板总览

polar 配置模板使用阿里云 PolarDB for PostgreSQL 数据库内核替代原生 PostgreSQL，提供"云原生" Aurora 风格的存算分离能力。 完整教程请参考：PolarDB for PostgreSQL (POLAR) 内核使用说明；所有内核分支的差异与版本口径见 PGSQL 内核总览。 配置概览 配置名称： polar 节点数量： 单节点 配置说明：使用 PolarDB for PostgreSQL 内核 适用系统：el8, el9, el10, d12, …

mssql 配置模板使用 PostgreSQL 17 兼容的 Babelfish 内核替代原生 PostgreSQL，提供 Microsoft SQL Server 线缆协议（TDS）与 T-SQL 语法兼容能力。当前模板固定 pg_version: 17；configure 不会用 -v 覆盖此固定内核版本。 从 Pigsty v4.2 以来，Babelfish 由 Pigsty 直接构建，不再使用 WiltonDB 仓库，可在所有 支持的 Linux 平台 上使用。 完整教程请参考 …

pg19 是 PostgreSQL 19 Beta 的单节点试用模板。它基于 meta 拓扑，但启用 beta 软件仓库，并将本地仓库的额外缓存范围缩小到 PGSQL 核心包，不预装扩展。 配置概览 配置名称：pg19 节点数量：单节点 PostgreSQL 版本：19 Beta 适用场景：新版本功能验证、兼容性测试 相关配置：meta、pgsql 启用方式： ./configure -c pg19 [-i <primary_ip>] 配置内容 源文件地址 …

pgsql 配置模板使用原生 PostgreSQL 内核，是 Pigsty 的默认数据库内核，稳定支持 PostgreSQL 14 到 18。当前 configure 也接受版本 19，但 PG19 仍是 Beta，建议使用专用 pg19 模板试用。 配置概览 配置名称： pgsql 节点数量： 单节点 配置说明：原生 PostgreSQL 内核配置模板 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置 …

docker 配置模板用于在 Docker 容器内运行 Pigsty，提供最小可用的单节点基础设施与 PostgreSQL 能力。 配置概览 配置名称： docker 节点数量： 单节点（容器环境） 配置说明：容器内快速体验模板，使用 127.0.0.1 与精简系统能力，适配 Docker 场景。 适用系统：容器镜像内置环境（建议配合官方 Pigsty Docker 镜像） 适用架构：x86_64, aarch64 相关配置：meta、vibe 启用方式： ./configure -c …

vibe 配置模板提供了一个开箱即用的 AI 编程沙箱，集成了 Code-Server（Web VS Code）、JupyterLab、Claude Code 可观测能力、Codex CLI、JuiceFS 分布式文件系统，以及功能丰富的 PostgreSQL 数据库。 配置概览 配置名称： vibe 节点数量： 单节点 配置说明：VIBE AI 编程沙箱，Code-Server + JupyterLab + Claude Code + Codex CLI + JuiceFS + …

infra 配置模板仅部署 Pigsty 的可观测性基础设施组件（VictoriaMetrics/Grafana/VictoriaLogs/Nginx 等），不包含 PostgreSQL 与 etcd。 适用于需要独立监控栈的场景，例如监控外部 PostgreSQL/RDS 实例或其他数据源。 配置概览 配置名称： infra 节点数量： 单节点或多节点 配置说明：仅安装可观测性基础设施，不包含 PostgreSQL 与 etcd 适用系统：el8, el9, el10, d12, d13, …

fat 配置模板是 Pigsty 的 功能全测试模板（Feature-All-Test），在单节点上安装所有扩展插件，并构建包含 PostgreSQL 14-18 全部五个大版本所有扩展的本地软件源。 这是一个用于测试与开发的全功能配置，适合需要完整软件包缓存或测试全部扩展的场景。 配置概览 配置名称： fat 节点数量： 单节点 配置说明：功能全测试模板，安装所有扩展，构建包含 PG 14-18 全版本的本地软件源 适用系统：el8, el9, el10, d12, d13, u22, …

slim 配置模板提供 精简安装 能力，在不部署 Infra 监控基础设施的前提下，直接从互联网安装 PostgreSQL 高可用集群。 当您只需要一个可用的数据库实例，不需要监控系统时，可以考虑使用 精简安装 模式。 配置概览 配置名称： slim 节点数量： 单节点 配置说明：精简安装配置模板，不部署监控基础设施，直接安装 PostgreSQL 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置 …

配置模板 rich 是 meta 的增强版本，专为需要完整功能体验的用户设计。 如果您希望构建本地软件源、使用 Silo 存储备份、运行 Docker 应用，或需要预置业务数据库，可以使用此模板。 配置概览 配置名称： rich 节点数量： 单节点 配置说明：功能丰富的单节点配置，在 meta 基础上增加本地软件源、Silo 备份、完整扩展、Docker 应用示例 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 …

meta 配置模板是 Pigsty 默认使用的模板，它的目标是在当前单节点上完成 Pigsty 核心功能 —— PostgreSQL 的部署。 为了实现最好的兼容性，meta 模板仅下载安装包含 最小必需 软件集合，以便在所有操作系统发行版与芯片架构上实现这一目标。 配置概览 配置名称： meta 节点数量： 单节点 配置说明：Pigsty 默认使用的单节点安装配置模板，带有较完善的关键配置参数说明，与最小可用功能集合。 适用系统：el8, el9, el10, d12, d13, u22, …

中国 PostgreSQL 生态项目影响力 GitHub Star 数降序排列，最后更新时间为北京时间 2026-08-13。 项目 Star 作者 类型 简介 pgsty/pigsty 5521 冯若航 @ PGSTY 发行版 开箱即用的 PostgreSQL 发行版 polardb/PolarDB-for-PostgreSQL 3191 阿里云 内核 阿里云开源 PolarDB for PostgreSQL 内核 tensorchord/pgvecto.rs 2181 TensorChord …

总体概览 以下成本数据用于说明量级差异，云厂商价格与折扣会随时间、区域、实例规格和采购方式变化。 EC2 核·月 RDS 核·月 DHH 自建核月价格（192C 384G） 25.32 初级开源数据库 DBA 参考工资 15K/人·月 IDC 自建机房（独占物理机: 64C384G） 19.53 中级开源数据库 DBA 参考工资 30K/人·月 IDC 自建机房（容器，超卖500%） 7 高级开源数据库 DBA 参考工资 60K/人·月 UCloud 弹性虚拟机（8C16G，有超卖） 25 …

与 RDS 对比 Pigsty 是使用 Apache-2.0 开源的本地优先 RDS 替代，可以部署在您自己的物理机/虚拟机上，也可以部署在云服务器上。 因此，我们选择了全球份额第一的亚马逊云 AWS RDS for PostgreSQL，以及中国市场份额第一的阿里云 RDS for PostgreSQL 作为参照对象。 阿里云 RDS 与 AWS RDS 均为闭源云数据库服务，通过租赁模式，仅在公有云上对外提供。以下云厂商信息是 2024 年 2 月的存档，基于当时的 PostgreSQL …

Pigsty 是什么，不是什么？ Pigsty 是一个 PostgreSQL 数据库发行版，本地优先的开源 RDS 云数据库解决方案。 Pigsty 不是数据库管理系统（DBMS），而是管理 DBMS 的工具，发行版，解决方案，与最佳实践。 类比：数据库是车，那么 DBA 是司机，RDS 是出租车服务，Pigsty 则是自动驾驶软件。 Pigsty 解决什么问题？ 用好数据库的能力 极为稀缺：要么高薪聘请数据库专家自建（雇司机），或从云厂商以天价租赁 RDS（打车），但现在你有新的选项 …

Pigsty 旨在聚集 PG 生态的合力，并用自动驾驶的数据库管控软件帮助用户用好世界上 最流行 的数据库 PostgreSQL。 尽管 Pigsty 本身已经解决了 PG 使用中的诸多问题。但想真正达到企业级服务的质量，原厂提供的专家支持与兜底服务不可或缺。 我们深知专业的商业支持服务对于企业客户的重要性，因此，Pigsty 企业版在开源版本的基础上提供了一系列增值服务，帮助用户更好地用好 PostgreSQL 与 Pigsty，供有需求的客户按需选用。 如果您有下列需求，欢迎考虑 …

根据 Google Analytics PV 与下载量，Pigsty 目前有约 10 万用户，一半来自中国大陆，一半来自全球其他地区。 遍布互联网、云计算、金融、自动驾驶、制造业、科技创新、ISV 与军工等多个行业。 如果您在 使用 Pigsty 并且愿意与我们分享您的案例与 Logo，欢迎联系我们，我们提供一次的免费咨询支持。 互联网 探探：两百台+物理机，用于 PostgreSQL 与 Redis 服务 哔哩：用于支持 PostgreSQL 创新业务 云厂商 Bitdeer：比特小鹿，提供 …

赞助我们 Pigsty 是一个开源免费的自由软件，由 PostgreSQL 社区成员用热情浇灌而成，旨在整合 PostgreSQL 生态的力量，推广 PostgreSQL 的普及。 如果我们的工作帮到了您，请考虑赞助或者支持一下我们的项目： 直接打钱赞助我们，用最直接有力的鼓舞表达您的真挚支持！ 考虑采购我们的 技术支持服务，我们可以提供专业的 PostgreSQL 高可用集群部署与维护服务，让您的预算花得物有所值！ 通过文章，讲座，视频分享您使用 Pigsty 的案例与经验。 允许我们在 “ …

协议摘要 Pigsty 项目主体使用 Apache-2.0 开源许可证；Pigsty 文档网站使用 CC by 4.0 许可证。 项目协议地址：https://github.com/pgsty/pigsty/blob/main/LICENSE Pigsty 项目主体 Pigsty 软件主体采用 Apache License 2.0 许可证。 这是一种宽松的开源许可证，允许您自由地使用、修改和分发本软件，包括用于商业目的，而无需公开您的源代码或使用相同许可证。 本协议授权您 本协议不提供 本协议的 …

Pigsty软件 当您安装 Pigsty 软件时，如果在网络隔离的环境中使用离线软件包安装，我们不会收到任何关于您的数据。 如果您选择在线安装，那么在下载相关软件包时，我们的服务器或云供应商的服务器会自动在日志中记录来访机器的 IP 地址和/或主机名，和您下载的软件包名称。 除非法律要求，我们不会与其他组织共享这些信息。（实话说，吃饱了撑着才会去看这些东西） Pigsty 使用的主域名为：pigsty.io，中国大陆请使用中文备案镜像站点 pigsty.cc。 Pigsty网站 当您访问我们的 …

GitHub 我们的 GitHub 仓库地址是：https://github.com/pgsty/pigsty，欢迎点个 ⭐️ 关注 我们。 我们欢迎任何人 提交新 Issue 或创建 Pull Request，提出功能建议并参与 Pigsty 贡献。 请注意，关于 Pigsty 文档的问题，请在 github.com/pgsty/pigsty.cc 仓库中提交 Issue。 在本站按 ⌘+ 加 K（macOS）或 Ctrl+ 加 K，可以直接搜索文档、扩展与博客文章。 维护者 Pigsty …

版本发布策略 Pigsty 使用语义化版本号，<主版本>.<次版本>.<修订号>。Alpha / Beta / RC 版本会在版本号后添加后缀，如 -a1，-b1，-c1。 主版本更新意味着不兼容的基础性变化与重大新特性；次版本更新通常表示普通功能特性更新，较小的 API 变动；修订版本更新意味着 Bug 修复与软件包版本更新。 Pigsty 计划每年发布一次主版本更新，次版本更新通常跟随 PostgreSQL 小版本更新节奏，在 PostgreSQL 新版本发布后最迟一个月内跟进。 …

访问控制由角色、对象权限、数据库 ACL 与 HBA 共同决定。本节聚焦配置参数；设计与边界见 访问控制概念。 Pigsty 预置了一套精简的 ACL 模型，通过以下参数描述： pg_default_roles：系统角色与系统用户。 pg_users：业务用户与角色。 pg_default_privileges：管理员/属主新建对象时的默认权限。 pg_revoke_public、pg_default_schemas、pg_default_extensions：控制 template1 的默认 …

PostgreSQL 参数可以在多个层级进行配置，不同层级的参数设置具有不同的作用范围和优先级。 Pigsty 支持在四个层级配置 PostgreSQL 参数，从全局到局部依次为： 层级 作用范围 配置方式 存储位置 集群级 整个集群所有实例 Patroni DCS / 调优模板 etcd + postgresql.conf 实例级 单个 PostgreSQL 实例 pg_parameters / ALTER SYSTEM postgresql.auto.conf 数据库级 特定数据库的所有会话 …

在本文中，“数据库”（Database） 指的是使用 SQL 命令 CREATE DATABASE 创建的，数据库集簇内的逻辑对象。 一组 PostgreSQL 服务器可以同时服务于多个 数据库 （Database）。在 Pigsty 中，你可以在集群配置中 定义 好所需的数据库。 Pigsty 会对默认模板数据库 template1 进行修改与定制，创建默认模式，安装默认扩展，配置默认权限，新创建的数据库默认会从 template1 继承这些设置。 您也可以通过 template 参数指定其 …

tiny.yml 是针对 微型实例 和资源受限环境优化的配置模板。适用于 1-3 核 CPU 的服务器，特点是最小化资源占用、保守的内存分配、禁用并行查询。 建议同时使用 node_tune = tiny 进行操作系统级别的配套调优。 适用场景 TINY 模板适用于以下场景： 开发测试：本地开发环境、CI/CD 测试 低配虚拟机：1-2 核 CPU、1-4GB 内存的云主机 边缘计算：树莓派、嵌入式设备 Demo 演示：快速体验 Pigsty 功能 个人项目：资源有限的个人博客、小型应用 资源限 …

在本文中，“用户”（User） 指的是使用 SQL 命令 CREATE USER/ROLE 创建的，数据库集簇内的逻辑对象。 在 PostgreSQL 中，用户直接隶属于数据库集簇而非某个具体的数据库。因此在创建业务数据库和业务用户时，应当遵循"先用户，后数据库"的原则。 Pigsty 通过两个配置参数定义数据库集群中的角色与用户： pg_default_roles：定义全局统一使用的角色和用户 pg_users：在数据库集群层面定义业务用户和角色 前者用于定义整套环境中共用的角色与用户，后者 …

crit.yml 面向一致性和审计要求较高的事务型业务。它强制启用数据校验和与 Patroni 严格同步模式，增加连接日志，并调整部分 WAL、超时和并行查询参数。 该模板会增加写入延迟，并可能在没有可用同步副本时阻塞写入。使用前应确认一致性目标、故障域、客户端提交设置和可用性要求。 建议同时评估 node_tune: crit，但主机调优与数据库参数可以独立选择。 使用方法 pg-critical: hosts: 10.10.10.11: { pg_seq: 1, pg_role: …

最近新闻 2026-07-10: Pigsty v4.4.0 正式发布！支持 PG19 Beta，扩展总数达到 531 发布说明：v4.4.0 主要变化：PostgreSQL 18.4 / 19 beta 支持、531 个扩展、内核与软件包更新，以及 Pig CLI 改进。 2026-05-01: Pigsty v4.3.0 正式发布！510 扩展，Ubuntu 26 支持 发布说明：v4.3.0 主要变化：Infra / PGSQL / 内核包批量更新，Ubuntu 26.04 离线包补齐， …

PostgreSQL 在不同操作系统上的软件包命名规则存在显著差异： EL 系统（RHEL/Rocky/Alma/…）使用 pgvector_18，postgis36_18* 这样的格式 Debian/Ubuntu 系统 使用 postgresql-18-pgvector，postgresql-18-postgis-3 这样的格式 这种差异给用户带来了额外的认知负担：您需要记住不同系统的包名规则，还要处理 PostgreSQL 版本号嵌入的问题。 软件包别名 Pigsty 通过 软件包别名 …

olap.yml 是针对 在线分析处理（OLAP）负载优化的配置模板。适用于 4-128 核 CPU 的服务器，特点是支持大查询、高并行度、宽松的超时设置和激进的 Vacuum 策略。 建议同时使用 node_tune = olap 进行操作系统级别的配套调优。 适用场景 OLAP 模板适用于以下场景： 数据仓库：历史数据存储、多维分析 BI 报表：复杂报表查询、仪表盘数据源 ETL 处理：数据抽取、转换、加载 数据分析：Ad-hoc 查询、数据探索 HTAP 混合负载：分析型从库 特征负载： …

在 Pigsty 中选择"内核"意味着确定 PostgreSQL 大版本、模式/发行版、需要安装的包以及要加载的调优模板。 Pigsty v4.5 当前源码支持 PostgreSQL 14 - 18，默认使用 18。下方内容展示如何通过配置文件完成这些选择。 大版本与软件包 pg_version：指定 PostgreSQL 主版本（默认 18）。Pigsty 会根据版本自动映射到正确的包名前缀。 pg_packages：定义需要安装的核心包集合，支持使用 包别名（默认 pgsql-main …

历史起源 Pigsty 项目始于 2018 ～ 2019 年，起源于 探探。 探探是一个互联网交友 App —— 中国的 Tinder，现已被陌陌收购。 探探这家公司是一个北欧风格的创业公司，有着一个瑞典工程师初创团队。 探探在技术上极有品味，使用 PostgreSQL 与 Go 作为核心技术栈。 探探整个系统架构参照 Instagram，一切围绕 PostgreSQL 数据库设计。 直到几百万日活，几百万 TPS，几百 TB 数据的量级下，数据组件 只用了 PostgreSQL。 几乎所有的 …

oltp.yml 是 Pigsty 的默认配置模板，针对 在线事务处理（OLTP）负载进行了优化。适用于 4-128 核 CPU 的服务器，特点是高并发连接、低延迟响应、高事务吞吐量。 建议同时使用 node_tune = oltp 进行操作系统级别的配套调优。 适用场景 OLTP 模板适用于以下场景： 电商系统：订单处理、库存管理、用户交易 社交应用：用户动态、消息推送、关注关系 游戏后端：玩家数据、排行榜、游戏状态 SaaS 应用：多租户业务系统 Web 应用：常规的 CRUD 操作密集型应 …

“PostgreSQL In Great STYle”: Postgres, Infras, Graphics, Service, Toolbox, it’s all Yours. —— 开箱即用、本地优先的 PostgreSQL 发行版，开源 RDS 替代 价值主张 可扩展性：海量扩展 开箱即用：深度整合 PostGIS、TimescaleDB、Citus、PGVector 等 575 插件与 12 款 PG 内核。 可靠性：快速创建 高可用、故障自愈的 PostgreSQL 集群，自动预置 …

根据需求场景选择合适的实例与集群类型，配置出满足需求的 PostgreSQL 数据库集群。 您可以定义不同类型的实例和集群，下面是 Pigsty 中常见的几种 PostgreSQL 实例/集群类型： 读写主库：定义单一实例集群。 只读从库：定义具有一个主库和一个副本的基本 HA 集群。 离线从库：定义专用于 OLAP/ETL/交互式查询的实例 同步备库：启用同步提交以确保没有数据丢失。 法定人数提交：使用多数同步提交获得更高的一致性级别。 备份集群：克隆现有集群并跟随它 延迟集群：克隆现有集群 …

Pigsty 默认提供了四套场景化参数模板，可以通过 pg_conf 参数指定并使用。 tiny.yml：为小节点、虚拟机、小型演示优化（模板标注为 1-3 核） oltp.yml：为 OLTP 工作负载和延迟敏感应用优化（4C8GB+）（默认模板） olap.yml：为 OLAP 工作负载和吞吐量优化（4C8G+） crit.yml：为数据一致性和关键应用优化（4C8G+） Pigsty 会针对这四种默认场景，采取不同的参数优化策略，如下所示： 内存参数调整 Pigsty 默认会检测系统的内存 …