分类: 参考

JupyterLab 是交互式 Notebook、终端与数据分析环境。Pigsty v4.5.0 有两种不同的部署方式： VIBE 模块：由 Ansible 和 systemd 管理，适合 v4.5.0 的完整开发沙箱。 app/jupyter：轻量的独立 Docker Compose 模板，本页介绍这一方式。 app/jupyter 不是默认 apps 清单项，且创建数据目录是独立步骤；不要直接假设 app.yml -e app=jupyter 能处理目录权限。 快速开始 BASH cd …

Dify 是一个生成式 AI 应用创新引擎和开源 LLM 应用开发平台。它提供从 Agent 构建到 AI 工作流编排、RAG 检索和模型管理的能力，帮助用户轻松构建和运营生成式 AI 原生应用程序。 Pigsty 提供对自托管 Dify 的支持，允许您使用单个命令部署 Dify，同时将关键状态存储在外部管理的 PostgreSQL 中。您可以在同一个 PostgreSQL 实例中使用 pgvector 作为向量数据库，进一步简化部署。 快速开始 为什么要自托管 安装 配置 检查清单 域名和 …

Odoo 是一个开源企业资源规划 (ERP) 软件，提供一整套业务应用程序，包括 CRM、销售、采购、库存、生产、会计和其他管理功能。Odoo 是一个典型的 Web 应用程序，使用 PostgreSQL 作为底层数据库。 您的所有业务，都在一个平台上，简单、高效且实惠 公开演示（不一定开放）：http://odoo.pigsty.io, 用户名: test@pigsty.io, 密码: pigsty 快速开始 在运行兼容操作系统的全新 Linux x86 / ARM 服务器上执行： BASH …

概览 GitHub 仓库地址：https://github.com/Vonng/pigsty-app/tree/master/cloud 在线 Demo 地址：https://demo.pigsty.cc/d/ecs 文章地址：《剖析算力成本：阿里云真降价了吗？》 数据源 Aliyun ECS 价格可以在 价格计算器 - 定价详情 - 价格下载 中获取 CSV 原始数据。 模式 下载 阿里云 价格明细并导入分析 SQL CREATE EXTENSION file_fdw; CREATE …

概览 GitHub 仓库地址：https://github.com/Vonng/pigsty-app/tree/master/db 在线 Demo 地址：https://demo.pigsty.cc/d/db-engine

概览 GitHub 仓库地址：https://github.com/Vonng/pigsty-app/tree/master/db 在线 Demo 地址：https://demo.pigsty.cc/d/sf-survey

公开 Demo 地址：http://wiki.pigsty.cc 太长;不看 BASH cd ~/pigsty/app/wiki && docker compose up -d 准备数据库 YAML # postgres://dbuser_wiki:DBUser.Wiki@10.10.10.10:5432/wiki - { name: wiki, owner: dbuser_wiki, revokeconn: true , comment: wiki the api gateway …

Gitea 是轻量级开源 Git 托管平台。 Pigsty 的 app/gitea 模板默认就是 PostgreSQL 外部数据库模式，通过 .env 中 GITEA_DB_* 参数连接数据库。 快速开始 BASH cd ~/pigsty/app/gitea vi .env # 检查域名、端口、数据库连接 make up 默认入口： Web：http://git.pigsty 或 http://<IP>:8889 SSH：<IP>:2222 数据库准备 BASH bin/pgsql-user …

PostgREST 可以将 PostgreSQL schema 直接暴露为 REST API。 Pigsty 提供 app/postgrest 模板，默认端口 8884。 快速开始 BASH cd ~/pigsty/app/postgrest vi .env # 检查 DB_URI / DB_SCHEMA / JWT make up 默认入口： http://<IP>:8884 若配置了入口域名，可通过 http://api.pigsty 访问 关键配置 .env 常用参数： …

Kong 是开源 API Gateway。 Pigsty 的 app/kong 模板使用 PostgreSQL 作为配置存储，并自动执行一次迁移任务（kong-migration）。 快速开始 BASH cd ~/pigsty/app/kong vi .env # 检查 KONG_PG_* 与端口配置 make 默认端口： Proxy HTTP：8000 Proxy HTTPS：8443 Admin API：8001 数据库准备 BASH bin/pgsql-user pg-meta …

PGLOG 是 Pigsty 自带的一个样例应用，固定使用 MetaDB 中 pglog.sample 表作为数据来源。您只需要将日志灌入该表，然后访问相关 Dashboard 即可。 Pigsty 提供了一些趁手的命令，用于拉取 csv 日志，并灌入样本表中。在元节点上，默认提供下列快捷命令： BASH catlog [node=localhost] [date=today] # 打印CSV日志到标准输出 pglog # 从标准输入灌入CSVLOG pglog12 # 灌入PG12格式的 …

PGWeb 客户端 PGWeb 是一款基于浏览器的 PostgreSQL 客户端。Pigsty 在 app/pgweb 中提供了一个小型 Docker Compose 模板，把容器的 8081 端口发布到主机的 8886 端口。 BASH cd ~/pigsty/app/pgweb make up # docker compose up -d 当 cli.pigsty 门户项解析到 Infra 节点时，可打开 http://cli.pigsty，也可以直接访问 …

Covid 是 Pigsty 自带的，用于展示世界卫生组织官方疫情数据大盘的一个样例 Applet。 您可以查阅每个国家与地区 COVID-19 的感染与死亡案例，以及全球的疫情趋势。 概览 GitHub 仓库地址：https://github.com/Vonng/pigsty-app/tree/master/covid 在线 Demo 地址：https://demo.pigsty.cc/d/covid 安装 在管理节点上进入应用目录，执行 make 以完成安装。 BASH make # 完成所 …

如果您拥有数据库后不知道干点什么，不妨参试试这个开源项目：Vonng/isd 您可以直接复用监控系统 Grafana，以交互式的方式查阅近30000个地面气象站过去120年间的亚小时级气象数据。 这是一个功能完成的数据应用，可以查询全球30000个地表气象站从1901年来的气象观测记录。 项目地址：https://github.com/Vonng/isd 在线 Demo 地址：https://demo.pigsty.cc/d/isd-overview 快速上手 克隆本仓库 BASH git …

本页覆盖把 pg_exporter 放进生产环境要做的事：进程参数与环境变量、监控用户与凭据管理、systemd / Docker / Kubernetes 三种部署形态、pgBouncer 与自动发现，以及 Prometheus 侧的抓取与告警配置。 进程级配置有两个来源，优先级从高到低： 命令行参数（--url、--config 等） 环境变量（每个参数都有对应的 PG_EXPORTER_* 变量） 指标采集行为则完全由 YAML 采集器定义驱动（默认 …

pg_exporter 在监听端口（默认 :9630）上暴露四类 HTTP 端点：指标、健康检查、流量路由与运维管理。全部端点如下： 端点 方法 描述 /metrics GET Prometheus 指标端点（路径可经 --web.telemetry-path 修改） /up GET 存活检查；别名 /health、/liveness、/readiness、/read /primary GET 主库检查；别名 /leader、/master、/read-write、/rw /replica …

pg_exporter 的所有业务指标都由 YAML 采集器（Collector）定义驱动：每个采集器就是一条 SQL 查询，外加它的执行条件（版本、角色、标签、谓词）与运行控制（缓存、超时）。本页是采集器定义的完整参考。 配置可以是单个 YAML 文件（如默认的 pg_exporter.yml），也可以是包含多个 YAML 文件的目录——官方默认配置包正是由 config/ 目录下 58 个定义文件合并而来。 配置加载 PG Exporter 按以下顺序搜索配置： 命令行参数 …

2026-08-14 名称 旧版本 新版本 备注 emailaddr 0 0 许可证元数据：LicenseRef-Upstream-No-License；r3；PG14-18 explain_ui 0.0.2 0.0.2 许可证元数据：LicenseRef-Upstream-No-License；r4；PG14-18 oidc_validator 0.1.0 0.1.0 Rust 模块；LicenseRef-Upstream-No-License；r2；PG18 …

2026-08-14 名称 旧版本 新版本 备注 asn1oid 1.6 1.6 许可证元数据：GPL-3.0-or-later；r2；PG14-18 emailaddr 0 0 许可证元数据：LicenseRef-Upstream-No-License；r3；PG14-18 explain_ui 0.0.2 0.0.2 许可证元数据：LicenseRef-Upstream-No-License；r4；PG14-18 numeral 1.3 1.3 许可证元数据 …

2026-08-12 名称 旧值 新值 备注 claude 2.1.226 2.1.227 通过代理下载并按官方清单核验，已构建双架构 RPM/DEB code-server 4.131.0 4.132.0 官方双架构 RPM/DEB 已下载并核验 grafana-infinity-ds 3.11.2 3.11.3 已构建双架构 RPM/DEB mtail 3.4.6 3.4.7 已构建双架构 RPM/DEB opencode 1.18.15 1.18.16 已构建双架构 RPM/DEB …

Consul 是一个分布式 DCS、KV、DNS 与服务注册/发现组件。 Pigsty 1.x 曾使用 Consul 作为高可用 DCS；当前开源源码树已经移除 Consul 角色、剧本和 consul_* 参数，不能使用本页旧版清单直接部署。当前 Pigsty 的 DCS 集成以 ETCD 模块为准。

DuckDB 是一个高性能，嵌入式的分析数据库。 DuckDB 是嵌入式数据库，不需要部署与服务化，只需要在节点上安装 DuckDB 软件包即可使用。 安装 当前 Pigsty 节点平台映射包含 duckdb 软件包，可通过 Infra 仓库直接安装： BASH ./node.yml -t node_install -e '{"node_repo_modules":"infra","node_packages":["duckdb"]}' 使用 pig 安装： BASH pig repo add …

TigerBeetle 是一个金融会计事务专用数据库，提供了极致性能与可靠性。 概览 当前开源源码树没有 TigerBeetle 角色或专用剧本，只在节点平台包映射中提供 tigerbeetle 安装别名；服务初始化与生命周期管理需按 TigerBeetle 官方文档完成。 安装 使用以下命令可从 Pigsty Infra 仓库安装映射的软件包： BASH ./node.yml -t node_install -e …

Kubernetes 是生产级无状态容器调度编排私有云平台。 Pigsty 提供了原生的 ETCD 集群支持，可以作为 Kubernetes 的外部 etcd 使用。 当前开源源码树没有 kube.yml 剧本、Kubernetes 角色或 kube_* 参数；Pigsty 在这里提供的是软件仓库与基础节点置备能力，集群初始化、网络插件、控制面和升级仍需由 kubeadm、SealOS 或其他 Kubernetes 工具完成。 SealOS SealOS 是一个 Kubernetes 发行版，可 …

当前 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 对选中集群执行「检查 → 安装 → 引导 → 接入 → 业务对象 → 备份 → 监控」的完整收敛： BASH ./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。示例： YAML 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。 监控架构 TEXT JuiceFS Mount (metrics: 0.0.0.0:<port>) ↓ VictoriaMetrics (scrape) ↓ Grafana Dashboard 若已部署 INFRA，juice_register 会自动写入抓取目标： TEXT …

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

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

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 与原生集群模式，并复用相同的配置路径、实例服务名、监控和日志入口。 YAML 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 兼容接口使用它。 部署集群 首先在 配置清单 中定义单机单盘对象存储集群，并显式锁定引擎： YAML minio: { hosts: { 10.10.10.10: { minio_seq: 1 } }, vars: { minio_cluster: minio, minio_type: silo } } 然后，针对定义的分组（这里为 minio）执行 Pigsty 提供的 minio.yml 剧本即可： BASH …

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 地址。 YAML 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 等）。 添加仓库 BASH # 添加 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 组中。 BASH sudo usermod -aG admin <username> PGSQL初始化失败：Fail to wait for …

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

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

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

部分扩展需要预加载动态库或配置参数后才能使用，本节介绍如何配置扩展。 预加载扩展 大多数扩展安装后可直接使用 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 中，您可以使用不同 “风味” 的 PostgreSQL 分支替换 “原生 PG 内核”，实现特殊的功能与效果。 Pigsty 支持多种 PostgreSQL 内核和兼容分支，让您能够在同一套运维体系中获得兼容性、多主复制、图查询、MPP 数仓、透明加密等不同能力。 需要注意的是，不同内核在 Pigsty 中的交付深度并不完全一致： 像 PostgreSQL、Citus、Babelfish、IvorySQL、PolarDB、AgensGraph、pgEdge 已经有较明确的模板与 …

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 中使用扩展涉及四个核心步骤：下载、安装、配置/加载 与 启用。 YAML 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 BASH ./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 BASH ./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 BASH ./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 启用方式： BASH cp …

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 BASH ./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 启用方式： BASH ./configure -c …

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

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

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

app/jumpserver 配置模板部署 JumpServer Community Edition，并使用 Pigsty 托管的 PostgreSQL 18 作为外部数据库。当前模板按 JumpServer v4.10.16-ce 验证。 配置概览 配置名称：app/jumpserver 节点数量：单节点 Web 端口：8080 SSH 端口：2222 相关配置：meta 启用方式： BASH ./configure -c app/jumpserver [-i <primary_ip>] 配置 …

app/immich 配置模板部署 Immich，并使用 Pigsty 托管的 PostgreSQL 18 保存元数据与向量索引。当前模板按 Immich v3.0.1 验证。 配置概览 配置名称：app/immich 节点数量：单节点 应用端口：2283 数据目录：/data/immich/library 相关配置：meta、app/registry 启用方式： BASH ./configure -c app/immich [-i <primary_ip>] 配置内容 源文件地址 …

app/hindsight 配置模板用于部署 Hindsight，并将其内置开发数据库替换为 Pigsty 托管的外部 PostgreSQL。 更多细节请参考：Hindsight 部署教程 配置概览 配置名称： app/hindsight 节点数量：单节点 配置说明：部署 Hindsight all-in-one 容器，创建外部 PostgreSQL 数据库，并配置 UI/API 两个入口 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构 …

app/insforge 配置模板用于部署 InsForge OSS，并使用 Pigsty 托管的 PostgreSQL 作为外部数据库。 更多细节请参考：InsForge 部署教程 配置概览 配置名称： app/insforge 节点数量：单节点 配置说明：部署 InsForge App、PostgREST、Deno Runtime，并创建所需 PostgreSQL 用户、角色、数据库与扩展 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构 …

app/registry 配置模板提供了部署 Docker Registry 镜像代理的参考配置，可用作 Docker Hub 镜像加速或私有镜像仓库。 配置概览 配置名称： app/registry 节点数量： 单节点 配置说明：部署 Docker Registry 镜像代理和私有仓库 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式： BASH ./configure -c …

app/mattermost 配置模板用于部署 Mattermost，默认将应用与数据库放在同一节点，使用 Pigsty 提供 PostgreSQL、Nginx 与监控能力。 配置概览 配置名称： app/mattermost 节点数量： 单节点（默认） 配置说明：Mattermost + PostgreSQL + Docker 的开箱即用模板。 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置 …

app/teable 配置模板提供了部署 Teable 开源无代码数据库的参考配置，使用 Pigsty 托管的 PostgreSQL 作为数据库。 配置概览 配置名称： app/teable 节点数量： 单节点 配置说明：使用 Pigsty 托管的 PostgreSQL 部署 Teable 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式： BASH ./configure -c …

app/maybe 配置模板提供了部署 Maybe 开源个人财务管理系统的参考配置，使用 Pigsty 托管的 PostgreSQL 作为数据库。 配置概览 配置名称： app/maybe 节点数量： 单节点 配置说明：使用 Pigsty 托管的 PostgreSQL 部署 Maybe 财务管理 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式： BASH ./configure -c …

app/electric 配置模板提供了部署 Electric SQL 实时同步服务的参考配置，实现 PostgreSQL 到客户端的实时数据同步。 配置概览 配置名称： app/electric 节点数量： 单节点 配置说明：使用 Pigsty 托管的 PostgreSQL 部署 Electric 实时同步 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式： BASH …

app/dify 配置模板提供了自建 Dify AI 应用开发平台的参考配置，使用 Pigsty 托管的 PostgreSQL 和 pgvector 作为向量存储。 更多细节，请参考 Dify 部署教程 配置概览 配置名称： app/dify 节点数量： 单节点 配置说明：使用 Pigsty 托管的 PostgreSQL 部署 Dify 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式 …

app/odoo 配置模板提供了自建 Odoo 开源 ERP 系统的参考配置，使用 Pigsty 托管的 PostgreSQL 作为数据库。 更多细节，请参考 Odoo 部署教程 配置概览 配置名称： app/odoo 节点数量： 单节点 配置说明：使用 Pigsty 托管的 PostgreSQL 部署 Odoo ERP 适用系统：el8, el9, el10, d12, d13, u22, u24, u26 适用架构：x86_64, aarch64 相关配置：meta 启用方式： BASH …

supabase 配置模板提供了自建 Supabase 的参考配置，使用 Pigsty 托管的 PostgreSQL 作为底层存储。 更多细节，请参考 Supabase 自建教程 配置概览 配置名称： supabase 节点数量： 单节点 配置说明：使用 Pigsty 托管的 PostgreSQL 自建 Supabase 适用系统：el8, el9, d12, u22, u24, u26 适用架构：x86_64, aarch64 PostgreSQL：15, 16, 17, 18（模板默认 …

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 启用方式： BASH ./configure -c ha/dual [-i <primary_ip>] 配 …

Electric 是 PostgreSQL 同步引擎，专注于将数据库变更高效分发到前端/边缘应用。 Pigsty 提供了 app/electric 配置模板（conf/app/electric.yml），可一键完成数据库、容器与入口配置。 快速开始 BASH curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty ./bootstrap ./configure -c app/electric vi pigsty.yml # 修改域名、密 …

三节点是实现多数派高可用的最小规格。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 生成配置： BASH …

上手路线 顺序 要解决的问题 入口 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, …

JumpServer 是开源 PAM / 堡垒机系统，用于集中管理 SSH、RDP、数据库与 Web 资产访问。 Pigsty 的 app/jumpserver 模板使用 Docker Compose 运行 JumpServer 社区版应用层，并使用 Pigsty 托管的 PostgreSQL 作为持久后端数据库。 当前模板基于 JumpServer v4.10.16-ce，保留社区版 core、celery、koko、lion、chen、web 与本地 Redis，移除上游安装器中的内置 …

Pigsty 提供 app/registry 配置模板（conf/app/registry.yml），用于部署： Docker Registry 缓存服务（默认 5000） 可选管理 UI（默认 5080） 快速开始 BASH curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty ./bootstrap ./configure -c app/registry vi pigsty.yml # 修改域名、证书与端口（如需） …

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 启用方式： BASH ./configure -c ha/simu [-i …

Metabase 是一个快速、易用的开源商业智能工具，让您的团队无需 SQL 知识即可探索和可视化数据。 Metabase 提供友好的用户界面和丰富的图表类型，支持连接多种数据库，是企业数据分析的理想选择。 快速开始 在 Pigsty 软件模板目录中提供了 Metabase 的 Docker Compose 配置文件： BASH cd ~/pigsty/app/metabase 检查并修改 .env 配置文件： BASH vim .env # 检查配置，建议修改默认凭据 启动服务： BASH …

Immich 是高性能自托管照片与视频管理应用，也是最流行的 Google Photos 开源替代品之一。 它提供 Web 与移动端上传、相册共享、时间线、地图、EXIF、RAW、LivePhoto、语义搜索、人脸识别与自动备份等能力，采用 AGPL-3.0 许可证。 Pigsty 的 app/immich 模板使用 Docker Compose 拉起 Immich 应用层，并使用 Pigsty 托管的 PostgreSQL 保存元数据。 当前模板按 Immich v3 组织，默认使用 …

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

Maybe 是一个开源个人财务管理应用，可以用于维护账户、交易、预算、投资与家庭财务视图。Maybe 是典型的 Rails Web 应用，生产环境使用 PostgreSQL 保存业务数据，并使用 Redis 处理后台任务队列。 Pigsty 提供 app/maybe 模板，将 Maybe 的无状态 Web / Worker 容器接入 Pigsty 托管的 PostgreSQL，并用本地 Redis 承载 Sidekiq 队列。这样您可以把最重要的财务数据放在可备份、可监控、可恢复的 …

Mattermost 是开源团队协作平台，可作为 Slack 的私有化替代方案。 Pigsty 提供 app/mattermost 配置模板（conf/app/mattermost.yml），默认将应用状态存放到外部 PostgreSQL，并将文件目录持久化到主机路径。 快速开始 BASH curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty ./bootstrap ./configure -c app/mattermost vi …

Teable 是面向团队协作的无代码数据库平台。 Pigsty 提供 app/teable 模板（conf/app/teable.yml），默认依赖 PostgreSQL + Silo + Docker（不依赖 Redis）。 快速开始 BASH curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty ./bootstrap ./configure -c app/teable vi pigsty.yml # 修改密码、域名、邮件参数 …

NocoDB 是一个开源的 Airtable 替代方案，可以将任何数据库转变为智能电子表格。 它提供了丰富的用户界面，让您无需编写代码即可创建强大的数据库应用。NocoDB 支持 PostgreSQL、MySQL、SQL Server 等多种数据库，是构建内部工具和数据管理系统的理想选择。 快速开始 在 Pigsty 软件模板目录中提供了 NocoDB 的 Docker Compose 配置文件： BASH cd ~/pigsty/app/nocodb 检查并修改 .env 配置文件（根据需要调 …

FerretDB 在 PostgreSQL 与 DocumentDB 扩展之上提供 MongoDB 兼容协议。Pigsty 的 app/ferretdb 只运行无状态协议代理；PostgreSQL、postgres 数据库、DocumentDB 扩展与后端登录用户必须预先存在，mongo 配置模板 会一次性准备这些依赖。 快速开始 BASH curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty ./bootstrap …

Hindsight 是面向 AI Agent 的 PostgreSQL-native 长期记忆服务。 Pigsty 提供 app/hindsight 配置模板（conf/app/hindsight.yml），默认使用 Pigsty 托管的 PostgreSQL，而不是 Hindsight 内置的开发数据库。 快速开始 BASH curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty ./bootstrap ./configure -c …

InsForge 是面向 AI 编程代理的开源 Backend-as-a-Service 平台。它以 PostgreSQL 为核心，提供认证、数据库 API、文件存储、模型网关、边缘函数、站点部署和支付集成等能力，让应用可以跳过大部分后端样板代码。 Pigsty 提供 app/insforge 配置模板，将 InsForge OSS 的无状态服务运行在 Docker Compose 中，并把最关键的状态放入 Pigsty 托管的 PostgreSQL。这样可以继续使用 Pigsty 的高可用、备 …

Supabase 很好，拥有属于你自己的 supabase 则好上加好。 Pigsty 可以帮助您在自己的服务器上（物理机/虚拟机/云服务器），一键自建企业级 supabase —— 更多扩展，更好性能，更深入的控制，更合算的成本。 截至 2026-08，Supabase 的 官方自托管文档 推荐 Docker，并将其他实现归为社区项目；Pigsty 是独立的社区集成，目前不在该页面的项目列表中。 本教程需要您有 Linux 基础知识，否则建议直接使用 Supabase 云服务或 “Docker …

Pigsty 的“应用”分为两类： 软件模板（Software Templates）：~/pigsty/app/<name> 下的 Docker Compose 模板，用于拉起无状态业务组件。 数据应用（Applets）：基于 PostgreSQL + Grafana 的分析样例，偏教学/演示属性。 应用模型 推荐使用以下流程部署应用： BASH curl -fsSL https://repo.pigsty.cc/get | bash; cd ~/pigsty ./bootstrap …

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 启用方式： BASH ./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 启用方式： BASH ./configure -c …

本文是 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 启用方式： BASH ./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 启用方式： BASH …

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

当前版本暂未提供 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 启用方式： BASH ./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 启用方式： BASH ./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, …

原始页面： pgBackRest Command Docs: version 显示已安装的 pgBackRest 版本。 命令选项 输出格式选项（--output） 输出类型。 支持以下输出类型： text — 以文本形式显示已安装的 pgBackRest 版本。 num — 以整数形式显示已安装的 pgBackRest 版本。 YAML default: text example: --output=num

原始页面：https://patroni.readthedocs.io/en/latest/releases.html Version 4.1.4 发布于 2026-07-07 错误修复 使用 systemd 软件包前检查 NOTIFY_SOCKET 环境变量（Polina Bungina） 仅当 NOTIFY_SOCKET 环境变量已设置时，才尝试导入并使用该软件包，以免触发 FileNotFoundError: [Errno 2] No such file or directory 异常。 …

原始页面： pgBackRest Command Docs: verify verify 用于验证仓库中的备份和归档是否有效。 命令选项 输出格式选项（--output） 输出类型。 支持以下输出类型： none — 不输出验证信息。 text — 将验证信息输出到标准输出。 YAML default: none example: --output=text 备份集选项（--set） 要验证的备份集。 验证与指定备份集关联的所有数据库文件和归档文件。 YAML example: …

pig pitr 命令用于通过 pgBackRest 执行时间点恢复，并以保守方式处理本地 PostgreSQL 与 Patroni 生命周期。与底层的 pig pb restore 不同，pig pitr 会先做恢复前检查，必要时停止 Patroni 与 PostgreSQL，执行 restore，然后按参数决定是否启动 PostgreSQL。 请注意：对于托管的默认数据目录，pig pitr 恢复后会让 Patroni 保持停止。请先验证恢复结果，再由人工恢复 Patroni 管理；该命令不 …

原始页面： https://patroni.readthedocs.io/en/latest/faq.html 本节收录了关于 Patroni 最常见问题的解答，各子节聚焦于不同类别的问题。 希望这些内容能帮你解答大多数疑问。如果仍有疑问或遇到意外问题，请参阅 chatting 和 reporting_bugs，了解如何获取帮助或提交问题报告。 与其他高可用方案的比较 为什么 Patroni 需要独立的 DCS 节点集群，而 repmgr 等其他方案不需要？ 实现高可用方案有多种不同方式，各有 …

原始页面： pgBackRest Command Docs: stop 禁止任何新的 pgBackRest 进程运行。默认情况下，正在运行的进程将被允许正常完成。使用 --force 选项可强制终止正在运行的进程。 stop 命令执行完成后，此后尝试运行的 pgBackRest 进程将返回错误。详情与示例请参见 启动与停止。 命令选项 强制停止选项（--force） 强制停止所有 pgBackRest 进程。 此选项会向所有正在运行的 pgBackRest 进程发送 TERM 信号，实现立即的 …

pig pgbackrest 命令（别名 pig pb）用于管理 pgBackRest 备份，并提供低层 restore 原语。 它封装了常用的 pgbackrest 操作，提供简化的备份管理体验。所有命令均以数据库超级用户身份（默认 postgres）执行。 托管集群的编排式时间点恢复请优先使用 pig pitr。 BASH pig pb - Manage pgBackRest backup and point-in-time recovery. Information: pig pb …

中国 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 …

原始页面： pgBackRest Command Docs: start 如果 pgBackRest 进程之前已通过 stop 命令停止，可使用 start 命令重新允许它们运行。注意，此命令不会立即启动任何 pgBackRest 进程，只是解除运行限制。详情与示例请参见 启动与停止。 通用选项 允许以 root 用户运行选项（--allow-root） 允许命令以 root 用户运行。 默认情况下，仅 restore 命令可以由 root 用户运行，因为该命令会谨慎管理文件所有权。以 …

pig patroni 命令（别名 pig pt）自 v1.6.0 起是已安装 patronictl 的 透明启动器： pig 只负责选择配置文件与少量本地辅助命令，其余一切命令与参数 原样转发 给 patronictl， 使用原生的参数、交互确认、输出与退出码——patronictl 的新功能无需等待 pig 发版即可使用。 BASH pig pt transparently launches the installed patronictl binary. Pig only owns …

Pigsty 当前最新版本为 v4.5.0。 版本 发布日期 摘要 发布页面 v4.5.0 2026-08-15 Silo、Kafka、MySQL、Valkey、575 个扩展与安全编排改进 v4.5.0 v4.4.0 2026-07-10 PG 19 beta 支持，531 个扩展，内核更新与 Pig CLI 改进 v4.4.0 v4.3.0 2026-05-01 510 扩展，Infra / PGSQL / 内核包批量更新，Ubuntu 26 支持 v4.3.0 v4.2.2 …

原始页面： pgBackRest Command Docs: stanza-upgrade 将 PostgreSQL 升级到新的主版本后，必须立即将所有 pgBackRest 配置中的 pg-path 更新为新的数据库位置，然后运行 stanza-upgrade 命令。若主机上配置了多个仓库，每个仓库都会执行 stanza 升级。若数据库处于离线状态，请使用 --no-online 选项。 命令选项 在线选项（--online） 在线更新集群。 指定 --no-online 可阻止 …

pig pg 命令（别名 pig postgres）用于管理本地 PostgreSQL 服务器和数据库。它封装了 pg_ctl、psql、vacuumdb 等本地原语；集群级 Patroni 操作请使用 pig pt，编排式 PITR 请使用 pig pitr。 BASH pig pg - Local PostgreSQL primitives (pg_ctl / psql / local files). Server Control (via pg_ctl): pig pg init [-v …

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

pig inventory 命令组（别名 pig inv）自 v1.6.0 起提供，用于以 无损 方式检视、编辑、 校验与体检 Pigsty 配置清单（pigsty.yml），并可通过实验性的 cmdb 子命令与 PostgreSQL CMDB 交换配置。 无损引擎会逐字节保留 YAML 的注释、格式、键序、锚点与换行风格；edit 在写盘前重新解析整个文档并原子写入， 非法 YAML 不可能落盘。 BASH Inspect, edit, validate, check, and …

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

原始页面： pgBackRest Command Docs: stanza-delete stanza-delete 命令用于删除仓库中与指定 stanza 关联的所有数据。stanza 是 pgBackRest 中用于标识一个 PostgreSQL 集群备份配置的逻辑名称。 警告： 此命令会永久删除指定 stanza 在 pgBackRest 仓库中的所有备份和归档数据，请谨慎使用。 删除 stanza 的步骤如下： 停止与该 stanza 关联的 PostgreSQL 集群（或使用 …

pig 也可作为 Pigsty 的命令行工具使用 —— 这是一款开箱即用的免费 PostgreSQL RDS 解决方案。 它为你的 PostgreSQL 集群带来高可用（HA）、PITR、监控、基础设施即代码（IaC）以及丰富的扩展支持。 BASH pig sty - Init (Download), Bootstrap, Configure, and Deploy Pigsty pig sty init [-mpfvd] # install pigsty (~/pigsty by …

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

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

原始页面： pgBackRest Command Docs: stanza-create stanza-create 命令须在 pgbackrest.conf 中完成 stanza 配置后再执行（stanza 是 pgBackRest 中用于标识一个 PostgreSQL 集群备份配置的逻辑名称）。若配置了多个仓库，stanza-create 会在每个仓库上分别建立 stanza。已创建的 stanza 会被跳过，因此即便新增了仓库，也可以随时安全地重复执行 stanza-create。 更多 …

协议摘要 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网站 当您访问我们的 …

原始页面： pgBackRest Command Docs: server-ping 向 pgBackRest TLS 服务器发送 ping，确认其正在接受连接。此命令仅作为存活性检查，不进行身份验证。 若命令行中未指定主机，则使用 tls-server-host 选项的值。 命令选项 TLS 服务器地址选项（--tls-server-address） TLS 服务器地址。 服务器监听客户端请求的 IP 地址。 YAML default: localhost example: …

pig build 命令是一个强大的工具，简化了从源码构建 PostgreSQL 扩展的整个工作流程。它提供了完整的构建基础设施设置、依赖管理，以及标准和自定义 PostgreSQL 扩展在不同操作系统上的编译环境。 BASH pig build - Build Postgres Extension Environment Setup: pig build spec # init build spec and directory (~ext) pig build repo # init …

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 新版本发布后最迟一个月内跟进。 …

原始页面： pgBackRest Command Docs: server pgBackRest 服务器允许在不使用 SSH 协议的情况下访问远程主机。 命令选项 TLS 服务器地址选项（--tls-server-address） TLS 服务器地址。 服务器监听客户端请求的 IP 地址。 YAML default: localhost example: --tls-server-address=* TLS 服务器授权客户端选项（--tls-server-auth） TLS 服务器授权客户端。 …

pig ext 命令是一个用于管理 PostgreSQL 扩展的全能工具。它允许用户搜索、安装、移除、更新和管理 PostgreSQL 扩展，甚至支持内核包的管理。 BASH pig ext - Manage PostgreSQL Extensions pig repo add -ru # add all repo and update cache (brute but effective) pig ext add pg18 # install optional postgresql 18 …

Source: pgBackRest Command Docs: restore restore 命令默认从第一个存有备份的仓库中自动选取最新备份（参见 快速开始 - 恢复备份）。仓库的检查顺序由 pgbackrest.conf 决定（例如先检查 repo1，再检查 repo2）。若要从特定仓库恢复，可使用 --repo 选项（例如 --repo=1）。若需恢复非最新的备份，可传入 --set 选项。 使用 --type=time 或 --type=lsn 进行 PITR（时间点恢复）时，必须 …

pig repo 命令是一个综合性的软件包仓库管理工具。它提供了添加、移除、创建和管理软件仓库的功能，支持 RPM 系统（RHEL/CentOS/Rocky/Alma）和 Debian 系统（Debian/Ubuntu）。 BASH pig repo - Manage Linux APT/YUM Repo pig repo list # available repo list (info) pig repo info [repo|module...] # show repo info …

原始页面： pgBackRest Command Docs: repo-ls repo-ls 类似于 Unix 的 ls 命令，但支持所有 pgBackRest 仓库类型。该命令接受一个路径参数，可以是绝对路径，也可以是相对于 --repo-path 所定义的仓库根路径的相对路径。此命令主要用于管理、排查和测试场景，并非常规部署的必要命令。 默认以文本格式输出，每行一个文件名。指定 --output=json 可切换为 JSON 格式。 若配置了多个仓库，默认操作优先级最高的仓库（如 …

pig CLI 提供了全面的工具集，用于管理 PostgreSQL 安装、扩展、软件仓库以及从源码构建扩展。使用 pig help <command> 查看命令文档。 pig repo：管理软件仓库 pig ext：管理 PostgreSQL 扩展 pig build：从源码构建扩展 pig install：使用原生包管理器安装包，并对 PostgreSQL 别名做翻译 pig sty：管理 Pigsty 安装与 Grafana 仪表盘 pig inventory：检视、编辑、校验与交换 …

原始页面： pgBackRest Command Docs: repo-get repo-get 命令类似于 Unix 的 cat 命令，但支持所有仓库类型。使用此命令需要提供完整的文件名，主要用于管理、排查和测试目的，不是常规 pgBackRest 使用流程中的必需命令。 若仓库已加密，repo-get 将自动解密文件。文件不会自动解压，但可将输出通过管道传递给相应的解压命令，例如 gzip -d。 若配置了多个仓库，命令默认使用优先级最高的仓库（如 repo1），除非通过 --repo 选 …

原始页面： https://www.pgbouncer.org/faq.html 如何连接到 PgBouncer？ PgBouncer 扮演 PostgreSQL 服务器的角色，只需将客户端指向 PgBouncer 端口即可。 如何在多个服务器之间实现查询负载均衡？ PgBouncer 没有内置的多主机配置功能，但可以通过外部工具实现： DNS 轮询。在一个 DNS 名称后面配置多个 IP。PgBouncer 不会在每次新建连接时查询 DNS，而是缓存所有 IP 并在内部进行轮询。注意：若一个 …

原始页面： pgBackRest Command Docs: info info 命令可查询单个 stanza（stanza 是 pgBackRest 中用于标识一个 PostgreSQL 集群备份配置的逻辑名称）或所有 stanza 的信息。默认输出为文本格式，以人类可读的摘要展示所请求 stanza 的备份信息。该格式可能随版本更新而变化。 如需机器可读输出，请使用 --output=json。JSON 输出包含的信息远多于文本格式，且除非发现缺陷，其格式保持稳定。 若只需快速查看进度信息 …

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

原始页面： https://pgbackrest.org/faq.html 简介 常见问题解答旨在针对一些具体问题提供详细说明，这些问题可能未在用户指南、配置参考或命令参考中涵盖。如果在此处找不到您的问题，pgBackRest 在 GitHub 上的 Issues List 也是一个宝贵的资源。 遇到"could not find WAL segment"错误该怎么办？ 此错误可能有多种原因，包括但不限于： archive_command 配置错误 pgBackRest 配置文件配置错误 网络 …

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

来源： https://www.pgbouncer.org/changelog.html PgBouncer 1.25.x 2026-05-08 - PgBouncer 1.25.2 - “Human touch with fresh twist in title race full of uncertainties（充满不确定性的冠军争夺战中，人情味带来新意）” 安全 修复 CVE-2026-6664：PgBouncer 1.25.2 之前的网络包解析代码存在整数溢出，会绕过边界检查并可能导 …

原始页面： pgBackRest Command Docs: help help 命令提供三个层级的帮助信息：未指定命令时显示通用帮助；指定命令（例如 pgbackrest help backup）时显示该命令的完整说明及有效选项列表；在命令之外还指定了某个选项（例如 pgbackrest help backup type）时显示该选项在此命令下的完整说明。 命令选项 显示帮助选项（--help） 显示帮助信息。 即使未指定 help 命令也会显示帮助信息，且优先于 --version 选项。 …

原始页面： https://pgbackrest.org/release.html 简介 pgBackRest 的版本号由主版本号和次版本号两部分组成。主版本升级 可能 破坏与上一主版本的兼容性，但 v2 版本与 v1 仓库完全兼容，且接受所有 v1 选项。次版本可包含漏洞修复和新功能，但不会更改仓库格式，并尽量避免修改选项和命名约定。v1 版本的文档可在 此处 查阅。版本说明中还可能包含"附加说明"，此部分变更仅涉及文档或测试套件，不直接影响 pgBackRest 代码库。 当前稳定版本 …

原始页面： pgBackRest Command Docs: expire pgBackRest 基于保留策略对全量备份进行轮换，策略可按数量或时间段定义。按数量保留时，过期操作只关注需要保留的备份数量，不考虑备份的创建时间。差异备份按数量进行保留，但当其依赖的全量备份过期时，差异备份也会随之过期。增量备份没有独立的保留策略——它们始终随关联的全量备份或差异备份一同过期。详情及示例请参见 全量备份保留策略 和 差异备份保留策略 章节。 默认情况下，未过期备份对应的已归档 WAL 会被保留。如有 …

原始页面： https://www.pgbouncer.org/downloads/ PgBouncer 1.25 File Date Size SHA256 pgbouncer-1.25.2.tar.gz 2026-05-08 865371 bytes sha256 pgbouncer-1.25.1.tar.gz 2025-12-03 864801 bytes sha256 pgbouncer-1.25.0.tar.gz 2025-11-09 863322 bytes sha256 …

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

原始页面： https://pgbackrest.org/configuration.html 简介 pgBackRest 可以完全通过命令行参数使用，但当配置较为复杂或需要设置大量选项时，使用配置文件更为实用。配置文件的默认路径为 /etc/pgbackrest/pgbackrest.conf。若该路径下不存在配置文件，则会检查旧的默认路径 /etc/pgbackrest.conf。 以下是支持的选项类型： String（字符串）：文本字符串，常见用途包括标识符、密码等。 命令行示例 …

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

原始页面： https://patroni.readthedocs.io/en/latest/patronictl.html Patroni 提供了 patronictl 命令行工具，用于与 Patroni 的 REST API 和 DCS 交互，旨在简化集群操作，适合人工操作或脚本调用。 配置 patronictl 使用以下 3 个配置节： ctl：用于对 Patroni REST API 进行认证以及验证服务器身份，详见 ctl 配置参数； restapi：同样用于认证和验证服务器身份，仅 …

原始页面： pgBackRest Command Docs: check check 命令用于验证 pgBackRest 及 archive_command 的配置是否正确，确保指定 stanza（stanza 是 pgBackRest 中用于标识 PostgreSQL 集群备份配置的逻辑名称）的归档与备份能够正常运作。该命令会对当前主机上为该 stanza 配置的所有仓库和数据库逐一检查，可检测出配置错误——尤其是归档配置问题，此类问题会导致所需的 WAL 段无法进入归档，从而造成备份不完整 …

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

原始页面： https://pgbackrest.org/command.html 简介 pgBackRest 通过命令来执行各项功能。本文档对每个命令的选项进行了详尽列举——即每个适用于某命令的选项都会随该命令一并列出，即便该选项同样适用于其他命令。所有可在 pgbackrest.conf 中配置的选项均包含在内。 在 pgbackrest.conf 中配置的非布尔型选项，可在命令行上使用 reset- 前缀将其重置为默认值。这一功能在直接于仓库主机上执行恢复时很有用。通常情况下 …

最新稳定版本是 v1.8.0。 版本 日期 摘要 GitHub v1.8.0 2026-08-14 原生 sty boot 与 sty conf，575 个已打包扩展 v1.8.0 v1.7.0 2026-08-12 EL 模块策略、中国镜像与 EL7 兼容目录，575 个扩展 v1.7.0 v1.6.2 2026-08-11 572 个扩展，Grafana schema v2，SOW 优先的软件仓库生成 v1.6.2 v1.6.1 2026-07-30 扩展目录刷新，内置 Pigsty 版本对 …

原始页面： https://patroni.readthedocs.io/en/latest/rest_api.html Patroni 提供了丰富的 REST API，供 Patroni 自身在主库竞选期间调用，也供 patronictl 工具执行故障转移、主从切换、重新初始化、重启和重载等操作，还可供 HAProxy 或其他负载均衡器执行 HTTP 健康检查，以及用于监控目的。以下是 Patroni REST API 端点的完整列表。 健康检查端点 对于所有健康检查 GET 请求 …

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

Source: pgBackRest Command Docs: backup 配置多个仓库时，pgBackRest 默认备份到优先级最高的仓库（如 repo1），除非通过 --repo 选项明确指定目标仓库。 pgBackRest 本身不内置调度器，建议通过 cron 或其他调度机制触发备份。 详情与示例请参见 执行备份。 命令选项 备份注解选项（--annotation） 为备份附加用户自定义的键值对注解。 可为备份附加任意键值对信息，此选项可多次使用以添加多个注解。 通过 --set 指 …

最近新闻 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 离线包补齐， …

原始页面： https://patroni.readthedocs.io/en/latest/ENVIRONMENT.html 可以使用系统环境变量覆盖 Patroni 配置文件中定义的部分配置参数。本文档列出了 Patroni 处理的所有环境变量。通过环境变量设置的值始终优先于配置文件中的值。 全局/通用 PATRONI_CONFIGURATION：可通过 PATRONI_CONFIGURATION 环境变量为 Patroni 提供完整配置。设置此变量后，其他所有环境变量将被忽略！ …

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

原始页面： https://patroni.readthedocs.io/en/latest/patroni_configuration.html Patroni 的配置分为 3 种类型： 全局 动态配置。 这些选项存储在 DCS（分布式配置存储）中，并应用于集群的所有节点。动态配置可以随时通过 patronictl edit-config 工具或 Patroni REST API 进行设置。如果更改的选项不属于启动配置，它们将异步地（在下一个唤醒周期时）应用到每个节点，随后触发重载。如果节点 …

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

原始页面： pgBackRest Command Docs: archive-push 接收来自 PostgreSQL 的 WAL 段，并将其归档到各个仓库中（仓库路径由带索引的 repo-path 选项定义，详见 仓库选项 章节）。WAL 段可以立即推送到归档，也可以根据 archive-async 的值先暂存在本地。配置了多个仓库时，archive-push 会尽量向所有仓库推送。 archive-push 由 PostgreSQL 负责配置和调用。相关示例请参见 配置归档。 命令选项 异 …

原始页面： https://www.pgbouncer.org/config.html 描述 配置文件采用 “ini” 格式。节名称位于 [ 和 ] 之间。以 ; 或 # 开头的行被视为注释并忽略。当 ; 和 # 出现在行中间时，不会被识别为特殊字符。 通用设置 logfile 指定日志文件。若要以守护进程方式运行（-d），需要设置此项或 syslog。 日志文件保持打开状态，因此在日志轮转后，应执行 kill -HUP 或在控制台执行 RELOAD;。在 Windows 上，必须停止并重启服 …

在 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。 几乎所有的 …

原始页面： https://patroni.readthedocs.io/en/latest/yaml_configuration.html 全局/通用 name：主机名称，在集群中必须唯一。 namespace：Patroni 在配置存储中保存集群信息的路径，默认值为 /service。 scope：集群名称。 日志 type：设置日志格式，可选 plain 或 json。使用 json 格式时，必须安装 jsonlogger。默认值为 plain。 level：设置通用日志级别，默认值为 …

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

原始页面： pgBackRest Command Docs: archive-get PostgreSQL 通过此命令执行备份恢复、PITR，或将其作为流复制的替代方式来维持副本同步。WAL 段是 PostgreSQL 执行恢复或维护副本的必要条件。 配置多个仓库时，pgBackRest 按优先级顺序（如 repo1、repo2 等）依次从各仓库获取 WAL。速度更快或成本更低的存储应配置更高的优先级。若通过 --repo 选项指定了某个仓库，则仅从该仓库中查找。 archive-get 命令 …

原始页面： https://pgbackrest.org/news.html 新的发行版 tarball 2026 年 7 月 20 日 从 pgBackRest 2.59.0 开始，每个版本都会提供一个发行版 tarball，让从源码构建变得更加简单。与 Git 仓库检出版本不同，该 tarball 已经包含生成后的源码和预先渲染的文档，因此构建和安装 pgBackRest 时不再需要仓库检出所要求的代码生成工具或文档工具。 tarball 包含 pgBackRest 源码及预生成代码、命令 …

“PostgreSQL In Great STYle”: Postgres, Infras, Graphics, Service, Toolbox, it’s all Yours. —— 开源免费、开箱即用、本地优先、自主可控的企业级 PostgreSQL 发行版与 RDS 方案 开源免费 本地优先 生产可用 仓库 | 演示 | 博客 | 论坛 | 微信 | EN Docs 按 ⌘+ 加 K（macOS）或 Ctrl+ 加 K 可随时打开本地搜索与命令面板。 简介 从了解项目、理解概念，到单机上 …

“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/交互式查询的实例 同步备库：启用同步提交以确保没有数据丢失。 法定人数提交：使用多数同步提交获得更高的一致性级别。 备份集群：克隆现有集群并跟随它 延迟集群：克隆现有集群 …

原始页面： https://patroni.readthedocs.io/en/latest/dynamic_configuration.html 动态配置存储在 DCS（分布式配置存储）中，并应用于集群的所有节点。 如需修改动态配置，可使用 patronictl edit-config 工具或 Patroni REST API。 loop_wait：主循环每轮的休眠秒数。默认值：10，最小值：1。 ttl：获取领导者锁的 TTL（秒）。可以理解为触发自动故障转移前的等待时长。默认值：30，最 …

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

原始页面： pgBackRest Command Docs: annotate backup 命令执行时附加的注解，可在事后通过 annotate 命令进行添加、修改或删除。 命令选项 备份注解选项（--annotation） 为备份添加用户自定义键值对注解。 可为备份附加具有描述性的键值对。此选项可多次使用，以添加多条注解。 使用 --set 指定备份后，注解将显示在 info 命令的文本输出中，并始终出现在 JSON 输出中。 YAML example: …