Pigsty 中文文档 v4.2

• 1: PIGSTY
• 2: 关于
• 2.1: 亮点特性
• 2.2: 历史沿革
• 2.3: 活动新闻
• 2.4: 发展规划
• 2.5: 加入社区
• 2.6: 隐私政策
• 2.7: 开源协议
• 2.8: 赞助我们
• 2.9: 行业案例
• 2.10: 订阅服务
• 2.11: 常见问题
• 2.12: 发布注记
• 2.13: 同类对比
• 2.13.1: 成本对比
• 2.13.2: 开源影响力
• 3: 模板
• 3.1: 单机模版
• 3.2: meta
• 3.3: rich
• 3.4: slim
• 3.5: fat
• 3.6: infra
• 3.7: vibe
• 3.8: docker
• 3.9: 内核模版
• 3.10: pgsql
• 3.11: mssql
• 3.12: polar
• 3.13: ivory
• 3.14: agens
• 3.15: pgedge
• 3.16: mysql
• 3.17: pgtde
• 3.18: oriole
• 3.19: mongo
• 3.20: supabase
• 3.21: ha/citus
• 3.22: 高可用模板
• 3.23: ha/simu
• 3.24: ha/full
• 3.25: ha/safe
• 3.26: ha/trio
• 3.27: ha/dual
• 3.28: 应用模版
• 3.29: app/odoo
• 3.30: app/dify
• 3.31: app/electric
• 3.32: app/maybe
• 3.33: app/teable
• 3.34: app/mattermost
• 3.35: app/registry
• 3.36: 其他模版
• 3.37: demo/el
• 3.38: demo/debian
• 3.39: demo/demo
• 3.40: demo/minio
• 3.41: build/oss
• 3.42: build/pro
• 4: 概念
• 4.1: 积木式架构
• 4.1.1: 节点
• 4.1.2: INFRA 架构
• 4.1.3: PGSQL 架构
• 4.2: 集群模型图
• 4.2.1: PGSQL 集群模型
• 4.2.2: ETCD 集群模型
• 4.2.3: MINIO 集群模型
• 4.2.4: REDIS 集群模型
• 4.2.5: INFRA 集群模型
• 4.3: 声明式配置 —— 基础设施即代码（IaC）
• 4.3.1: 配置清单
• 4.3.2: 配置向导
• 4.3.3: 配置参数
• 4.3.4: 配置模板
• 4.3.5: 元数据库
• 4.4: PG 高可用
• 4.4.1: RPO 利弊权衡
• 4.4.2: RTO 利弊权衡
• 4.4.3: 故障切换模型
• 4.4.3.1: 被动故障切换
• 4.4.3.2: 主动故障检测
• 4.4.4: 服务接入
• 4.5: 时间点恢复
• 4.5.1: 时间点恢复的工作原理
• 4.5.2: 时间点恢复的实现架构
• 4.5.3: 时间点恢复的策略权衡
• 4.5.4: 时间点恢复的典型场景
• 4.6: 监控系统
• 4.7: 安全合规
• 4.7.1: 七层安全模型
• 4.7.2: 身份认证
• 4.7.3: 访问控制
• 4.7.4: 加密通信与本地 CA
• 4.7.5: 数据安全
• 4.7.6: 合规清单
• 5: 上手
• 5.1: 快速上手 Pigsty 单机部署
• 5.2: Docker 部署
• 5.3: 从浏览器访问图形用户界面
• 5.4: 快速上手 PostgreSQL
• 5.5: 通过配置清单定制 Pigsty 部署
• 5.6: 使用 Ansible 剧本完成部署
• 5.7: 离线安装
• 5.8: 精简安装
• 5.9: 安全建议
• 6: 部署
• 6.1: 生产部署
• 6.2: 资源准备
• 6.3: 架构规划
• 6.4: 管理机制
• 6.5: 沙箱环境
• 6.6: Vagrant
• 6.7: Terraform
• 6.8: 安全考量
• 7: 参考
• 7.1: Linux 兼容性
• 7.2: 模块列表
• 7.3: 扩展列表
• 7.4: 文件结构
• 7.5: 参数列表
• 7.6: 剧本列表
• 7.7: 端口列表
• 8: 应用
• 8.1: Supabase 企业级自建
• 8.2: Odoo：自建开源 ERP
• 8.3: Dify：AI 工作流平台
• 8.4: 业务软件
• 8.5: NocoDB：开源 Airtable
• 8.6: Teable：AI 无代码数据库
• 8.7: Gitea：自建简易代码托管平台
• 8.8: Wiki.js：维基百科站
• 8.9: Mattermost：开源团队协作
• 8.10: Maybe：个人财务管理
• 8.11: Metabase：BI 分析工具
• 8.12: Kong：API 网关
• 8.13: Registry：容器镜像缓存
• 8.14: 数据库工具
• 8.15: ByteBase：模式迁移
• 8.16: PGAdmin：GUI 工具
• 8.17: PGWeb：网页客户端
• 8.18: PostgREST：自动 API
• 8.19: Electric：PostgreSQL 同步引擎
• 8.20: Jupyter：笔记本 AI IDE
• 8.21: 数据应用
• 8.22: PGLOG：PG自带日志分析应用
• 8.23: NOAA ISD 全球气象站历史数据查询
• 8.24: COVID-19 数据大盘
• 8.25: StackOverflow 调研
• 8.26: DB-Engine 热度分析
• 8.27: 云上算力价格计算器
• 9: 模块参考
• 10: 模块：PGSQL
• 10.1: 配置指南
• 10.2: 集群配置
• 10.2.1: 集群实例
• 10.2.2: 内核版本
• 10.2.3: 别名翻译
• 10.2.4: 用户/角色
• 10.2.5: 数据库
• 10.2.6: HBA 规则
• 10.2.7: 参数配置
• 10.2.8: 访问控制
• 10.3: 服务/接入
• 10.4: 访问控制
• 10.5: 管理任务
• 10.6: 日常管理
• 10.6.1: 管理 PostgreSQL 数据库集群
• 10.6.2: 管理 PostgreSQL 业务用户
• 10.6.3: 管理 PostgreSQL 业务数据库
• 10.6.4: 管理 Patroni 高可用
• 10.6.5: Pgbouncer 连接池管理
• 10.6.6: 管理 PostgreSQL 组件服务
• 10.6.7: 管理 PostgreSQL 定时任务
• 10.6.8: 升级 PostgreSQL 大小版本
• 10.6.9: 管理 PostgreSQL 扩展插件
• 10.7: 备份恢复
• 10.7.1: 备份策略
• 10.7.2: 备份机制
• 10.7.3: 备份仓库
• 10.7.4: 管理命令
• 10.7.5: 恢复操作
• 10.7.6: 克隆数据库集群
• 10.8: 数据迁移
• 10.9: 任务教程
• 10.9.1: 故障排查
• 10.9.2: 误删处理
• 10.9.3: 手工恢复
• 10.9.4: 利用 xfs 实现实例 Fork
• 10.9.5: 为 PostgreSQL 集群启用 HugePage
• 10.9.6: 3坏2应急处理
• 10.9.7: 使用 VIP-Manager 为 PostgreSQL 集群配置二层 VIP
• 10.9.8: Citus 集群部署
• 10.10: 参考资料
• 10.11: 监控系统
• 10.12: 监控面板
• 10.12.1: 总览面板
• 10.12.1.1: PGSQL Overview
• 10.12.1.2: PGSQL Alert
• 10.12.1.3: PGSQL Shard
• 10.12.2: 集群面板
• 10.12.2.1: PGSQL Cluster
• 10.12.2.2: PGRDS Cluster
• 10.12.2.3: PGSQL Activity
• 10.12.2.4: PGSQL Replication
• 10.12.2.5: PGSQL Service
• 10.12.2.6: PGSQL Databases
• 10.12.2.7: PGSQL Patroni
• 10.12.2.8: PGSQL PITR
• 10.12.3: 实例面板
• 10.12.3.1: PGSQL Instance
• 10.12.3.2: PGRDS Instance
• 10.12.3.3: PGCAT Instance
• 10.12.3.4: PGSQL Persist
• 10.12.3.5: PGSQL Proxy
• 10.12.3.6: PGSQL Pgbouncer
• 10.12.3.7: PGSQL Session
• 10.12.3.8: PGSQL Xacts
• 10.12.3.9: PGSQL Exporter
• 10.12.4: 数据库面板
• 10.12.4.1: PGSQL Database
• 10.12.4.2: PGCAT Database
• 10.12.4.3: PGSQL Tables
• 10.12.4.4: PGSQL Table
• 10.12.4.5: PGCAT Table
• 10.12.4.6: PGSQL Query
• 10.12.4.7: PGCAT Query
• 10.12.4.8: PGCAT Locks
• 10.12.4.9: PGCAT Schema
• 10.13: 指标列表
• 10.14: 参数列表
• 10.15: 预置剧本
• 10.16: 扩展插件
• 10.16.1: 快速开始
• 10.16.2: 扩展简介
• 10.16.3: 软件包
• 10.16.4: 下载扩展
• 10.16.5: 安装扩展
• 10.16.6: 配置扩展
• 10.16.7: 启用扩展
• 10.16.8: 更新扩展
• 10.16.9: 移除扩展
• 10.16.10: 默认扩展
• 10.16.11: 扩展仓库
• 10.17: 场景模板
• 10.17.1: 默认配置模板的参数优化策略说明
• 10.17.2: OLTP 模板
• 10.17.3: OLAP 模板
• 10.17.4: CRIT 模板
• 10.17.5: TINY 模板
• 10.18: 内核分支
• 10.18.1: PostgreSQL
• 10.18.2: Supabase
• 10.18.3: Citus
• 10.18.4: Babelfish
• 10.18.5: IvorySQL
• 10.18.6: PolarDB PG
• 10.18.7: PolarDB Oracle
• 10.18.8: Percona
• 10.18.9: PostgresML
• 10.18.10: openHalo
• 10.18.11: Greenplum
• 10.18.12: OrioleDB
• 10.18.13: Cloudberry
• 10.18.14: Neon
• 10.18.15: AgensGraph
• 10.18.16: pgEdge
• 10.19: 常见问题
• 10.20: 其他说明
• 10.20.1: 用户/角色
• 10.20.2: 数据库
• 10.20.3: 服务/接入
• 10.20.4: 认证 / HBA
• 10.20.5: 访问控制
• 11: 模块：INFRA
• 11.1: 集群配置
• 11.2: 参数列表
• 11.3: 预置剧本
• 11.4: 监控告警
• 11.5: 指标列表
• 11.6: 常见问题
• 11.7: 管理预案
• 11.7.1: Nginx 管理
• 11.7.2: 软件仓库
• 11.7.3: 域名管理
• 11.7.4: 模块管理
• 11.7.5: CA 与证书
• 11.7.6: Grafana 高可用部署：使用 PostgreSQL 后端数据库
• 12: 模块：NODE
• 12.1: 集群配置
• 12.2: 参数列表
• 12.3: 预置剧本
• 12.4: 管理预案
• 12.5: 监控告警
• 12.6: 指标列表
• 12.7: 常见问题
• 13: 模块：ETCD
• 13.1: 集群配置
• 13.2: 参数列表
• 13.3: 管理预案
• 13.4: 预置剧本
• 13.5: 监控告警
• 13.6: 指标列表
• 13.7: 常见问题
• 14: 模块：MINIO
• 14.1: 使用方法
• 14.2: 集群配置
• 14.3: 参数列表
• 14.4: 预置剧本
• 14.5: 管理预案
• 14.6: 监控告警
• 14.7: 指标列表
• 14.8: 常见问题
• 15: 模块：REDIS
• 15.1: 集群配置
• 15.2: 参数列表
• 15.3: 预置剧本
• 15.4: 管理预案
• 15.5: 监控告警
• 15.6: 指标列表
• 15.7: 常见问题
• 16: 模块：FERRET
• 16.1: 使用方法
• 16.2: 集群配置
• 16.3: 参数列表
• 16.4: 管理预案
• 16.5: 管理剧本
• 16.6: 监控告警
• 16.7: 指标列表
• 16.8: 常见问题
• 17: 模块：DOCKER
• 17.1: 使用方法
• 17.2: 参数列表
• 17.3: 预置剧本
• 17.4: 指标列表
• 17.5: 常见问题
• 18: 模块：JUICE
• 18.1: 集群配置
• 18.2: 参数列表
• 18.3: 预置剧本
• 18.4: 管理预案
• 18.5: 监控告警
• 18.6: 常见问题
• 19: 模块：VIBE
• 19.1: 功能配置
• 19.2: 参数列表
• 19.3: 预置剧本
• 19.4: 管理预案
• 19.5: 监控告警
• 19.6: 常见问题
• 20: 模块：PILOT
• 20.1: 模块：Code
• 20.2: 模块：MySQL
• 20.3: 模块：Kafka
• 20.4: 模块：DuckDB
• 20.5: 模块：TigerBeetle
• 20.6: 模块：Kubernetes
• 20.7: 模块：Consul
• 21: 其他组件
• 22: PIG 包管理器
• 22.1: 上手
• 22.2: 简介
• 22.3: 安装
• 22.4: 版本
• 22.5: 命令参考
• 22.6: pig
• 22.7: pig repo
• 22.8: pig ext
• 22.9: pig build
• 22.10: pig sty
• 22.11: pig postgres
• 22.12: pig patroni
• 22.13: pig pgbackrest
• 22.14: pig pitr
• 23: Linux 软件源
• 23.1: PGDG 仓库
• 23.2: GPG 密钥
• 23.3: INFRA 仓库
• 23.3.1: 软件清单
• 23.3.2: 发布日志
• 23.4: PGSQL 仓库
• 23.4.1: DNF 变更日志
• 23.4.2: APT 变更日志
• 24: Piglet Runtime：AI 运行时沙箱
• 25: Patroni 4.1 中文文档
• 25.1: 简介
• 25.2: 安装
• 25.3: Patroni 配置
• 25.3.1: 动态配置
• 25.3.2: YAML 配置参数
• 25.3.3: 环境变量
• 25.4: Patroni REST API
• 25.5: patronictl 命令行
• 25.6: 从库镜像与引导
• 25.7: 复制模式
• 25.8: 备用集群
• 25.9: Watchdog 支持
• 25.10: 集群的暂停/恢复模式
• 25.11: DCS 故障安全模式
• 25.12: 在 Kubernetes 中使用 Patroni
• 25.13: Citus 支持
• 25.14: 将独立实例转换为 Patroni 集群
• 25.15: 与其他工具的集成
• 25.16: 安全注意事项
• 25.17: 多数据中心高可用
• 25.18: 常见问题
• 25.19: 版本历史
• 25.20: 贡献指南
• 26: pgBouncer 1.25 中文文档
• 26.1: 特性
• 26.2: 配置：pgbouncer.ini
• 26.3: pgbouncer 命令用法
• 26.4: PgBouncer 编译与安装
• 26.5: 源码发布版下载
• 26.6: 版本变更日志
• 26.7: 社区
• 26.8: 常见问题解答
• 27: pgBackRest 2.58 中文文档
• 27.1: 用户指南（Debian/Ubuntu）
• 27.2: 用户指南（RHEL/Rocky/CentOS）
• 27.3: 命令参考
• 27.3.1: 注解命令（annotate）
• 27.3.2: 归档获取命令（archive-get）
• 27.3.3: 归档推送命令（archive-push）
• 27.3.4: 备份命令（backup）
• 27.3.5: 检查命令（check）
• 27.3.6: 过期命令（expire）
• 27.3.7: 帮助命令（help）
• 27.3.8: Info 命令（info）
• 27.3.9: 仓库获取命令（repo-get）
• 27.3.10: 仓库列表命令（repo-ls）
• 27.3.11: 恢复命令（restore）
• 27.3.12: 服务器命令（server）
• 27.3.13: 服务器心跳命令（server-ping）
• 27.3.14: Stanza 创建命令（stanza-create）
• 27.3.15: Stanza 删除命令（stanza-delete）
• 27.3.16: Stanza 升级命令（stanza-upgrade）
• 27.3.17: 启动命令（start）
• 27.3.18: 停止命令（stop）
• 27.3.19: 验证命令（verify）
• 27.3.20: 版本命令（version）
• 27.4: 配置参考
• 27.5: 版本发布说明
• 27.6: 常见问题解答
• 27.7: 项目指标
• 28: PG Exporter 1.2 中文文档
• 28.1: 快速上手
• 28.2: 安装指南
• 28.3: 配置参考
• 28.4: API 参考
• 28.5: 部署指南
• 28.6: 发布注记

1 - PIGSTY

2 - 关于

2.1 - 亮点特性

“PostgreSQL In Great STYle”: Postgres, Infras, Graphics, Service, Toolbox, it’s all Yours.

—— 开箱即用、本地优先的 PostgreSQL 发行版，开源 RDS 替代

价值主张

• 可扩展性： 强力 扩展 开箱即用：深度整合 PostGIS, TimescaleDB, Citus, PGVector 等 451 插件与 Oracle / SQL Server 的 兼容内核。
• 可靠性：快速创建 高可用、故障自愈的 PostgreSQL 集群，自动预置的 时间点恢复、访问控制、自签名 CA 与 SSL，确保数据坚如磐石。
• 可观测性： 基于 Prometheus & Grafana 现代可观测性技术栈，提供惊艳的监控最佳实践。模块化设计，可独立使用：画廊 & Demo。
• 可用性：交付稳定可靠，自动路由，事务池化、读写分离的高性能数据库 服务，通过 HAProxy，Pgbouncer，VIP 提供灵活的 接入 模式。
• 可维护性：简单易用，基础设施即代码，管理SOP预案，自动调参，本地软件仓库，Vagrant 沙箱 与 Terraform 模板，不停机 迁移 方案。
• 可组合性：模块化 架构设计，可复用的 Infra，多样的可选 模块：Redis, MinIO, ETCD, FerretDB, DuckDB, Docker, Supabase。

总览

Pigsty 是一个更好的本地开源 RDS for PostgreSQL 替代：

• 开箱即用的RDS：从内核到RDS发行版，在 EL/Debian/Ubuntu 下提供 13-18 版本的生产级 PG 数据库服务。
• 丰富的扩展插件：提供无可比拟的 451 扩展，提供开箱即用的分布式的时序地理空间图文向量多模态数据库能力。
• 灵活的模块架构：灵活组合，自由扩展：Redis/Etcd/MinIO/Mongo；可独立使用，监控现有RDS/主机/数据库。
• 惊艳的观测能力：基于现代可观测性技术栈 Prometheus/Grafana，提供令人惊艳，无可比拟的数据库观测能力。
• 验证过的可靠性：故障自愈的高可用架构：硬件故障自动切换，流量无缝衔接。并提供自动配置的 PITR 兜底删库！
• 简单易用可维护：声明式API，GitOps就位，傻瓜式操作，Database/Infra-as-Code 以及管理SOP封装管理复杂度！
• 扎实的安全实践：加密备份一应俱全，自带基础ACL最佳实践。只要硬件与密钥安全，您无需操心数据库的安全性！
• 广泛的应用场景：低代码数据应用开发，或使用预置的 Docker Compose 模板，一键拉起使用PostgreSQL的海量软件！
• 开源的自由软件：以云数据库1/10不到的成本拥有与更好的数据库服务！帮您真正“拥有”自己的数据，实现自主可控！

PostgreSQL 整合了生态中的工具与最佳实践：

• 开箱即用的 PostgreSQL 发行版，深度整合地理、时序、分布式、图、向量、搜索、AI等 451 个 扩展插件！
• 运行于裸操作系统之上，无需容器支持，支持主流操作系统： EL 8/9/10, Ubuntu 22.04/24.04 以及 Debian 12/13。
• 基于 patroni, haproxy, 与 etcd，打造故障自愈的高可用架构：硬件故障自动切换，流量无缝衔接。
• 基于 pgBackRest 与可选的 MinIO 集群提供开箱即用的 PITR 时间点恢复，为软件缺陷与人为删库兜底。
• 基于 Ansible 提供声明式的 API 对复杂度进行抽象，以 Database-as-Code 的方式极大简化了日常运维管理操作。
• Pigsty用途广泛，可用作完整应用运行时，开发演示数据/可视化应用，大量使用 PG 的软件可用 Docker 模板一键拉起。
• 提供基于 Vagrant 的本地开发测试沙箱环境，与基于 Terraform 的云端自动部署方案，开发测试生产保持环境一致。
• 部署并监控专用的 Redis（主从，哨兵，集群），MinIO，Etcd，Haproxy，MongoDB (FerretDB) 集群

开箱即用的RDS

让您立刻在本地拥有生产级的PostgreSQL数据库服务！

PostgreSQL 是一个足够完美的数据库内核，但它需要更多工具与系统的配合才能成为一个足够好的数据库服务（RDS），Pigsty 帮助 PostgreSQL 完成这一步飞跃。 Pigsty 为您解决使用 PostgreSQL 中会遇到的各种难题：内核扩展安装，连接池，负载均衡，服务接入，高可用 / 自动故障切换，日志收集，指标监控，告警，备份恢复，PITR，访问控制，参数调优，安全加密，证书签发，NTP，DNS，参数调优，配置管理，CMDB，管理预案… 您无需再为这些细节烦心劳神！

Pigsty 支持 PostgreSQL 13 ～ 18 主干内核与其他兼容分支，可运行于 EL / Debian / Ubuntu 以及 兼容操作系统发行版 上，在 x86_64 与 ARM64 芯片架构上可用，且无需容器支持。 除了数据库内核与大量开箱即用的扩展插件以外，Pigsty 还提供了数据库服务所需的完整基础设施与运行时，以及本地沙箱 / 生产环境 / 云 IaaS 自动部署方案。

Pigsty 可以一键从裸机开始拉起整套环境，触达软件交付的最后一公里。普通研发运维均可快速上手并兼职进行数据库管理，无需数据库专家即可自建企业级RDS服务！

丰富的扩展插件

超融合多模态，一切皆用 PostgreSQL，一个PG替换所有数据库！

PostgreSQL 的灵魂在于其丰富的 扩展生态，而 Pigsty 独一无二地深度整合了 PostgreSQL 生态中的 451 扩展，为您提供开箱即用的超融合多模态数据库！

插件间可以产生 协同效应，产生 1+1 远大于 2 的效果。 您可以使用 PostGIS 处理地理空间数据，使用 TimescaleDB 分析时序/事件流数据，并使用 Citus 将其原地升级为分布式地理时空数据库； 您可以用 PGVector 存储并搜索AI嵌入，用 ParadeDB 实现 ES级全文检索，并同时使用精准的 SQL，全文检索，与模糊向量进行混合检索。 您还可以通过 pg_duckdb，pg_mooncake 等分析扩展，实现专用 OLAP 数据库/数据湖仓的分析表现。

使用 PostgreSQL 单一组件替代 MySQL，Kafka，ElasticSearch，MongoDB，以及大数据分析技术栈已经成为一种最佳实践 —— 单一数据库选型能够显著降低系统复杂度，极大提高研发效能与敏捷性，实现程度惊人的软硬件，研发/运维人力降本增效。

灵活的模块架构

灵活组合，自由扩展，多数据库支持，监控现有RDS/主机/数据库

Pigsty 中的组件被抽象可独立部署的 模块，并可自由组合以应对多变的需求场景。INFRA 模块带有完整的现代监控技术栈，而 NODE 模块则将节点调谐至指定状态并纳管。 在多个节点上安装 PGSQL 模块会自动组建出基于主从复制的高可用数据库集群，而同样的 ETCD 模块则为数据库高可用提供共识与元数据存储。

除了上述四个 核心模块 之外，Pigsty 还提供一系列选装功能模块：MINIO 模块可以提供本地对象存储能力，并作为集中式数据库备份仓库。 REDIS 模块能以独立主从，哨兵，原生集群的方式为数据库提供辅助。DOCKER 模块可用于拉起无状态的应用软件。

此外，Pigsty 还提供 PG 兼容 / 衍生内核的支持，您可以使用 Babelfish 提供 MS SQL Server 兼容性，使用 IvorySQL 提供 Oracle 兼容性， 使用 OpenHaloDB 提供 MySQL 兼容性，使用 OrioleDB 提供极致的 OLTP 性能。

不仅如此，你还可以使用 FerretDB 提供 MongoDB 兼容性，使用 Supabase 提供 Firebase 兼容，并使用 PolarDB 满足国产化合规要求。 更多专业版/试点模块将不断引入 Pigsty，如 GPSQL，KAFKA，DUCKDB，VICTORIA，TIGERBEETLE，KUBERNETES，CONSUL，JUPYTER，GREENPLUM，CLOUDBERRY，MYSQL, …

惊艳的观测能力

使用现代开源可观测性技术栈，提供无与伦比的监控最佳实践！

Pigsty 提供了基于开源的 Grafana / Prometheus 现代可观测性技术栈做 监控 的最佳实践：，Grafana 负责可视化呈现，VictoriaMetrics 用于收集监控指标，VictoriaLogs 用于日志收集与查询，Alertmanager 用于告警通知。Blackbox Exporter 负责检查服务可用性。整套系统同样被设计为一键拉起，开箱即用的 INFRA 模块。

Pigsty 所管理的任何组件都会被自动纳入监控之中，包括主机节点，负载均衡 HAProxy，数据库 Postgres，连接池 Pgbouncer，元数据库 ETCD，KV缓存 Redis，对象存储 MinIO，……，以及整套监控基础设施本身。大量的 Grafana 监控面板与预置告警规则会让你的系统观测能力有质的提升，当然，这套系统也可以被复用于您的应用监控基础设施，或者监控已有的数据库实例或 RDS。

无论是故障分析还是慢查询优化、无论是水位评估还是资源规划，Pigsty 为您提供全面的数据支撑，真正做到数据驱动。在 Pigsty 中，超过三千类监控指标被用于描述整个系统的方方面面，并被进一步加工、聚合、处理、分析、提炼并以符合直觉的可视化模式呈现在您的面前。从全局大盘总览，到某个数据库实例中单个对象（表，索引，函数）的增删改查详情都能一览无余。您可以随意上卷下钻横向跳转，浏览系统现状与历史趋势，并预测未来的演变。

此外，Pigsty的监控系统模块部分还可以 独立使用 ——用它来监控现有的主机节点与数据库实例，或者是云上的 RDS 服务。只需要一个连接串一行命令，您就可以获得极致的 PostgreSQL 可观测性体验。

访问 截图画廊 与 在线演示 获取更多详情。

久经考验的可靠性

开箱即用的高可用与时间点恢复能力，确保你的数据库坚如磐石！

对于软件缺陷或人为误操作造成的删表删库，Pigsty 提供了开箱即用的 PITR 时间点恢复能力，无需额外配置即默认启用。只要存储空间管够，基于 pgBackRest 的基础备份与 WAL 归档让您拥有快速回到过去任意时间点的能力。您可以使用本地目录/磁盘，亦或专用的 MinIO 集群或 S3 对象存储服务保留更长的回溯期限，丰俭由人。

更重要的是，Pigsty 让高可用与故障自愈成为 PostgreSQL 集群的标配，基于 patroni, etcd, 与 haproxy 打造的 高可用故障自愈架构，让您在面对硬件故障时游刃有余：主库故障自动切换的 RTO < 45s（可配置），一致性优先模式下确保数据零损失 RPO = 0。只要集群中有任意实例存活，集群就可以对外提供完整的服务，而客户端只要连接至集群中的任意节点，即可获得完整的服务。

Pigsty 内置了 HAProxy 负载均衡器用于自动流量切换，提供 DNS/VIP/LVS 等多种接入方式供客户端选用。故障切换与主动切换对业务侧除零星闪断外几乎无感知，应用不需要修改连接串重启。极小的维护窗口需求带来了极大的灵活便利：您完全可以在无需应用配合的情况下滚动维护升级整个集群。硬件故障可以等到第二天再抽空善后处置的特性，让研发，运维与 DBA 都能安心睡个好觉。 许多大型组织与核心机构已经在生产环境中长时间使用 Pigsty ，最大的部署有 25K CPU 核心与 200+ PostgreSQL 超大规格实例；在这一部署案例中，六七年内经历了数十次硬件故障与各类事故，DBA 换了几茬，但依然可以保持比 99.999% 更高的可用性战绩。

简单易用可维护

Infra as Code, 数据库即代码，声明式的API将数据库管理的复杂度来封装。

Pigsty 使用声明式的接口对外提供服务，将系统的可控制性拔高到一个全新水平：用户通过配置清单告诉 Pigsty “我想要什么样的数据库集群”，而不用去操心到底需要怎样去做。从效果上讲，这类似于 K8S 中的 CRD 与 Operator，但 Pigsty 可用于任何节点上的数据库与基础设施：不论是容器，虚拟机，还是物理机。

无论是创建/销毁集群，添加/移除从库，还是新增数据库/用户/服务/扩展/黑白名单规则，您只需要修改配置清单并运行 Pigsty 提供的幂等剧本，而 Pigsty 负责将系统调整到您期望的状态。 用户无需操心配置的细节，Pigsty将自动根据机器的硬件配置进行调优，您只需要关心诸如集群叫什么名字，有几个实例放在哪几台机器上，使用什么配置模版：事务/分析/核心/微型，这些基础信息，研发也可以自助服务。但如果您愿意跳入兔子洞中，Pigsty 也提供了丰富且精细的控制参数，满足最龟毛 DBA 的苛刻定制需求。

除此之外，Pigsty 本身的安装部署也是一键傻瓜式的，所有依赖被预先打包，在安装时可以无需互联网访问。而安装所需的机器资源，也可以通过 Vagrant 或 Terraform 模板自动获取，让您在十几分钟内就可以从零在本地笔记本或云端虚拟机上拉起一套完整的 Pigsty 部署。本地沙箱环境可以跑在1核2G的微型虚拟机中，提供与生产环境完全一致的功能模拟，可以用于开发、测试、演示与学习。

扎实的安全实践

加密备份一应俱全，只要硬件与密钥安全，您无需操心数据库的安全性。

Pigsty 针对高标准，严要求的企业级场景设计，采用业界领先的 安全最佳实践 保护您的数据安全（机密性/完整性/可用性），默认配置下的安全性便足以满足绝大多数场景下的合规要求。

Pigsty 会创建自签名的 CA （或使用您提供的 CA）签发证书，加密网络通信。需要保护的敏感管理页面与API端点都受到密码保护。 数据库备份使用 AES 算法加密，数据库密码使用 scram-sha-256 算法加密，并提供插件强制执行密码强度策略。 Pigsty 提供了一套开箱即用，简单易用，便于扩展的 ACL 模型，提供读/写/管理/ETL 的权限区分，并带有遵循最小权限原则的 HBA 规则集，通过多重防护确保系统机密性。

Pigsty 默认启用数据库校验和避免静默数据腐坏，通过从库副本提供坏块兜底。提供 CRIT 数据零丢失配置模板，使用 watchdog 确保为高可用 Fencing 兜底。 您可以通过 audit 插件审计数据库操作，系统与数据库日志全部收集备查，以满足合规要求。

Pigsty 正确配置 SELinux 与防火墙配置，并遵循最小权限原则设计操作系统用户组与文件权限，确保系统安全基线符合合规要求。 而且在 Etcd，MinIO 等附属可选组件上的安全上也毫不妥协，etcd 与 minio 均使用 RBAC 模型与 TLS 加密通信，确保系统整体安全性。

合理配置的系统通过等保三级/SOC2毫无问题，只要您遵循安全性最佳实践，内网部署并合理配置安全组与防火墙，数据库安全性将不再是您的痛点。

广泛的应用场景

使用预置的Docker模板，一键拉起使用PostgreSQL的海量软件！

在各类数据密集型应用中，数据库往往是最为棘手的部分。例如 Gitlab 企业版与社区版的核心区别就是底层 PostgreSQL 数据库的监控与高可用，如果您已经有了足够好的本地 PG RDS，完全可以拒绝为软件自带的土法手造数据库组件买单。

Pigsty 提供了 Docker 模块 与大量开箱即用的 Compose 模板。您可以使用 Pigsty 管理的高可用 PostgreSQL （以及 Redis 与 MinIO ）作为后端存储，以无状态的模式一键拉起这些软件： Gitlab、Gitea、Wiki.js、NocoDB、Odoo、Jira、Confluence、Habour、Mastodon、Discourse、KeyCloak、MatterMost 等等。 如果您的应用需要一个靠谱的 PostgreSQL 数据库， Pigsty 也许是最简单的获取方案。

Pigsty 也提供了与 PostgreSQL 紧密联系的应用开发工具集：PGAdmin4、PGWeb、ByteBase、PostgREST、Kong、以及 EdgeDB、FerretDB、Supabase 这些使用 PostgreSQL 作为存储的"上层数据库"。 更奇妙的是，您完全可以基于 Pigsty 内置了的 Grafana 与 Postgres ，以低代码的方式快速搭建起一个交互式的数据应用来，甚至还可以使用 Pigsty 内置的 ECharts 面板创造更有表现力的交互可视化作品。

Pigsty 为您的 AI 应用提供了一个功能强大的运行时，您的 Agent 可以在这个环境中利用 PostgreSQL 与可观测性世界的强大能力，快速构建起一个数据驱动的智能体。

开源的自由软件

Pigsty是基于 Apache-2.0 开源的自由软件，由热爱 PostgreSQL 的社区成员用热情浇灌

Pigsty 是完全 开源免费 的自由软件，它允许您在缺乏数据库专家的情况下，用几乎接近纯硬件的成本来运行企业级的 PostgreSQL 数据库服务。 作为对比，数据库厂商的“企业级数据库服务”与公有云厂商提供的 RDS 会收取底层硬件资源几倍到十几倍不等的 溢价 作为 “服务费”。

很多用户选择上云，正是因为自己搞不定数据库；很多用户使用 RDS，是因为别无他选。 我们将打破云厂商的垄断，为用户提供一个云中立的，更好的 RDS 开源替代： Pigsty 紧跟 PostgreSQL 上游主干，不会有供应商锁定，不会有恼人的 “授权费”，不会有节点数量限制，不会收集您的任何数据。您的所有的核心资产 —— 数据，都能"自主可控"，掌握在自己手中。

Pigsty 本身旨在用数据库自动驾驶软件，替代大量无趣的人肉数据库运维工作，但再好的软件也没法解决所有的问题。 总会有一些的冷门低频疑难杂症需要专家介入处理。这也是为什么我们也提供专业的 订阅服务，来为有需要的企业级用户使用 PostgreSQL 提供兜底。 几万块的订阅咨询费不到顶尖 DBA 每年工资的几十分之一，让您彻底免除后顾之忧，把成本真正花在刀刃上。对于社区用户，我们亦 用爱发电，提供免费的支持与日常答疑。

2.2 - 历史沿革

历史起源

Pigsty 项目始于 2018 ～ 2019 年，起源于 探探。 探探是一个互联网交友 App —— 中国的 Tinder，现已被陌陌收购。 探探这家公司是一个北欧风格的创业公司，有着一个瑞典工程师初创团队。

探探在技术上极有品味，使用 PostgreSQL 与 Go 作为核心技术栈。 探探整个系统架构参照 Instagram ，一切围绕 PostgreSQL 数据库设计。 直到几百万日活，几百万 TPS，几百 TB 数据的量级下，数据组件 只用了 PostgreSQL。 几乎所有的业务逻辑都使用 PG 存储过程实现 —— 甚至包括 100ms 的推荐算法！称得上当时中国最复杂的 PostgreSQL 规模场景用例。

探探这种深度使用 PostgreSQL 特性的非典型研发模式，对工程师与DBA的水平提出了极高的要求。 而 Pigsty ，就是我们用这种真实世界的大规模，高标准数据库集群场景打磨出的开源项目 —— 沉淀着我们作为顶尖 PostgreSQL 专家的经验与最佳实践。

发展过程

在最开始，Pigsty 并没有现在这样的愿景、目标与版图。而是为了提供一个供我们自己使用的 PostgreSQL 监控系统。 我们调研了市面上所有的方案，开源的、商业的、云的，datadog, pgwatch，…… ，没有一个能满足我们对于可观测性的需求。 因此我决定自己动手，基于 Grafana 与 Prometheus 自己动手打造一个，这就是 Pigsty 的前身与雏形。 Pigsty 作为监控系统的效果相当惊艳，帮助我们解决了无数管理问题。

随后，研发人员希望在本地的开发机上也有这样的监控系统，于是我们使用 Ansible 编写了置备剧本，将这套系统从一次性建设任务转变为了可重复使用，可复制的软件。 新版本允许用户使用 Vagrant 和 Terraform，用 Infra as Code 的方式快速拉起本地 DevBox 开发机，或生产环境服务器，并自动完成 PostgreSQL 与监控系统的部署。

接下来，我们重新设计了生产环境的 PostgreSQL 架构，引入了 Patroni 与 pgBackRest 解决了数据库的 高可用 与 时间点恢复 问题。 开发了基于逻辑复制的不停机 迁移 方案，通过蓝绿部署将生产环境两百套数据库集群滚动升级至最新大版本。并将这些能力引入 Pigsty 中。

Pigsty 是我们做给自己使用的软件，“Eat dog food”最大的好处就是，我们自己既是开发者也更是用户 —— 我们自己作为甲方用户，非常了解自己需要什么，也不会在自己的需求上偷懒，更不用担心自己的工作全自动化后被开。

我们解决了一个又一个的问题，并将解决方案沉淀到 Pigsty 里。Pigsty 的定位，也从一个监控系统，逐渐发展成为一个开箱即用的 PostgreSQL 数据库发行版。 随即我们决定将 Pigsty 开源，并开始了一系列的技术分享与宣传，也开始有各行各业的外部用户使用起 Pigsty 并提出反馈意见。

全职创业

在 2022 年，Pigsty 项目获得了由陆奇博士发起的奇绩创坛的种子轮投资，我得以全职出来做这件事情。

作为一个开源项目，Pigsty 的发展相当不赖，在全职创业这几年里，Pigsty 在 Github 上的 Star 数从几百增长到了 4600+；上了 HN 头条推荐，增长开始滚起雪球。 2025 年 11 月，Pigsty 荣获 PostgreSQL 生态大会颁发的 Magneto Award。2026 年，Pigsty 子项目 PGEXT.CLOUD 投中 PGCon.Dev 2026 演讲。 Pigsty 成为第一个站上这个 PostgreSQL 核心生态大会舞台上的中国开源项目。

从前 Pigsty 只能跑在 CentOS 7 上，现今已经基本覆盖了所有主流 Linux 发行版 （EL, Debian, Ubuntu），支持 14 个操作系统平台。 支持的 PG 大版本覆盖 13 - 18，维护，收录整合了 PG 生态中的 444 扩展插件。 其中，我本人维护了这里超过一半（270+）的扩展插件，并提供开箱即用的 RPM/DEB 包。 算上 Pigsty 本身，“基于开源，回馈开源”，为 PG 生态做一些贡献。

Pigsty 的定位，也在不断发展的过程中，从一个 PostgreSQL 数据库发行版，进一步扩展到了 开源云数据库。它真正对标的是云厂商的整个云数据库品牌。

公有云的反叛者

AWS、Azure、GCP、Aliyun 等公有云厂商为初创企业提供了许多便利，但它们是闭源的，并迫使用户以高额费用租赁基础资源。

我们认为，优秀的数据库服务，应该和优秀的数据库内核一样，普及到每一个用户手中，而不是必须花费高昂的代价去向赛博领主租赁。

云计算的敏捷与弹性价值主张很好，但它应该是自由、开源、普惠、本地优先的 —— 我们认为云计算宇宙中需要一个代表开源价值观的解决方案，在不牺牲云带来好处的前提下，将基础设施的控制权交还给用户。

因此，我们也在引领着一场 下云的运动与战役，作为公有云的反叛者，来重塑这个行业的价值观。

我们的愿景

我希望，未来的世界人人都有自由使用优秀服务的事实权利，而不是只能被圈养在几个赛博领主公有云巨头厂商的地盘上当赛博佃户甚至赛博农奴。

这正是 Pigsty要做的事 —— 一个更好的，开源免费的RDS替代。让用户能够在任何地方（包括云服务器）上，一键拉起比云RDS更好的数据库服务。

Pigsty 是对 PostgreSQL 的彻底补完，更是对云数据库的辛辣嘲讽。 它本意是“猪圈”，但也是 Postgres In Great STYle 的缩写，即“全盛状态下的 PostgreSQL”。

Pigsty 本身是一款完全开源免费的软件，能够让您在没有数据库专家的情况下，自建水平达到 90 分的 PostgreSQL 数据库服务。 我们靠提供 精品咨询服务 来维持运营，为您搭建从 90 分到 100 分的体系，并提供质保、答疑、与兜底。

建设良好的系统也许跑个几年都不会遇到需要 “兜底” 的问题，但数据库的问题一但出现就不是小问题。 很多时候，专家的经验更是能够一言化腐朽为神奇，而我们为有需求的客户提供这样的精品咨询 —— 我们认为这是一种更加公正、合理、可持续的模式。

关于团队

我是冯若航，Pigsty 的作者，Pigsty 的所有代码几乎都由我 一人开发。

软件领域依然存在个人英雄主义，独一无二的个体才能够创造出独一无二的作品 —— 我希望 Pigsty 成为这样的作品。

如果您对我感兴趣，这里是我的个人主页：https://vonng.com/

《墨天轮风云人物访谈录 —— 冯若航》

《90后，辞职创业，说要卷死云数据库》

2.3 - 活动新闻

最近新闻

• 2026-02-28: Pigsty v4.2 正式发布！七款内核批量更新

  • 发布博客：Pigsty v4.2 发布文章
  • 发布说明：v4.2.0
  • 发布说明：v4.2.1

• 2026-02-12: Pigsty v4.1 正式发布！第一批支持 PostgreSQL 18.2 的发行版

  • 发布博客：Pigsty v4.1 发布文章
  • 发布说明：v4.1.0
  • Pigsty 已支持 PostgreSQL 小版本发布：18.2…

• 2026-02-04: Extension for Everyone 主题入选 PGCon.Dev 2026 演讲！

  • 中国厂商首次站上 PGConf.dev 主题演讲台

• 2026-02-03: Pigsty v4.0 正式发布！ 迈入 Agent 时代！

  • PostgreSQL 官方网站新闻：《Pigsty v4.0 Released: Ready for the Agent Era》
  • Victoria 可观测性革命，安全加固，JUICE/VIBE 新模块，容器支持，许可证变更为 Apache-2.0
  • 发布说明：v4.0.0
  • 发布博客：Pigsty v4.0：进入 AI 时代

• 2026-01-30: PIG v1.0 正式发布！ 与 PGEXT.CLOUD 扩展目录同步上线

  • PostgreSQL 官方网站新闻：《PIG v1.0 Released with PGEXT.CLOUD: 444 PG extensions on 14 Linux》
  • PostgreSQL 扩展包管理器 pig v1.0 正式 GA，配合 PGEXT.CLOUD 开放扩展基础设施，提供 444 个扩展

• 2025-12-02: Pigsty v3.7.0 发布！ PG18 成为默认版本，437 扩展，EL10/Debian13 支持

  • 发布说明：v3.7.0

• 2025-11-29: Pigsty 荣获 PostgreSQL Magneto Award！

  • 第八届 PostgreSQL 生态大会（杭州）
  • 演讲主题：“A World-Grade Postgres Meta Distribution”、AI 数据库考量、PostgreSQL 交付最佳实践

• 2025-08-15: Pigsty v3.6.1 发布！ 例行 PG 小版本更新，PGDG 中国区域镜像

  • 发布说明：v3.6.1

• 2025-08-04: Pigsty v3.6.0 发布！ PostgreSQL 元发行版

  • PostgreSQL 官方网站新闻：《Pigsty 3.6, the meta-distribution for PostgreSQL》
  • pgactive 多主复制，MinIO/ETCD 改进，安装简化，配置梳理
  • 发布说明：v3.6.0

• 2025-06-16: Pigsty v3.5.0 发布！ PG18 Beta 支持，421 扩展，监控升级，代码重构

  • 发布说明：v3.5.0

• 2025-04-21: Pigsty v3.4 发布！ MySQL 兼容性

  • PostgreSQL 官方网站新闻：《Pigsty v3.4 Released, PG RDS with MySQL Compatibility》
  • OpenHalo/OrioleDB 支持，备份增强，自动 Certbot 证书，AGE 扩展
  • 发布说明：v3.4.1 / v3.4.0

• 2025-03-07: Pigsty v3.3.0 发布！ 404 扩展

  • PostgreSQL 官方网站新闻：《Pigsty v3.3 Release: with 404 PostgreSQL Extensions》
  • Odoo/Dify/Supabase 应用模板，DocumentDB 支持
  • 发布说明：v3.3.0

• 2025-01: Pigsty v3.2.x 发布系列（v3.2.0 ~ v3.2.2）

  • 390 扩展，Omnigres，Mooncake，Citus13/PG17，扩展管理 CLI，Grafana 强化，ARM64 扩展补完
  • 发布说明：v3.2.2 / v3.2.1 / v3.2.0

• PostgreSQL 包管理器 pig 发布！

  • ANNOUNCE pig: The Postgres Extension Wizard
  • PIG: A New Package Manager for PostgreSQL Extensions

• 2024-11: Pigsty v3.1.0 发布！ PG 17 上位，Supabase 自建，ARM/Ubuntu24 支持

  • PostgreSQL 官方网站新闻：《Pigsty v3.1 Release: PG17, Duck Extensions, Self-hosting Supabase, ARM & Ubuntu24》
  • 介绍文章：《Pigsty v3.1：Supabase自建，PG17上位，MinIO改进，ARM/Ubuntu24支持》
  • 发布说明：v3.1.0

• 2024-08 ~ 2024-10: Pigsty v3.0.x 发布系列（v3.0.0 ~ v3.0.4）

  • PostgreSQL 官方网站新闻：《Pigsty v3: 336 extensions and MSSQL/Oracle flavor PG kernels!》
  • 333 个扩展，可替换内核，MSSQL/Oracle/PolarDB 兼容性，PG17 扩展
  • 发布说明：v3.0.0 ~ v3.0.4
  • 特性介绍：Pigsty v3.0.0

• 2024-08: Pigsty 补充软件仓库，提供 254 个额外的开箱即用的二进制 RPM/DEB 扩展！

  • PostgreSQL 官方网站新闻：《Pigsty Supplementary APT/YUM Repository with 254 additional PostgreSQL Extensions!》

• PGCon.Dev 2024 参会记！

• 2024-05: Pigsty v2.7 发布！

  • PostgreSQL 官方网站新闻：《Pigsty v2.7 Released, free RDS PG with 255 extensions available》
  • Pigsty 博客：Pigsty v2.7：集异璧之大成

• 2024-02: Pigsty v2.6 发布！

  • PostgreSQL 官方网站新闻：《Pigsty, Battery-included PostgreSQL Distro & Free RDS Alternative, v2.6 released!》
  • Pigsty 博客：Pigsty v2.6：PG 踢馆 OLAP

版本发布

Pigsty 发布注记

会议与演讲

2.4 - 发展规划

版本发布策略

Pigsty 使用语义化版本号，<主版本>.<次版本>.<修订号>。Alpha / Beta / RC 版本会在版本号后添加后缀，如 -a1，-b1，-c1。

主版本更新意味着不兼容的基础性变化与重大新特性；次版本更新通常表示普通功能特性更新，较小的API变动；修订版本更新意味着 Bug 修复与软件包版本更新。

Pigsty 计划每年发布一次主版本更新，次版本更新通常跟随 PostgreSQL 小版本更新节奏，在 PostgreSQL 新版本发布后最迟一个月内跟进。 Pigsty 通常每年计划 4 - 6 个小版本，完整发布历史请参考 发行注记 。

列入考虑的新特性

• Agent Native CLI - PIG
• DBA Agent - 基本集成
• Grafana Dashboard 改进
• Boar 管理平台

这里是我们的 活跃议题 与 路线图。

扩展插件与软件包

关于扩展支持的路线图，可以在这里找到：https://pgext.cloud/e/roadmap

考虑纳入

• PDU : https://github.com/wublabdubdub/PDU-PostgreSQLDataUnloader
• walminer https://gitee.com/movead/XLogMiner
• is_jsonb_valid https://github.com/furstenheim/is_jsonb_valid
• pg_kafka https://github.com/xstevens/pg_kafka
• pg_jieba https://github.com/jaiminpan/pg_jieba
• pg_paxos https://github.com/microsoft/pg_paxos
• OneSparse https://github.com/OneSparse/OneSparse
• PipelineDB https://github.com/pipelinedb/pipelinedb
• SQL Firewall https://github.com/uptimejp/sql_firewall
• zcurve https://github.com/bmuratshin/zcurve
• PG dot net https://github.com/Brick-Abode/pldotnet/releases
• pg_scws: https://github.com/jaiminpan/pg_scws
• themsis: https://github.com/cossacklabs/pg_themis
• pgspeck https://github.com/johto/pgspeck
• lsm3 https://github.com/postgrespro/lsm3
• monq https://github.com/postgrespro/monq
• pg_badplan https://github.com/trustly/pg_badplan
• pg_recall https://github.com/mreithub/pg_recall
• pgfsm https://github.com/michelp/pgfsm
• pg_trgm pro https://github.com/postgrespro/pg_trgm_pro
• pgsql-fio: https://github.com/csimsek/pgsql-fio

暂不考虑

• pg_tier: not ready due to incomplete dep parquet_s3_fdw
• parquet_s3_fdw: not ready due to compiler version
• pg_top: not ready due to cmake error
• timestamp9: not ready due to compiler error
• pg_tier obsolete
• pg_timeseries, we already have timescaledb
• pg_quack, we already have a pg_lakehouse
• pg_telemetry, we already have better observability
• pgx_ulid, https://github.com/pksunkara/pgx_ulid, already covered by pg_idkit (MIT, but RUST)
• embedding: obsolete
• FEAT zson https://github.com/postgrespro/zson MIT C (too old)
• GIS pghydro https://github.com/pghydro/pghydro C GPL-2.0 6.6 (no makefile)
• https://github.com/Zeleo/pg_natural_sort_order (too old)
• https://github.com/postgrespro/pg_query_state
• https://github.com/no0p/pgsampler
• pg_lz4 https://github.com/zilder/pg_lz4
• pg_amqp https://github.com/omniti-labs/pg_amqp
• tinyint https://github.com/umitanuki/tinyint-postgresql
• pg_blkchain https://github.com/blkchain/pg_blkchain
• hashtypes https://github.com/pandrewhk/hashtypes
• foreign_table_exposer https://github.com/komamitsu/foreign_table_exposer
• ldap_fdw https://github.com/guedes/ldap_fdw
• pg_backtrace https://github.com/postgrespro/pg_backtrace
• connection_limits https://github.com/tvondra/connection_limits
• fixeddecimal https://github.com/2ndQuadrant/fixeddecimal

2.5 - 加入社区

GitHub

我们的 GitHub 仓库地址是：https://github.com/pgsty/pigsty ，欢迎点个 ⭐️ 关注 我们。

我们欢迎任何人 提交新 Issue 或创建 Pull Request，提出功能建议并参与 Pigsty 贡献。

请注意，关于 Pigsty 文档的问题，请在 github.com/Vonng/pigsty.cc 仓库中提交 Issue。

微信群组

中文区用户主要活跃于微信群组中，目前有七个活跃的群组，1群-4群已经满员，其他群需要添加小助手微信拉入。

加入微信社群，请用搜索 “Pigsty小助手”，（微信号 pigsty-cc） 备注或发送 “加群” ，小助手会将您拉入群组中。

海外社群

Telegram: https://t.me/joinchat/gV9zfZraNPM3YjFh

Discord: https://discord.gg/j5pG8qfKxU

您也可以通过邮件联系我： [email protected]

社区求助

当您使用 Pigsty 遇到问题时，可以向社区求助，您提供的信息越丰富，就越有可能在社区得到帮助。

请参考 社区求助指南 ，尽可能提供足够的信息，以便社区成员帮助您解决问题。以下是求助提问的参考模板：

发生了什么事？ (必选项)

Pigsty版本号与操作系统版本 (必选项)

$ grep version pigsty.yml 

$ cat /etc/os-release

$ uname -a

一些云厂商对标准操作系统发行版进行了定制，您可以告诉我们使用的是哪一家云厂商的什么操作系统镜像。 如果您在安装操作系统后对环境进行了定制与修改，或者在您的局域网中有特定的安全规则与防火墙配置，也请在提问时告知我们。

Pigsty配置文件

请不要忘记抹掉任何敏感信息：密码，内部密钥，敏感配置等。

cat ~/pigsty/pigsty.yml

你期待发生什么？

请描述正常情况下应该发生什么事情，实际发生的情况与期待的情况有何偏离？

如何复现此问题？

请尽可能详细地告诉我们复现此问题的方法与步骤。

监控截图

如果你在使用 Pigsty 提供的监控系统，可以提供 相关 的截图。

错误日志

请尽可能提供与错误有关的日志。请不要粘贴类似 “Failed to start xxx service” 之类没有信息量的内容。

您可以从 Grafana / VictoriaLogs 中查询日志，或从以下位置获取日志：

• Syslog: /var/log/messages (rhel) or /var/log/syslog (debian)
• Postgres: /pg/log/postgres/*
• Patroni: /pg/log/patroni/*
• Pgbouncer: /pg/log/pgbouncer/*
• Pgbackrest: /pg/log/pgbackrest/*

journalctl -u patroni
journalctl -u <service name>

您已经搜索过 Issue/网站/FAQ了吗？

在 FAQ 中，我们提供了许多常见问题的解答，请在提问前检查

您也可以从 Github Issue 与 Discussion 中搜索相关问题：

• Pigsty常见问题
• Github 议题
• Pigsty 讨论组

有什么其他信息是我们需要知道的吗？

您提供的信息与上下文越丰富，我们越有可能帮助您解决问题。

2.6 - 隐私政策

Pigsty软件

当您安装 Pigsty 软件时，如果在网络隔离的环境中使用离线软件包安装，我们不会收到任何关于您的数据。

如果您选择在线安装，那么在下载相关软件包时，我们的服务器或云供应商的服务器会自动在日志中记录来访机器的 IP 地址和/或主机名，和您下载的软件包名称。 除非法律要求，我们不会与其他组织共享这些信息。（实话说，吃饱了撑着才会去看这些东西）

Pigsty 使用的主域名为：pigsty.io ，中国大陆请使用中文备案镜像站点 pigsty.cc。

Pigsty网站

当您访问我们的网站时，我们的服务器会自动在 Nginx 日志中记录您的 IP 地址和/或主机名。 仅当您决定通过完成调查或在我们的某个网站上注册为用户来向我们发送此类信息时，我们才会存储您的电子邮件地址、姓名和地点等信息

我们收集这些信息是为了帮助我们改进网站内容、定制网页布局以及出于技术和支持目的联系人员。除非法律要求，我们不会与其他组织共享您的电子邮件地址。

本网站使用 Google Analytics，这是 Google, Inc.（“Google”）提供的一项网络分析服务。谷歌分析使用“cookies”，即放置在您计算机上的文本文件，帮助网站分析用户如何使用该网站。

cookie 生成的有关您使用网站的信息（包括您的 IP 地址）将被传输至 Google 位于美国的服务器并由其存储。谷歌将使用这些信息来评估您对网站的使用情况，为网站运营商编制网站活动报告，并提供与网站活动和互联网使用相关的其他服务。 如果法律要求，或者第三方代表 Google 处理信息，Google 还可能会将此信息传输给第三方。 Google 不会将您的 IP 地址与 Google 持有的任何其他数据关联起来。 您可以通过在浏览器上选择适当的设置来拒绝使用 cookie，但请注意，如果您这样做，您可能无法使用本网站的全部功能。使用本网站即表示您同意 Google 以上述方式和目的处理有关您的数据。

如果您对此政策有任何疑问或意见，或要求删除个人数据，您可以通过发送邮件至 [email protected] 与我们联系

2.7 - 开源协议

协议摘要

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 的文档与网站（包括但不限于：pigsty.cc，pigsty.io，pgsty.com ）均使用 Creative Commons Attribution 4.0 International (CC BY 4.0) 许可证。 CC BY 4.0 是一种知识共享许可证，允许您自由地分享与演绎本站的内容，但是您必须给出 适当的署名，提供指向许可证的链接，并 指出是否有对原始内容进行了修改。

SBOM 清单

以下为 Pigsty 项目所使用或相关的开源软件及其开源协议。

451 个 PostgreSQL 扩展插件的许可证请参考 PostgreSQL 扩展许可证清单。

必要性等级说明：

• 必选：提供 Pigsty 关键性核心能力，不提供关闭停用选项
• 建议：Pigsty 默认启用 的组件，可以通过配置选项停用
• 可选：Pigsty 默认支持但不启用的组件，可通过配置启用

Apache-2.0 许可证原文

                                 Apache License
                           Version 2.0, January 2004
                        http://www.apache.org/licenses/

   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

   1. Definitions.

      "License" shall mean the terms and conditions for use, reproduction,
      and distribution as defined by Sections 1 through 9 of this document.

      "Licensor" shall mean the copyright owner or entity authorized by
      the copyright owner that is granting the License.

      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
      outstanding shares, or (iii) beneficial ownership of such entity.

      "You" (or "Your") shall mean an individual or Legal Entity
      exercising permissions granted by this License.

      "Source" form shall mean the preferred form for making modifications,
      including but not limited to software source code, documentation
      source, and configuration files.

      "Object" form shall mean any form resulting from mechanical
      transformation or translation of a Source form, including but
      not limited to compiled object code, generated documentation,
      and conversions to other media types.

      "Work" shall mean the work of authorship, whether in Source or
      Object form, made available under the License, as indicated by a
      copyright notice that is included in or attached to the work
      (an example is provided in the Appendix below).

      "Derivative Works" shall mean any work, whether in Source or Object
      form, that is based on (or derived from) the Work and for which the
      editorial revisions, annotations, elaborations, or other modifications
      represent, as a whole, an original work of authorship. For the purposes
      of this License, Derivative Works shall not include works that remain
      separable from, or merely link (or bind by name) to the interfaces of,
      the Work and Derivative Works thereof.

      "Contribution" shall mean any work of authorship, including
      the original version of the Work and any modifications or additions
      to that Work or Derivative Works thereof, that is intentionally
      submitted to Licensor for inclusion in the Work by the copyright owner
      or by an individual or Legal Entity authorized to submit on behalf of
      the copyright owner. For the purposes of this definition, "submitted"
      means any form of electronic, verbal, or written communication sent
      to the Licensor or its representatives, including but not limited to
      communication on electronic mailing lists, source code control systems,
      and issue tracking systems that are managed by, or on behalf of, the
      Licensor for the purpose of discussing and improving the Work, but
      excluding communication that is conspicuously marked or otherwise
      designated in writing by the copyright owner as "Not a Contribution."

      "Contributor" shall mean Licensor and any individual or Legal Entity
      on behalf of whom a Contribution has been received by Licensor and
      subsequently incorporated within the Work.

   2. Grant of Copyright License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      copyright license to reproduce, prepare Derivative Works of,
      publicly display, publicly perform, sublicense, and distribute the
      Work and such Derivative Works in Source or Object form.

   3. Grant of Patent License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      (except as stated in this section) patent license to make, have made,
      use, offer to sell, sell, import, and otherwise transfer the Work,
      where such license applies only to those patent claims licensable
      by such Contributor that are necessarily infringed by their
      Contribution(s) alone or by combination of their Contribution(s)
      with the Work to which such Contribution(s) was submitted. If You
      institute patent litigation against any entity (including a
      cross-claim or counterclaim in a lawsuit) alleging that the Work
      or a Contribution incorporated within the Work constitutes direct
      or contributory patent infringement, then any patent licenses
      granted to You under this License for that Work shall terminate
      as of the date such litigation is filed.

   4. Redistribution. You may reproduce and distribute copies of the
      Work or Derivative Works thereof in any medium, with or without
      modifications, and in Source or Object form, provided that You
      meet the following conditions:

      (a) You must give any other recipients of the Work or
          Derivative Works a copy of this License; and

      (b) You must cause any modified files to carry prominent notices
          stating that You changed the files; and

      (c) You must retain, in the Source form of any Derivative Works
          that You distribute, all copyright, patent, trademark, and
          attribution notices from the Source form of the Work,
          excluding those notices that do not pertain to any part of
          the Derivative Works; and

      (d) If the Work includes a "NOTICE" text file as part of its
          distribution, then any Derivative Works that You distribute must
          include a readable copy of the attribution notices contained
          within such NOTICE file, excluding those notices that do not
          pertain to any part of the Derivative Works, in at least one
          of the following places: within a NOTICE text file distributed
          as part of the Derivative Works; within the Source form or
          documentation, if provided along with the Derivative Works; or,
          within a display generated by the Derivative Works, if and
          wherever such third-party notices normally appear. The contents
          of the NOTICE file are for informational purposes only and
          do not modify the License. You may add Your own attribution
          notices within Derivative Works that You distribute, alongside
          or as an addendum to the NOTICE text from the Work, provided
          that such additional attribution notices cannot be construed
          as modifying the License.

      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,
      reproduction, and distribution of the Work otherwise complies with
      the conditions stated in this License.

   5. Submission of Contributions. Unless You explicitly state otherwise,
      any Contribution intentionally submitted for inclusion in the Work
      by You to the Licensor shall be under the terms and conditions of
      this License, without any additional terms or conditions.
      Notwithstanding the above, nothing herein shall supersede or modify
      the terms of any separate license agreement you may have executed
      with Licensor regarding such Contributions.

   6. Trademarks. This License does not grant permission to use the trade
      names, trademarks, service marks, or product names of the Licensor,
      except as required for reasonable and customary use in describing the
      origin of the Work and reproducing the content of the NOTICE file.

   7. Disclaimer of Warranty. Unless required by applicable law or
      agreed to in writing, Licensor provides the Work (and each
      Contributor provides its Contributions) on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
      implied, including, without limitation, any warranties or conditions
      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
      PARTICULAR PURPOSE. You are solely responsible for determining the
      appropriateness of using or redistributing the Work and assume any
      risks associated with Your exercise of permissions under this License.

   8. Limitation of Liability. In no event and under no legal theory,
      whether in tort (including negligence), contract, or otherwise,
      unless required by applicable law (such as deliberate and grossly
      negligent acts) or agreed to in writing, shall any Contributor be
      liable to You for damages, including any direct, indirect, special,
      incidental, or consequential damages of any character arising as a
      result of this License or out of the use or inability to use the
      Work (including but not limited to damages for loss of goodwill,
      work stoppage, computer failure or malfunction, or any and all
      other commercial damages or losses), even if such Contributor
      has been advised of the possibility of such damages.

   9. Accepting Warranty or Additional Liability. While redistributing
      the Work or Derivative Works thereof, You may choose to offer,
      and charge a fee for, acceptance of support, warranty, indemnity,
      or other liability obligations and/or rights consistent with this
      License. However, in accepting such obligations, You may act only
      on Your own behalf and on Your sole responsibility, not on behalf
      of any other Contributor, and only if You agree to indemnify,
      defend, and hold each Contributor harmless for any liability
      incurred by, or claims asserted against, such Contributor by reason
      of your accepting any such warranty or additional liability.

   END OF TERMS AND CONDITIONS

   APPENDIX: How to apply the Apache License to your work.

      To apply the Apache License to your work, attach the following
      boilerplate notice, with the fields enclosed by brackets "[]"
      replaced with your own identifying information. (Don't include
      the brackets!)  The text should be enclosed in the appropriate
      comment syntax for the file format. We also recommend that a
      file or class name and description of purpose be included on the
      same "printed page" as the copyright notice for easier
      identification within third-party archives.

   Copyright (C) 2018-2026  Ruohang Feng, @Vonng ([email protected])

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

2.8 - 赞助我们

赞助我们

Pigsty 是一个开源免费的自由软件，由 PostgreSQL 社区成员用热情浇灌而成，旨在整合 PostgreSQL 生态的力量，推广 PostgreSQL 的普及。 如果我们的工作帮到了您，请考虑赞助或者支持一下我们的项目：

• 直接打钱赞助我们，用最直接有力的鼓舞表达您的真挚支持！
• 考虑采购我们的 技术支持服务，我们可以提供专业的 PostgreSQL 高可用集群部署与维护服务，让您的预算花得物有所值！
• 通过文章，讲座，视频分享您使用 Pigsty 的案例与经验。
• 允许我们在 “这些用户使用了Pigsty” 中提及您的组织。
• 向有需求的朋友，同事与客户提名/推荐我们的项目与服务。
• 关注我们的 微信公众号 并转发相关技术文章至群组与朋友圈。

天使投资人

Pigsty 是由 奇绩创坛 （原YC中国，MiraclePlus） S22 所投资的项目，感谢奇绩创坛与陆奇博士对本项目的支持！

赞助者

感谢我们的赞助者 Vercel，为 Pigsty 网站提供了赞助与网站托管基础设施。

2.9 - 行业案例

根据 Google Analytics PV 与下载量，Pigsty 目前有约 10 万用户，一半来自中国大陆，一半来自全球其他地区。 遍布互联网、云计算、金融、自动驾驶、制造业、科技创新、ISV 与军工等多个行业。 如果您在 使用 Pigsty 并且愿意与我们分享您的案例与 Logo，欢迎联系我们，我们提供一次的免费咨询支持。

互联网

探探：两百台+物理机，用于 PostgreSQL 与 Redis 服务

哔哩哔哩：用于支持 PostgreSQL 创新业务

云厂商

Bitdeer：比特小鹿，提供 PG DBaaS

Oracle OCI：使用 Pigsty 交付 PostgreSQL 集群。

金融行业

AirWallex：监控 200+ GCP PostgreSQL 数据库

影视行业

影视飓风：自建 PG RDS / Victoria Metrics

自动驾驶

Momenta：自动驾驶，管理自建 PostgreSQL 集群

制造业

华峰集团：使用 Pigsty 交付 PostgreSQL 集群作为化工时序数据仓库

科技创新

北京领雾科技：云上 PostgreSQL 下云自建

Motphys：自建 PostgreSQL 支持 Gitlab

赛陇生物科技：自建 Supabase

杭州零码科技：自建 PostgreSQL

ISV

内蒙古豪德天沐科技有限公司

上海元芳

DSG

军工

北京某部队

上海某部队

电科36所

机械工业研究所

航天一院

2.10 - 订阅服务

Pigsty 旨在聚集PG生态的合力，并用自动驾驶的数据库管控软件帮助用户用好世界上 最流行 的数据库 PostgreSQL。

尽管 Pigsty 本身已经解决了 PG 使用中的诸多问题。但想真正达到企业级服务的质量，原厂提供的专家支持与兜底服务不可或缺。 我们深知专业的商业支持服务对于企业客户的重要性，因此，Pigsty 企业版在开源版本的基础上提供了一系列增值服务，帮助用户更好地用好 PostgreSQL 与 Pigsty，供有需求的客户按需选用。

如果您有下列需求，欢迎考虑 Pigsty 订阅服务：

• 在关键场景中运行数据库，需要严格 SLA 保障兜底。
• 希望对 Pigsty 与 PostgreSQL 相关疑难杂症提供兜底。
• 希望获取关于 PostgreSQL / Pigsty 生产环境最佳实践的指导。
• 希望有专家帮助解读监控图表，分析定位性能瓶颈与故障根因，给出意见。
• 希望根据现有资源与业务需求，规划满足安全/容灾/合规要求的数据库架构。
• 需要将其他数据库迁移至 PostgreSQL 数据库，或对历史遗留实例迁移与改造。
• 建设基于Prometheus / Grafana 技术栈的可观测性体系，数据大盘，可视化应用。
• 希望支持国产信创操作系统/国产信创 ARM 芯片架构，提供中文/本地化界面支持。
• 下云并寻求 RDS for PostgreSQL 的开源替代 —— 云中立，无供应商锁定的解决方案。
• 希望获取关于 Redis / ETCD / MinIO，以及 TimescaleDB / Citus 等扩展的专业支持。
• 希望将 Pigsty 作为 SaaS / PaaS / DBaaS 对外销售，或基于此发行版提供技术服务/云服务。

订阅计划

除了 开源版 之外，Pigsty 提供两种不同的订阅服务档位：专业版 与 企业版，您可以根据自身的实际情况与需求选购。

Pigsty开源版

Pigsty 开源版使用 Apache-2.0 许可证， 提供了完整核心功能，无需任何费用，但也不承诺任何质保服务。如果您发现了 Pigsty 的缺陷，我们非常欢迎您在 Github 上提出 Issue。

针对开源版本，我们提供 PostgreSQL 18 在 EL 9.6，Debian 12.11，Ubuntu 22.04.5 三个精准操作系统发行版最新小版本上的预制标准离线软件包（作为对开源的支持，同时提供 Debian 12 的 Arm64 离线软件包）。

使用 Pigsty 开源版本，可以让初级研发工程师 / 运维工程师拥有专业 DBA 70%+ 的能力，在缺少数据库专家的情况下，也能够轻松搭建一个高可用，高性能，易维护，安全可靠的 PostgreSQL 数据库集群。

= 首要支持， = 选配支持

Pigsty专业版

Pigsty 专业版订阅提供了完整的功能模块，以及对于 Pigsty 本身的质保。关于 PostgreSQL 本身与扩展插件的缺陷，我们将尽最大努力通过 PostgreSQL 全球开发者社区进行反馈与修复。

Pigsty 专业版构建于开源版基础之上，完全兼容开源版本的所有功能，并提供额外的功能模块，与更为宽广的数据库 / 操作系统版本兼容选项：我们将针对五个主流操作系统发行版的 所有小版本 提供构建选项。

Pigsty 专业版包含了对 最近两个 PostgreSQL 大版本（18，17）的支持，提供两个大版本中的所有可用的扩展插件，确保您可以通过滚动升级的方式，平滑迁移到最新的 PostgreSQL 大版本上。

Pigsty 专业版订阅允许您使用中国大陆镜像站点软件仓库，无需翻墙代理即可访问；同时我们将针对您使用的精准操作系统大小版本定制离线软件安装包，确保在断网环境下也能正常安装交付，做到自主可控。

Pigsty 专业版订阅提供了标准的专家咨询服务，包括疑难杂症分析，DBA 答疑解惑，备份合规建议等，我们承诺在工作日（5x8）时效内响应您的问题，并且每年提供 1 人天支持，以及可选的人天加购选项。

Pigsty 专业版使用商业许可证，提供额外的功能模块、技术支持与质保服务。

Pigsty 专业版的起售价格 ¥150,000 / 年，相当于 9 vCPU 的 AWS 高可用 RDS PG 年费， 或月薪 一万元 的初级运维工程师。

Pigsty企业版

Pigsty 企业版订阅包含 Pigsty 专业版订阅提供的全部服务内容，和以下增值服务项：

Pigsty 企业版订阅提供最为广泛的数据库/操作系统版本支持范围，包括对过保操作系统（EL7, U20, D11），国产操作系统，云厂商操作系统，以及过保数据库大版本（从 PG 13 开始）的延长支持，以及对 Arm64 架构芯片的完整支持。

Pigsty 企业版订阅提供了信创，国产化解决方案，允许您在 Pigsty 中使用 PolarDB v2.0 （此内核许可需单独采购）内核替换原生 PostgreSQL 内核，以满足国产化合规要求。

Pigsty 企业版订阅提供了更高标准的企业级咨询服务，承诺 7x24 提供 (< 1h) 的响应时间 SLA，并可提供更多种类的咨询支持：版本升级，性能瓶颈定位，年度架构评估，扩展插件收录等。

Pigsty 企业版订阅每年自带 2 人天支持，以及可选的人天加购选项，用于解决各种更为棘手复杂耗时的问题。

Pigsty 企业版允许您将 Pigsty 用于 DBaaS 用途，建设云数据库服务对外出售。

Pigsty 企业版的起步价格为 ¥400,000 / 年，相当于 24 vCPU 的 AWS 高可用 RDS 年费，或月薪 三万元 的运维专家。

Pigsty订阅说明

功能差异

Pigsty 专业版/企业版相比开源版本，包含以下额外功能：

• 命令行管理工具： 解锁 Pigsty 命令行工具（ pig ）的完整功能
• 系统定制能力：针对精确的主流Linux操作系统发行版大小版本提供预制的离线安装包
• 离线安装能力：在没有互联网访问的环境中（断网环境）实现 Pigsty 的完整安装
• PG内核多版本：允许用户自由指定并安装 PostgreSQL 生命周期内大版本的内核（13 - 17）
• 内核替换能力：允许用户使用其他 PostgreSQL 系兼容内核，替换原生 PG 内核，以及离线安装这些内核的能力
  • Babelfish：提供 Microsoft SQL Server 线缆协议级兼容能力
  • IvorySQL：基于 PG 提供 Oracle 语法/类型/存储过程兼容能力
  • PolarDB PG：提供基于开源的 PolarDB for PostgreSQL 内核支持
  • PolarDB O：信创数据库，满足国产化合规要求的 Oracle 兼容内核（仅限企业版订阅）
• 扩展支持能力：针对 451 个可用 PG Extension，提供 PG 13-18 在主流操作系统上开箱即用的安装能力。
• 完整功能模块：提供所有功能模块：
  • Supabase：可靠地自建生产级开源 Firebase
  • MinIO：企业PB级对象存储规划与自建
  • DuckDB：提供完善的 DuckDB 支持，以及 PostgreSQL + DuckDB OLAP 扩展插件支持
  • Kafka：提供高可用的 Kafka 集群部署与监控
  • Kubernetes, VictoriaMetrics & VictoriaLogs
• 国产操作系统支持：提供国产信创操作系统支持选项（仅限企业版订阅）
• 国产ARM架构支持：提供国产 ARM64 架构支持选项（仅限企业版订阅）
• 中国大陆镜像仓库：无需科学上网即可顺畅安装，提供境内 YUM/APT 仓库镜像与 DockerHub 访问代理。
• 中文界面支持：监控系统中文版界面支持（Beta）

付费模式

Pigsty 订阅采用按年付费的模式，签订合同后，从合同约定日起计算一年的有效期。订阅合同到期前如果继续打款则视为自动续订。 连续订阅有折扣，第一次续签（第二年）享受 95 折优惠，第二次以及后续的续签享受订阅费用 9 折优惠，一次性订阅三年以上整体费用享受 85 折优惠。

在年度订阅合同终止后，您可以选择不续签订阅服务，Pigsty 将不再提供软件更新，技术支持，咨询服务，但您仍然可以继续使用已经安装版本的 Pigsty 专业版软件。 如果您订阅了 Pigsty 专业服务并选择不续订，在重新订阅时 无需 补齐中断期间的订阅费用，但所有折扣与优惠将重置。

Pigsty 的定价策略确保用户物有所值 —— 您可以立即获得顶尖 DBA 的数据库架构建设方案与管理最佳实践，并由其提供咨询答疑与服务支持兜底； 而付出的成本相比于全职雇佣数据库专家或使用云数据库极具竞争力。以下是市场上 企业级数据库专业服务市场定价参考：

• AWS RDS for PostgreSQL 高可用版：¥1,160 ～ ¥1,582 / (vCPU·月) ，折合人民币 14K ~ 19K/年 （每vCPU）
• 阿里云 RDS for PostgreSQL 高可用版：¥270 ～ ¥432 / (vCPU·月)，折合人民币 3K ~ 5K/年 （每vCPU）
• EDB PostgreSQL 云数据库企业版： $183.3 / (vCPU·月)，折合人民币 16K/年 （每vCPU）
• 富士通企业级 PostgreSQL Kubernetes： $3200 / (Core·年)，折合人民币 12K/年 （每vCPU）
• Oracle 年度服务费： (Enterprise $47,500 + Rac $23,000) * 22% 每年，折合人民币 28K /年 （每vCPU）

体面数据库专业服务的公允价格是 1 ~ 2 万元 / 年，计费单位为 vCPU，即一个 CPU 线程（1 Intel 核 = 2 vCPU 线程）。 而 Pigsty 提供国内顶尖的 PostgreSQL 专家服务，并采用 按节点计费 的模式，在当下常见的高核数服务器节点上，能为用户带来无可比拟的 降本增效 体验。

Pigsty专家服务

除了 Pigsty 订阅，Pigsty 还提供按需采购的 Pigsty x PostgreSQL 专家服务 —— 业界顶级数据库专家坐堂问诊。

服务主体

Pigsty 目前由作者 冯若航 独资运营维护，商业主体为：

• 海南诸夏云数据有限公司 / 91460000MAE6L87B94
• 海口龙华辟技数据中心 / 92460000MAG0XJ569B
• 海口龙华越航科技中心 / 92460000MACCYGBQ1N

PIGSTY® 与 PGSTY® 为海口龙华越航科技中心的注册商标。

商务咨询请发送邮件至 [email protected] 。中国大陆地区用户欢迎添加微信号 RuohangFeng。

Pigsty 是奇绩创坛 S22 被投项目，原主体 磐吉云数（北京）科技有限责任公司 已经清算剥离 Pigsty 业务，与 Pigsty 无关。

2.11 - 常见问题

Pigsty 是什么，不是什么？

Pigsty 是一个 PostgreSQL 数据库发行版，本地优先的开源 RDS 云数据库解决方案。 Pigsty 不是数据库管理系统（DBMS），而是管理 DBMS 的工具，发行版，解决方案，与最佳实践。

类比：数据库是车，那么 DBA 是司机，RDS 是出租车服务，Pigsty 则是自动驾驶软件。

Pigsty 解决什么问题？

用好数据库的能力 极为稀缺：要么高薪聘请数据库专家自建（雇司机），或从云厂商以天价租赁 RDS（打车），但现在你有新的选项：Pigsty（自动驾驶）。 Pigsty 帮用户用好数据库：让用户在没有 DBA 的情况下，以不到 RDS 1 / 10 的成本，自建质量效率更优的本地云数据库服务！

Pigsty 的目标用户是谁？

Pigsty 有两类典型目标用户，基本盘是 中大型公司 超大规模自建企业级/生产级 PostgreSQL RDS / DBaaS 服务。 Pigsty 通过极致的可定制性，可以实现最苛刻场景的数据库管理需求，并提供企业级的支持与服务保障。

与此同时，Pigsty 也针对个人开发者，缺乏 DBA 中小企业以及开源社区提供 “开箱即用” 的 PG RDS 自建方案。

Pigsty 为什么能帮您用好数据库？

Pigsty 沉淀了顶尖专家在最复杂，最大规模的甲方 PostgreSQL 场景中打磨得到的经验与最佳实践，产品化为可复制的软件： 一次性解决扩展安装，高可用，链接池，监控，备份恢复，参数优化，IaC 批量管理，一键安装，自动化运维等诸多问题。提前规避诸多陷阱，避免重复踩坑。

Pigsty 为何比 RDS 好用？

Pigsty 提供远超 RDS 的特性集与基础设施支持，包括 451 扩展插件与 8+ 内核支持。 Pigsty 提供 PG 生态中独一无二的专业级监控系统，与久经复杂场景打磨考验的架构最佳实践，简单易用。

且用探探，苹果，阿里等顶级甲方场景打磨而成，用激情与热爱持续浇灌，深度与成熟度绝非 RDS 大锅饭可比。

Pigsty 为何比 RDS 省钱？

Pigsty 允许您使用 10 ¥/核·月的纯硬件资源，运行 400¥-1400¥/核·月的 RDS 云数据库，并省去 DBA 的工资。通常，成规模的 Pigsty 部署总拥有成本（TCO）能比 RDS 低 90% 以上。

Pigsty 能够同时降低软件许可/服务/人力的开销，自建无需加人，让您将成本花在刀刃上。

Pigsty 对研发有什么帮助？

Pigsty 整合了 PG 生态最全的扩展（451），提供了 All in PG 解决方案：单一组件替代 Redis, Kafka, MySQL, ES, 向量数据库, OLAP / 大数据分析等专用组件。

极大提高研发效能与敏捷性的同时降低复杂度成本，而且研发能在 Pigsty 的加持下实现自助管理，自主 DevOps，无需 DBA。

Pigsty 对运维有什么帮助？

Pigsty 故障自愈的高可用架构确保硬件故障无需当场处理，让运维与 DBA 睡个好觉；监控助力问题分析与性能优化；IaC 赋能超大规模集群自动化管理。

运维在 Pigsty 加持下能兼职 DBA ，而 DBA 则可以跳过系统建设阶段，节省大量工时并专注于高价值工作，或喝茶看报，学习PG。

Pigsty 的作者是谁？

Pigsty 主体由冯若航一人开发，这是一位专注于 PostgreSQL 领域 10 年的开源贡献者，数据库专家与布道师， 曾任职于阿里，探探，苹果，全栈专家。现为一人公司创始人，提供专业咨询服务。

同时他也是技术 KOL，微信数据库个人公众号榜首 《非法加冯》 的主理人，全网粉丝六万+。

Pigsty 的生态位与影响力如何？

Pigsty 全球 PostgreSQL 生态中最有影响力的中国开源项目，共有约十万用户，一半来自海外。 Pigsty 也是 PostgreSQL 生态最活跃的开源项目之一，目前在扩展分发与监控系统上占据碾压性优势。

PGEXT.Cloud 是由 Pigsty 维护的 PostgreSQL 扩展仓库，拥有全球最多的 PostgreSQL 扩展分发量。 目前已经成为多家国际 PostgreSQL 厂商的软件供应链上游。

Pigsty 目前是 PostgreSQL 生态的主要发行版之一，也是云厂商 RDS 的挑战者，目前已经广泛应用于军工，政企，医疗，互联网，金融，制造业等各个行业。

Pigsty 适合什么规模的客户？

Pigsty 源于超大规模 PostgreSQL 自动化管理的需求，但已针对易用性进行深度优化，缺乏专业 DBA 能力的个人开发者与中小型企业也可以轻松上手使用。

最大规模部署为 25K vCPU，450万QPS，六年+，最小规模部署可完整运行于 1c1g 虚拟机上作为 Demo / Devbox 使用。

Pigsty 提供哪些能力？

Pigsty 专注于整合 PostgreSQL 生态，提供 PostgreSQL 的最佳实践，但同时也支持一系列与 PostgreSQL 配合良好的开源软件。例如：

• Etcd, Redis, MinIO, DuckDB, Prometheus
• FerretDB, Babelfish, IvorySQL, PolarDB, OrioleDB
• OpenHalo, Supabase, Greenplum, Dify, Odoo, …

Pigsty 适用于哪些场景？

• 运行大规模 PostgreSQL 集群用于业务
• 自建 RDS，对象存储，缓存，数仓，Supabase, …
• 自建 Odoo，Dify，Wiki，GitLab 等企业级应用
• 运行监控基础设施，监控现有数据库与主机
• 同时组合使用多种 PG 扩展插件
• 大屏开发与交互式数据应用 Demo，数据可视化，Web 建站

Pigsty 开源免费吗？

Pigsty 是 100% 的开源软件 + 自由软件，在遵循开源许可证的前提下，您可以将其免费地，自由的用于各种商业目的。

我们珍视软件自由，对于非 DBaaS / OEM 用例，我们执行更为宽松的等效 Apache 2.0 许可证。请参阅许可证以获取更多详细信息。

Pigsty 提供商业支持吗？

Pigsty 软件本身开源免费，并提供丰俭由人的商业订阅，为 Pigsty & PostgreSQL 提供质保。 订阅提供更宽广的 OS/PG/芯片架构支持范围，以及专家咨询与支持。 Pigsty 商业订阅交付业界顶尖的管理/技术经验/解决方案， 帮助您节省宝贵的时间，替您扛雷，并为疑难杂症兜底。

Pigsty 支持国产信创吗？

Pigsty 软件本身不属于数据库，不受信创名录限制，且已有多个部队用例。但 Pigsty 开源版不提供任何形式的信创支持。 商业版订阅提供与阿里云合作的国产信创解决方案，支持使用具有信创资质的 PolarDB-O（需单独采购）作为 RDS 内核，能够运行于信创操作系统/芯片环境。

Pigsty 可以换 Logo 贴牌为自己的产品吗？

再分发 Pigsty 时，您必须保留原作品中的版权声明、专利声明、商标声明和归属声明， 并且需要在修改的文件中附上显著的变更说明，同时保留 LICENSE 文件的内容。 在此前提下，您可以更换 PIGSTY 的 Logo 与商标，但不得宣传为 “自己原创的作品”。 我们在企业版本中提供对 OEM 与贴牌的商业授权支持。

Pigsty 的服务主体

Pigsty 是奇绩创坛 S22 被投项目，原主体 磐吉云数（北京）科技有限责任公司 已经清算剥离 Pigsty 业务，与 Pigsty 无关。

Pigsty 目前由作者冯若航个人独资运营维护，商业主体为：

• 海南诸夏云数据有限公司 / 91460000MAE6L87B94
• 海口龙华辟技数据中心 / 92460000MAG0XJ569B
• 海口龙华越航科技中心 / 92460000MACCYGBQ1N

PIGSTY® 与 PGSTY® 为海口龙华越航科技中心的注册商标。

2.12 - 发布注记

Pigsty 当前的最新稳定版本为 v4.2.1。

v4.2.1

这是一个维护版本，新增了 3 个扩展插件，

主要变更

• 新增扩展：pg_eviltransform 加入 GIS 包组，pg_pinyin 加入 FTS 包组，pg_qos 加入 Admin 包组 —— 均支持 PG 14–18。
• 移除 PG13：所有平台变体（EL7/8/9/10、Debian 12/13、Ubuntu 22/24，x86_64 与 aarch64）中的 pgdg13、pgdg13-nonfree 仓库条目和 PG13 包别名（pg13-*）全部移除。
• 配置模板（fat.yml、pro.yml、dev.yml、el.yml、debian.yml）不再引用 PG13 包或仓库。扩展版本注释更新为仅覆盖 PG 14–18。
• Percona 仓库：Origin URL 从 ppg-18.1 更新为 ppg-18.3，跟踪最新 Percona PostgreSQL 发行版。
• Nginx 仓库：Debian/Ubuntu 平台上 Nginx 上游 APT 仓库的模块标签从 infra 修正为 nginx。
• UV Venv 修复：roles/node/tasks/pkg.yml 现在会先检查虚拟环境是否已存在，避免重复执行 uv venv 导致的冗余创建或重新置备报错。
• Docker 镜像：Pigsty Docker 镜像基础包中新增 less。
• Demo 配置：el.yml 和 debian.yml 示例配置的默认防火墙规则新增 5432 端口，支持直接访问 PostgreSQL。

兼容性说明

PostgreSQL 13 已于 2025-11-13 到达生命周期终点。 PGDG YUM 仓库已经归档移除 pg13 / pg12 目录。 如果您在 EL 系统上安装 Pigsty （即使没有使用 PG 13 版本），也有可能因为仓库访问失败而导致安装或更新失败。

您可以选择直接使用 Pigsty v4.2.1，或者手工修改 roles/node_id/vars/ 您对应操作系统 repo_upstream_default 变量，移除仓库定义中的 pg13 一行即可。

此外，EL8 仍然在 Pigsty 的兼容操作系统中，但从此版本开始将不再发布 el8 的离线软件包。

本版本没有其他破坏性 API 或配置变更。

7 个提交，84 文件变更，+4,925 / -5,351 行（v4.2.0..v4.2.1，2026-03-04 ~ 2026-03-06）

PostgreSQL 软件包更新

基础设施软件包更新

校验和

262b7671424a38b208872582fe835ef8  pigsty-v4.2.1.tgz
62edcca1d1e572a247be018e1c26eda8  pigsty-pkg-v4.2.1.d12.aarch64.tgz
1d55367e2fd9106e6f18b7ee112be736  pigsty-pkg-v4.2.1.d12.x86_64.tgz
f122b1e5ba8a7ae8e3dc6e6dd53eba65  pigsty-pkg-v4.2.1.d13.aarch64.tgz
617a76bfc8df8766e78abf24339152eb  pigsty-pkg-v4.2.1.d13.x86_64.tgz
908509b350403ad1a4a27a88795fee06  pigsty-pkg-v4.2.1.el10.aarch64.tgz
70cb4afd90ed7aea6ab43a264f8eb4a8  pigsty-pkg-v4.2.1.el10.x86_64.tgz
98fbd67334f5c674b12e6af81ef76923  pigsty-pkg-v4.2.1.el9.aarch64.tgz
687fa741ccd9dcf611a2aa964bcf1de8  pigsty-pkg-v4.2.1.el9.x86_64.tgz
a2a30f4b1146b3e79be91d5be57615b6  pigsty-pkg-v4.2.1.u22.aarch64.tgz
7a1f571bd8526106775c175ba728eee1  pigsty-pkg-v4.2.1.u22.x86_64.tgz
a5574071bac1955798265f71ad73c3d4  pigsty-pkg-v4.2.1.u24.aarch64.tgz
59a7632c650a3c034f1fe6cd589d7ab5  pigsty-pkg-v4.2.1.u24.x86_64.tgz

v4.2.0

亮点特性

• 离线小版本跟进 PostgreSQL 紧急小版本：18.3、17.9、16.13、15.17、14.22。
• PostgreSQL 扩展总数达到 461 个。
• PG 内核更新：Babelfish、AgensGraph、pgEdge、OriolePG、OpenHalo、Cloudberry。
• Babelfish 模板切换到 Pigsty 自建维护的 PG17 兼容版本，移除对 WiltonDB 仓库的依赖。
• 更新 Supabase 镜像与自建模板至最新版本，使用自行维护的 MinIO 分支 pgsty/minio

主要变更

• mssql 模板切换到 Babelfish PG17 默认：pg_version: 17，pg_packages: [babelfish, pgsql-common, sqlcmd]，并移除额外 mssql repo 依赖。
• pg_home_map 调整：mssql 指向 /usr/babelfish-$v/，gpsql 指向 /usr/local/cloudberry，统一内核路径语义。
• package_map 新增 cloudberry 独立映射，并修复 babelfish* 组件别名到版本化包名（RPM/DEB）。
• Redis 默认主目录从 /data 调整为 /data/redis；部署阶段阻止旧默认值继续使用，redis_remove 增加旧路径兼容清理。
• configure 支持 -o 绝对路径输出并自动建目录；区域探测改为三态（境内/境外/离线回退），修复 behind_gfw() 卡住问题。
• 修复 Debian/Ubuntu 默认仓库 URL（updates/backports/security 对应关系）与中国区镜像组件字段，避免节点初始化拉包失败。
• Supabase 应用栈例行升级（含 PostgREST 14.5、Vector 0.53.0 等）并补齐 S3 协议访问密钥变量。
• Rich/Sample 模板显式补全 dbuser_meta 默认值；node.sh 中 systemd 自动补全逻辑简化。
• pgbackrest 初始化增加重试（2 次、间隔 5 秒），缓解 stanza-create 与 archive-push 锁竞争失败。
• Vibe 模板更新：内置 @anthropic-ai/claude-code、@openai/codex、happy-coder 等 npm 工具，默认示例补入 age 扩展。

PG 软件更新

• PostgreSQL 18.3, 17.9, 16.13, 15.17, 14.22
• RPM Changelog 2026-02-27
• DEB Changelog 2026-02-27
• 核心升级：timescaledb 2.25.0 -> 2.25.1，citus 14.0.0-3 -> 14.0.0-4，pg_search -> 0.21.9
• 新增/重建：pgedge 17.9，spock 5.0.5，lolor 1.2.2，snowflake 2.4，babelfish 5.5.0，cloudberry 2.0.0
• 内核配套：oriolepg 17.11 -> 17.16，orioledb beta12 -> beta14，openhalo 14.10 -> 1.0(14.18)

基础设施软件更新

API变化

• pg_mode 增加 agens 与 pgedge。
• mssql 默认配置改为 pg_version: 17 + pg_packages: [babelfish, pgsql-common, sqlcmd]。
• pg_home_map 与 package_map 的内核/包别名映射更新（Babelfish / OpenHalo / IvorySQL / Cloudberry / pgEdge 家族）。
• redis_fs_main 默认值改为 /data/redis，并新增部署保护与移除兼容策略。
• configure 输出路径与区域探测逻辑更新，增加离线回退告警；SSH 探测统一超时参数。
• grafana.ini.j2 跟进 Grafana 12.4 新配置项与废弃项调整。

兼容性说明

• 存量 Redis 配置如果仍使用 redis_fs_main: /data，请先改为 /data/redis 再执行部署。
• Grafana 12.4 后 data link 合并行为变化，本版本已将关键链接下沉到字段 override 规避冲突；如有自定义看板，建议同步检查。

26 个提交，122 文件变更，+2,116 / -2,215 行（v4.1.0..v4.2.0，2026-02-15 ~ 2026-02-28）

校验和

24a90427a7e7351ca1a43a7d53289970  pigsty-v4.2.0.tgz
d980edf5eeb0419d4f1aa7feb0100e14  pigsty-pkg-v4.2.0.d12.aarch64.tgz
24bc237d841457fbdcc899e1d0a3f87e  pigsty-pkg-v4.2.0.d12.x86_64.tgz
e395b38685e2ecbe9c3a2850876d9b7b  pigsty-pkg-v4.2.0.d13.aarch64.tgz
c5c8776f9bead9f29528b26058801f83  pigsty-pkg-v4.2.0.d13.x86_64.tgz
28ea40434bd06135fc8adc0df1c8407d  pigsty-pkg-v4.2.0.el10.aarch64.tgz
58ad715ac20dc1717d1687daecfcf625  pigsty-pkg-v4.2.0.el10.x86_64.tgz
008f955439ea311581dd0ebcf5b8bd34  pigsty-pkg-v4.2.0.el8.aarch64.tgz
2acfd127a517b09f07540f808fe9547a  pigsty-pkg-v4.2.0.el8.x86_64.tgz
58e62a92f35291a40e3f05839a1b6bc4  pigsty-pkg-v4.2.0.el9.aarch64.tgz
d311bfdf5d5f60df5fe6cb3d4ced4f9c  pigsty-pkg-v4.2.0.el9.x86_64.tgz
c98972fe9226657ac1faa7b72a22498b  pigsty-pkg-v4.2.0.u22.aarch64.tgz
44a174ee9ba030ac1ea386cf0b85f6e7  pigsty-pkg-v4.2.0.u22.x86_64.tgz
143e404f4681c7d0bbd78ef7982cd652  pigsty-pkg-v4.2.0.u24.aarch64.tgz
00dfa86f477f3adff984906211ab3190  pigsty-pkg-v4.2.0.u24.x86_64.tgz

v4.1.0

curl https://pigsty.cc/get | bash -s v4.1.0

72 个提交，252 文件变更，+5,744 / -5,015 行（v4.0.0..v4.1.0，2026-02-02 ~ 2026-02-13）

亮点特性

• 新增 7 个扩展，总计 451 个扩展支持。
• pig 从传统脚本接口升级为 Agent-Native CLI（1.0.0 -> 1.1.0），支持主动暴露上下文并提供 JSON/YAML 输出。
• pig 新增 PostgreSQL / OS 大小版本更新统一能力（覆盖 major/minor 升级流程）。
• pg_exporter 升级到 v1.2.0（1.1.2 -> 1.2.0），并修复 PG17/18 指标链路与单位换算。
• 防火墙默认安全策略更新：node_firewall_mode 默认改为 zone，node_firewall_public_port 默认从 [22,80,443,5432] 收敛为 [22,80,443]。
• PostgreSQL 小版本更新：18.2、17.8、16.12、15.16、14.21。
• EL 默认小版本更新到 EL 9.7 / EL 10.1，Debian 默认小版本更新到 12.13 / 13.3。
• 集中修复 PGSQL / PGCAT Grafana 看板可用性：$dsn 动态数据源、schema 级跳转、Age 指标、链接映射与语义一致性。
• 新增 Mattermost 一键应用模板，支持数据库、目录、门户与可选 PGFS/JuiceFS 方案。
• 重构 infra-rm 卸载逻辑，新增 deregister 分段清理能力，可回收 Victoria target、Grafana datasource、Vector 日志配置。
• 优化 PostgreSQL 默认 autovacuum 阈值，减少小表高频 vacuum/analyze。
• 修复 FD 上限链路：新增 fs.nr_open=8M 并统一 LimitNOFILE=8M，避免 systemd/setrlimit 导致服务启动失败。
• 调整 Vibe 默认体验：Jupyter 默认关闭，Claude Code 改由 npm 包统一安装管理。

版本更新

• Pigsty 版本：v4.0.0 -> v4.1.0
• pig CLI：1.0.0 -> 1.1.0（Agent-Native + 大小版本更新支持）
• pg_exporter：1.1.2 -> 1.2.0
• 默认 EL 小版本：9.6/10.0 -> 9.7/10.1
• 默认 Debian 小版本：12.12/13.1 -> 12.13/13.3

扩展更新

• RPM Changelog 2026-02-12
• DEB Changelog 2026-02-12
• timescaledb 2.24.0 -> 2.25.0
• pg_search 0.21.4 -> 0.21.7
• pgmq 1.9.0 -> 1.10.0
• pg_textsearch 0.4.0 -> 0.5.0
• pljs 1.0.4 -> 1.0.5
• pg_track_optimizer 0.9.1（新增）
• nominatim_fdw 1.1.0（新增）
• pg_utl_smtp 1.0.0（新增）
• pg_strict 1.0.2（新增）
• pgmb 1.0.0（新增）
• pg_pwhash（新增支持）
• informix_fdw（新增支持）

INFRA 组件版本

Infra Changelog 2026-02-12

API变化

• io_method / io_workers 模板生效条件从 pg_version >= 17 更正为 pg_version >= 18。
• idle_replication_slot_timeout / initdb --no-data-checksums 的 PG18 守卫条件修正。
• maintenance_io_concurrency 生效范围放宽至 PG13+。
• autovacuum_vacuum_threshold：oltp/crit/tiny 从 50 提升到 500，olap 提升到 1000。
• autovacuum_analyze_threshold：oltp/crit/tiny 从 50 提升到 250，olap 提升到 500。
• checkpoint_completion_target 默认从 0.90 提升到 0.95。
• Node tuned 模板新增 fs.nr_open=8388608，并统一 fs.file-max / fs.nr_open / LimitNOFILE 层级关系。
• postgres、patroni、minio 的 systemd LimitNOFILE 从 16777216 调整为 8388608。
• node_sysctl_params 默认加入 fs.nr_open: 8388608。
• node_firewall_mode 默认值从 none 调整为 zone：默认启用防火墙，内网信任，公网仅开放 node_firewall_public_port；如需完全自管防火墙请设为 none。
• node_firewall_public_port 默认值从 [22,80,443,5432] 调整为 [22,80,443]，数据库端口 5432 需要按需显式添加。注意防火墙规则为“只增不删”，存量节点若已放行 5432 需手工移除；单机体验模板（如 meta / vibe）会显式覆盖并保留 5432 以便远程使用。
• bin/validate 新增 pg_databases[*].parameters 与 pg_hba_rules[*].order 校验支持，并修复 HBA 错误未正确返回失败的问题。
• infra-rm.yml 新增 deregister、config、env 等分段标签。
• Vibe 默认 jupyter_enabled=false，npm_packages 默认加入 @anthropic-ai/claude-code、happy-coder，并新增 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。
• PgBouncer 参数别名收敛：pool_size_reserve -> pool_reserve，pool_max_db_conn -> pool_connlimit。

兼容性修复（去重归并）

• 注：同一问题的重复回补（反复引入后再次修复）仅计一次，以下按问题域归并。
• 修复 Redis replicaof 判空逻辑与 systemd 停止行为。
• 修复 pg_migration 脚本 schema/table/sequence 全限定、标识符 quoting 与日志格式字符串安全问题。
• 修复 pgsql role handler 重启对象与变量使用错误。
• 修复 blackbox 配置文件名清理项与 pgAdmin pgpass 文件格式。
• pg_exporter 启动改为非阻断，避免 exporter 启动失败拖慢主流程。
• VIP 地址解析逻辑简化，未显式 CIDR 时默认掩码 24。
• MinIO 健康检查重试从 3 提升到 5。
• 节点主机名设置改用 hostname 模块，替代 shell 调用。
• 修复 app/electric 与 app/pg_exporter 的 .env 格式为标准 KEY=VALUE。
• 修复 pigsty.yml 的 pg_crontab 语法错误。
• 更新 ETCD 文档，明确默认 TLS 与可选 mTLS 的语义差异。
• 修复 repo-add 参数传递、Debian 中国镜像组件兼容性、bin/psql.py 的 Python3 兼容性。
• 加固 redis exporter 凭据文件权限，减少敏感信息暴露风险。
• pgsql-user.yml 隐藏用户凭据日志输出并对敏感步骤启用 no_log。
• 修复 pg_monitor 注册 Victoria target 的 gate 条件。
• pg_remove 备份清理改为集群级目录，避免误删其他集群备份。

提交清单（v4.0.0..v4.1.0，共 72，2026-02-02 ~ 2026-02-13）

7410de401 v4.1.0 release
fa31213ce conf(node): default firewall to zone with single-node 5432 override
bb8382c58 update default extension list to 451
770d01959 hide user credential in pgsql-user playbook
7219a896c pg_monitor: fix victoria registration gate conditions
084c98432 remove one cluster in backup dir during pg_remove
7005617f1 pgsql: drop legacy pgbouncer pool parameter aliases
f8165a886 docs(roles): fix typos and align juice role documentation
06a589218 chore(meta): normalize platform versions for current lint schema
e0a208248 fix(roles): harden redis exporter file permissions
fd0469881 terraform/vagrant: parameterize aliyun region/zone, fix vagrant scripts
74c59aabe grafana: fix dashboard links, descriptions, and overrides
443e58724 conf: clean legacy params and fix template references
536c4b39d adjust grafana dashboard dead links
f3b9866ce grafana(pgsql): fix panel typos and title consistency
bcb69be11 grafana(pgsql): fix drilldown links and variable mappings
1ce4374a1 grafana: fill pglog panel titles and normalize wording
2d127f9f4 grafana: fix minio traffic metrics and pigsty dashboard links
9d3ca0118 grafana: align victoria instance dashboards with query scope
55bc61622 grafana: fix infra dashboard copy, links, and table semantics
607b75535 grafana(node): fix panel drilldown links and clean dashboard metadata
1321de532 grafana(redis): fix dashboard links and blocked-clients panel semantics
91e0c8437 fix(grafana): correct Redis alert drill-down dashboard links
0fde78c02 fix(tooling): improve Python3 compatibility and enforce vagrant scale lower bound
fa3454a52 fix(bootstrap): use Debian-compatible components for CN apt mirror
36c95c749 fix(cli): restore repo-add execution and HBA validation failure propagation
797385929 add macbook local vagrant image override
f9c928e32 fix(grafana): restore reverted dashboard bugfixes
c11af8b6a Bump version to v4.1.0
307a236ba update extension list
f17024807 override el9/u24 vagrant box for convient testing
c2ada1283 terraform: bump Aliyun Debian images to 12.13/13.3
25bd8210f fix(node): add daemon_reload to systemd tasks for keepalived, chronyd, and cron
6f2576fd0 fix(node): set default fs.nr_open via node_sysctl_params
43a71245e add pg_bgwriter_buffers_backend for pg 17-
da832a47b fix(monitor): keep checkpointer metrics for checkpoint stats
90434ca8a fix(monitor): add pg_bgwriter fallback for checkpointer metrics
e2d75e787 fix(monitor): use pg_checkpointer metrics for checkpoint stats
a0b7474f8 fix grafana dashboard metrics and lengend
27ddacbc6 vagrant: refresh box selector and OS shortcuts
26e108788 fix(monitor): correct unit for time metrics scaled by pg_exporter
ee90044b5 fix(pgsql): correct min_parallel scan size params in oltp/crit templates
d439464b2 pgsql: fix pg_version guards for PG18-only settings
26320f120 docs: recommend RockyLinux 10.1
1e9b9f33a terraform: bump Aliyun Rocky images to 9.7/10.1
d6e9c7122 monitor: optimize table/index bloat estimators
42d45d32e fix(grafana): align panel semantics across node/infra/redis
3972d2c45 fix(grafana/pgsql): align dashboard semantics for query monitoring
cb52375ac bump checkpoint_completion_target from 0.90 to 0.95
13115a95d fix legend in pgsql-persist checkpoint panel
102cd2edb fix(pg_migration): make template logging format-safe
c402f0e6d fix: correct io_method/io_workers version guard from PG17 to PG18
3bf676546 vibe: disable jupyter by default and install claude-code via npm_packages
613c4efa9 fix: set fs.nr_open in tuned profiles and reduce LimitNOFILE to 8M
07e499d4d new app conf template matter most
4cc68ed61 Refine infra removal playbook
7cfb98f69 fix: app docker .env file format
9b36b1875 Fix config templates and validation
318d85e6e Simplify VIP parsing and make pg_exporter non-blocking
571cd9e70 Use hostname module for nodename
de98f073c Fix blackbox config filename and pgpass format
4bff01100 Fix redis replicaof guard and systemd stop
38445b68d minio: increase health check retries
c99854969 docs(etcd): clarify TLS vs mTLS
41229124a fix pgsql roles typo
e575d17c6 fix pg_migration scripts to use fully qualified identifiers
ec4207202 fix pgsql-schema broken links
a237e6c99 tune autovacuum threshold to reduce small table vacuum frequency
e80754760 fix pgcat-database links to pgcat-table https://github.com/pgsty/pigsty/issues/690
0060f5346 fix pgsql-database / pgsql-databases age metric fix https://github.com/pgsty/pigsty/issues/695
43cdf72bc fix pigsty.yml typo
0d9db7b08 fix: update datasource to $dsn - fix https://github.com/pgsty/pigsty/issues/692#issuecomment-3835461620

致谢

• 感谢 @l2dy 为本项目提出诸多改进意见与 Issue。

校验和

8bc75e8df0e3830931f2ddab71b89630  pigsty-v4.1.0.tgz
da10de99d819421630f430d01bc9de62  pigsty-pkg-v4.1.0.d12.aarch64.tgz
e1f2ed2da0d6b8c360f9fa2faaa7e175  pigsty-pkg-v4.1.0.d12.x86_64.tgz
382bb38a81c138b1b3e7c194211c2138  pigsty-pkg-v4.1.0.d13.aarch64.tgz
13ceaa728901cc4202687f03d25f1479  pigsty-pkg-v4.1.0.d13.x86_64.tgz
92d061de4d495d05d42f91e4283e7502  pigsty-pkg-v4.1.0.el10.aarch64.tgz
be629ea91adf86bbd7e1c59b659d0069  pigsty-pkg-v4.1.0.el10.x86_64.tgz
c14be706119ba33dd06c71dda6c02298  pigsty-pkg-v4.1.0.el8.aarch64.tgz
0c8b6952ffc00e3b169896129ea39184  pigsty-pkg-v4.1.0.el8.x86_64.tgz
cfcc63b9ecc525165674f58f9365aa19  pigsty-pkg-v4.1.0.el9.aarch64.tgz
34f733080bfa9c8515d1573c35f3e870  pigsty-pkg-v4.1.0.el9.x86_64.tgz
ad52ce9bf25e4d834e55873b3f9ada51  pigsty-pkg-v4.1.0.u22.aarch64.tgz
300b2185c61a03ea7733248e526f3342  pigsty-pkg-v4.1.0.u22.x86_64.tgz
2e561e6ae9abb14796872059d2f694a8  pigsty-pkg-v4.1.0.u24.aarch64.tgz
c462bb4cb2359e771ffcad006888fbd4  pigsty-pkg-v4.1.0.u24.x86_64.tgz

v4.0.0

curl https://pigsty.cc/get | bash -s v4.0.0

318 个提交，604 文件变更，+118,655 / -327,552 行，发布页面: https://github.com/pgsty/pigsty/releases/tag/v4.0.0

亮点特性

• 可观测性革命: Prometheus → VictoriaMetrics（10x 性能提升），Loki + Promtail → VictoriaLogs + Vector
• 安全加固: 自动生成强密码、etcd RBAC、防火墙/SELinux 模式、权限收紧、Nginx Basic Auth
• 容器支持：支持在 Docker 容器中运行 Pigsty 本身
• 新增模块：JUICE，提供将 PG 挂载为文件系统并进行 PITR 的能力
• 新增模块：VIBE，提供 Claude Code、JupyterLab、VS Code Server、Node.js 的配置与可观测性
• 数据库管理: pg_databases state（create/absent/recreate）、strategy 瞬间克隆数据库
• PITR 与分叉: /pg/bin/pg-fork CoW 瞬间克隆、pg-pitr 增强支持 PITR 前备份
• 高可用增强: pg_rto_plan 提供四档 RTO 预置参数（fast/norm/safe/wide），pg_crontab 定时任务
• 多云 Terraform: AWS、Azure、GCP、Hetzner、DigitalOcean、Linode、Vultr、腾讯云模板
• 许可证变更: AGPL-3.0 → Apache-2.0

基础设施软件包更新

MinIO 开始使用 pgsty/minio fork RPM/DEB

新增模块

• JUICE 模块：JuiceFS 分布式文件系统，使用 PostgreSQL 作为元数据引擎，支持利用 PITR 恢复文件系统
• VIBE 模块：AI 辅助编程沙箱环境（整合了 Code-Server、JupyterLab、Node.js 与 Claude Code）
  • Code-Server：浏览器中的 VS Code
  • JupyterLab：交互式计算环境
  • Node.js：JavaScript 运行时环境
  • Claude Code：AI 编程助手 CLI 配置，内置 OpenTelemetry 可观测性

PostgreSQL 扩展

新扩展: pg_textsearch 0.4.0, pg_clickhouse 0.1.3, pg_ai_query 0.1.1, etcd_fdw, pg_ttl_index 0.1.0, pljs 1.0.4, pg_retry 1.0.0, pg_weighted_statistics 1.0.0, pg_enigma 0.5.0, pglinter 1.0.1, documentdb_extended_rum 0.109, mobilitydb_datagen 1.3.0

重要更新: timescaledb 2.24.0, pg_search 0.21.4, citus 14.0.0, documentdb 0.109, age 1.7.0, pg_duckdb 1.1.1, vchord 1.0.0, vchord_bm25 0.3.0, pg_biscuit 2.2.2, pg_anon 2.5.1, wrappers 0.5.7, pg_vectorize 0.26.0, pg_session_jwt 0.4.0, pg_partman 5.4.0, pgmq 1.9.0, pg_bulkload 3.1.23, pg_timeseries 0.2.0, pg_convert 0.1.0, pgBackRest 2.58

破坏性变更

可观测性栈

参数变更

默认值变更

可观测性

• 使用全新的 VictoriaMetrics 替代 Prometheus，用几分之一的资源实现数倍的性能
• 使用全新的日志收集方案：VictoriaLogs + Vector，取代 Promtail + Loki
• 统一调整了所有组件的日志格式，PG 日志使用 UTC 时间戳（log_timezone）
• 调整了 PostgreSQL 日志的轮换方式，使用按周循环截断日志轮转模式
• 在 PG 日志中记录超过 1MB 的临时文件分配，在特定模版中启用 PG 17/18 日志新参数
• 新增了 Nginx / Syslog / PG CSV / Pgbackrest / Grafana / Redis / etcd / MinIO 等日志的 Vector 解析配置
• 注册数据源现在会在所有 Infra 节点上进行，Victoria 数据源将自动注册入 Grafana
• 新增 grafana_pgurl 参数，允许指定 Grafana 使用 PG 作为后端存储元数据库
• 新增 grafana_view_password 参数，指定 Grafana Meta 数据源使用的密码
• pgbackrest_exporter 的默认选项现在设置 120 秒的内部缓存间隔（原本为 600s）
• grafana_clean 参数的默认值现在由 true 改为 false，即默认不清除
• 新增指标收集器 pg_timeline，收集更实时的时间线指标 pg_timeline_id
• pg_exporter 更新至 1.1.2，新增 pg_timeline 采集器，修复大量历史遗留问题
• 新增 node-vector 仪表盘，监控 Vector 日志收集器状态
• 新增 node-juice 仪表盘，监控 JuiceFS 分布式文件系统状态
• 新增 claude-code 仪表盘，监控 Claude Code AI 编程助手使用情况
• PGSQL Cluster/Instance 仪表盘新增版本横幅显示
• 所有仪表盘使用 compact JSON 格式，大幅减少文件体积

接口改进

• install.yml 剧本现在重命名为 deploy.yml 以更符合语义
• 新增 vibe.yml 剧本，用于部署 VIBE AI 编程沙箱环境
• pg_databases 数据库制备功能改进
  • 添加删库能力：可以使用 state 字段指定 create, absent, recreate 三种状态
  • 添加克隆能力：数据库定义中使用 strategy 参数指定克隆方法
  • 支持较新版本引入的 locale 配置参数：locale_provider，icu_locale，icu_rules，builtin_locale
  • 支持 is_template 参数，将数据库标记为模板数据库
  • 添加了更多类型检查，避免了字符类参数的注入
  • 允许在 extension 中指定 state: absent 以删除扩展
• pg_users 用户制备功能改进，新增参数 admin，类似 roles，但是带有 ADMIN OPTION 权限可以转授
• pg_hba 支持 order 字段，允许指定 HBA 规则的排序优先级，支持 IPv6 的 localhost 访问
• 新增 infra_extra_services 参数用于首页额外服务入口导航

参数优化

• pg_io_method 参数：auto, sync, worker, io_uring 四种方式可选，默认 worker
• maintenance_io_concurrency 设置为 100（如果使用 SSD）
• effective_io_concurrency 从 1000 减小为 200
• file_copy_method 参数为 PG18 默认设置为 clone，提供瞬间克隆数据库的能力
• idle_replication_slot_timeout 默认 7d，crit 模板 3d
• log_lock_failures：oltp, crit 模版开启
• track_cost_delay_timing：olap, crit 模版开启
• log_connections：oltp/olap 开启认证日志，crit 开启全部日志
• 新增 pg_rto_plan 参数，整合 Patroni 与 HAProxy 的 RTO 相关配置（fast/norm/safe/wide）
• pg_crontab 参数：为 postgres dbsu 配置定时任务
• 对于 PG17+，如果 pg_checksums 开关关闭，在 Patroni 初始化集群时显式禁用校验和
• Crit 模板启用 Patroni 严格同步模式
• PITR 默认 archive_mode 改为 preserve，确保恢复后保留归档能力
• pg-pitr 支持恢复前自动备份数据
• 修复了 duckdb.allow_community_extensions 总是生效的问题
• 允许通过 node_firewall_intranet 指定 HBA 信任的 “内网网段”
• 现在 pg_hba 与 pgbouncer_hba 支持 IPv6 的 localhost 访问

架构改进

• 在 Infra 节点上，设置固定的 /infra 软连接指向 Infra 数据目录 /data/infra
• 现在 Infra 的数据默认放置于 /data/infra 目录下，这使得在容器中使用更为便利
• 本地软件仓库现在放置于 /data/nginx/pigsty，/www 现在作为软链接指向 /data/nginx 确保兼容
• DNS 解析记录现在放置于 /infra/hosts 目录下，解决了 Ansible SELinux 竞态问题
• 默认首页域名从 h.pigsty 更名为 i.pigsty，新增中文首页支持
• 新增了 /pg/bin/pg-fork 脚本，用于快速创建 CoW 副本数据库实例
• 调整 /pg/bin/pg-pitr 脚本，现在可以用于实例级别的 PITR 恢复，支持恢复前自动备份
• 新增 /pg/bin/pg-drop-role 脚本，用于安全删除用户角色
• 新增 bin/pgsql-ext 脚本，用于安装 PostgreSQL 扩展
• 恢复 pg-vacuum 和 pg-repack 脚本
• 新增剧本 juice.yml：部署 JuiceFS 分布式文件系统实例
• 新增剧本 vibe.yml：部署 VIBE AI 编程沙箱环境（含 Code-Server、JupyterLab、Claude Code）
• 显式安装 cron/cronie 包，确保定时任务功能在最小化安装的系统上可用
• UV Python 包管理器从 infra 模块迁移至 node 模块，新增 node_uv_env 参数指定虚拟环境路径
• pg_remove/pg_pitr 移除 etcd 元数据的任务，现在不再依赖 admin_ip 管理节点，而在 etcd 集群上执行
• 36 节点仿真模板 simu 简化为 20 节点的版本
• 适配上游变化，移除 PGDG sysupdate 仓库，移除 EL 系统上所有 llvmjit 的相关包
• 为 EPEL 10 / PGDG 9/10 仓库使用操作系统完整版本号（major.minor）
• 允许在仓库定义中指定 meta 参数，覆盖 yum 仓库的定义元数据
• 确保 Vagrant libvirt 模板默认带有 128GB 磁盘，以 xfs 挂载于 /data
• 确保 pgbouncer 不再将 0.0.0.0 监听地址修改为 *
• 新增 10 节点、Citus 等 Vagrant 配置模板
• 恢复 EL7 系统兼容性支持
• 多云 Terraform 模板：AWS、Azure、GCP、Hetzner、DigitalOcean、Linode、Vultr、腾讯云

安全改进

• configure 现在支持 -g 参数自动生成随机强密码，避免使用默认密码带来的安全隐患
• 更改了 MinIO 模块的默认密码，避免与众所周知的默认密码冲突
• 移除 node_disable_firewall，新增 node_firewall_mode，支持 off, none, zone 三种模式
• 移除 node_disable_selinux，新增 node_selinux_mode，支持 disabled, permissive, enforcing 三种模式
• 为 HAProxy、Nginx、DNSMasq、Redis 等组件配置了正确的 SELinux 上下文
• 启用了针对 etcd 的 RBAC，每个集群现在只能管理自己的 PostgreSQL 数据库集群
• etcd root 密码现在放置于 /etc/etcd/etcd.pass 文件中，仅对管理员可读
• 将 admin_ip 添加到 Patroni API 允许访问的 IP 列表白名单中
• 总是创建 admin 系统用户组，patronictl 配置收紧为仅限 admin 组用户访问
• 新增 node_admin_sudo 参数，允许指定/调整数据库管理员的 sudo 权限模式（all/nopass）
• 收回了所有非 root 用户对可执行脚本的拥有权限
• 新增 Nginx Basic Auth 支持，可以为 Nginx Server 设置可选的 HTTP Basic Auth
• 修复 ownca 证书有效期问题，确保了 Chrome 可以识别自签名证书
• 新增 vip_auth_pass 参数用于 VRRP 认证
• 修复了若干 ansible copy content 字段为空时报错的问题
• 修复了 pg_pitr 中遗留的一些问题，确保 Patroni 集群恢复时没有竞态条件
• 使用 mode 0700 保护 files/pki/ca 目录

问题修复

• 修复 ownca 证书有效期 Chrome 兼容性问题
• 修复 Vector 0.52 syslog_raw 解析问题
• 修复 pg_pitr 多副本 clonefrom 时序问题
• 修复 Ansible SELinux dnsmasq 竞态条件
• 修复 EL9 aarch64 patroni & llvmjit 问题
• 修复 Debian groupadd 路径问题
• 修复空 sudoers 文件生成问题
• 修复 pgbouncer pid 路径（/run/postgresql）
• 修复 duckdb.allow_community_extensions 始终生效问题
• 因上游问题隐藏 EL8 上的 pg_partman 扩展
• 修复 HAProxy 服务模板变量路径
• 修复 Redis remove 任务变量名
• 移除 MinIO reload handler 无效处理器
• 修正 vmetrics_port 默认值为 8428
• 修复 pg-failover-callback 脚本处理所有 Patroni 回调事件
• 修复 pg-vacuum 事务块处理逻辑
• 添加 PG16+ 并行逻辑复制支持
• 修复 FerretDB 证书配置和服务重启策略
• 修正 Polar Exporter 监控指标类型定义
• 修复代理环境变量未传递问题
• 修复移除模式下 postgres 服务配置
• 更新 Docker 默认数据目录路径
• 修复 EL10 系统上的缓存问题
• 修复 etcd/MinIO 移除时 systemd 服务和 DNS 条目清理

新增参数

兼容性

PostgreSQL: 13, 14, 15, 16, 17, 18

校验和

9f42b8c64180491b59bd03016c26e8ca  pigsty-v4.0.0.tgz
db9797c3c8ae21320b76a442c1135c7b  pigsty-pkg-v4.0.0.d12.aarch64.tgz
1eed26eee42066ca71b9aecbf2ca1237  pigsty-pkg-v4.0.0.d12.x86_64.tgz
03540e41f575d6c3a7c63d1d30276d49  pigsty-pkg-v4.0.0.d13.aarch64.tgz
36a6ee284c0dd6d9f7d823c44280b88f  pigsty-pkg-v4.0.0.d13.x86_64.tgz
f2b6ec49d02916944b74014505d05258  pigsty-pkg-v4.0.0.el10.aarch64.tgz
73f64c349366fe23c022f81fe305d6da  pigsty-pkg-v4.0.0.el10.x86_64.tgz
287f767fbb66a9aaca9f0f22e4f20491  pigsty-pkg-v4.0.0.el8.aarch64.tgz
c0886aab454bd86245f3869ef2ab4451  pigsty-pkg-v4.0.0.el8.x86_64.tgz
094ab31bcf4a3cedbd8091bc0f3ba44c  pigsty-pkg-v4.0.0.el9.aarch64.tgz
235ccba44891b6474a76a81750712544  pigsty-pkg-v4.0.0.el9.x86_64.tgz
f2791c96db4cc17a8a4008fc8d9ad310  pigsty-pkg-v4.0.0.u22.aarch64.tgz
3099c4453eef03b766d68e04b8d5e483  pigsty-pkg-v4.0.0.u22.x86_64.tgz
49a93c2158434f1adf0d9f5bcbbb1ca5  pigsty-pkg-v4.0.0.u24.aarch64.tgz
4acaa5aeb39c6e4e23d781d37318d49b  pigsty-pkg-v4.0.0.u24.x86_64.tgz

v3.7.0

亮点特性

• PostgreSQL 18 深度支持，成为默认 PG 大版本，扩展已就位！
• 新增 EL10 / Debian 13 操作系统支持，总数达 14 个！
• 新增 PostgresQL 扩展数量，总数达到 437 个！
• 支持了 Ansible 2.19 破坏性重构以后的版本！
• Supabase，PolarDB, IvorySQL, Percona 内核更新至最新版本！
• 优化了 PG 默认参数的设置逻辑，更充分利用资源。

版本更新

• PostgreSQL 18.1, 17.7, 16.11, 15.15, 14.20, 13.23
• Patroni 4.1.0
• Pgbouncer 1.25.0
• pg_exporter 1.0.3
• pgbackrest 2.57.0
• Supabase 2025-11
• PolarDB 15.15.5.0
• FerretDB 2.7.0
• DuckDB 1.4.2
• Etcd 3.6.6
• pig 0.7.4

更多软件版本更新信息，请参考：

• INFRA 变更日志
• RPM 变更日志
• DEB 变更日志。

API变化

• 为并行执行的相关参数设置了更合理的优化策略，详见 调参说明
• 在 rich 与 full 模板中，不再默认安装 citus 扩展，因为 citus 尚未支持 PG 18
• PG 参数模板中，新增 duckdb 系列扩展存根。
• 为 min_wal_size, max_wal_size, max_slot_wal_keep_size 设置 200，2000，3000 GB 的封顶上限值。
• 为 temp_file_limit 设置 200 GB 的封顶上限，OLAP 设置为 2 TB。
• 适当增大连接池默认链接数量
• 新增 prometheus_port 参数，且默认值为 9058，避开与 EL10 RHEL Web Console 端口的冲突。
• 修改 alertmanager_port 参数的默认值为 9059，避开与 Kafka SSL 端口的潜在冲突。
• 新增 pg_pkg 的 pg_pre 子任务，在安装 PG 包前移除 el9+ 上导致 LLVM 冲突的 bpftool, python3-perf
• 在 Debian / Ubuntu 的默认仓库定义中新增 llvm 仓库模块
• 修复了 infra-rm.yml 移除软件包的逻辑

兼容性修复

• 修复了 Ubuntu/Debian 信任 CA 时 Warning 返回码错误的问题。
• 修复了 Ansible 2.19 引入的大量兼容性问题，确保在新老版本上正常运行。
• 为 seq 类变量添加了 int 类型转换，确保兼容
• 将大量 with_items 修改为 loop 语法，确保兼容
• 为密钥交换变量添加一层列表嵌套，避免在新版本下针对字符串进行字符迭代。
• 将 range 用例显式转换为 list 后使用
• 修改了 name，port 等标记保留的变量命名
• 将 play_hosts 修改为 ansible_play_hosts
• 为部分字符串类型添加了 string 强制类型转换，避免运行时错误。
• EL10 逻辑适配：
• 修复了 EL10 缺少 ansible-collection-community-crypto 无法生成密钥的问题
• 修复了 EL10 缺少 ansible 逻辑包的问题
• 移除 modulemd_tools flamegraph timescaledb-tool
• 使用 java-21-openjdk 替代 java-17-openjdk
• aarch64 YUM 仓库名称问题
• Debian 13 逻辑适配
• 使用 bind9-dnsutils 替代 dnsutils
• Ubuntu 24 修复
• 临时移除了上游依赖崩溃的 tcpdump 包

校验和

e00d0c2ac45e9eff1cc77927f9cd09df  pigsty-v3.7.0.tgz
987529769d85a3a01776caefefa93ecb  pigsty-pkg-v3.7.0.d12.aarch64.tgz
2d8272493784ae35abeac84568950623  pigsty-pkg-v3.7.0.d12.x86_64.tgz
090cc2531dcc25db3302f35cb3076dfa  pigsty-pkg-v3.7.0.d13.x86_64.tgz
ddc54a9c4a585da323c60736b8560f55  pigsty-pkg-v3.7.0.el10.aarch64.tgz
d376e75c490e8f326ea0f0fbb4a8fd9b  pigsty-pkg-v3.7.0.el10.x86_64.tgz
8c2deeba1e1d09ef3d46d77a99494e71  pigsty-pkg-v3.7.0.el8.aarch64.tgz
9795e059bd884b9d1b2208011abe43cd  pigsty-pkg-v3.7.0.el8.x86_64.tgz
08b860155d6764ae817ed25f2fcf9e5b  pigsty-pkg-v3.7.0.el9.aarch64.tgz
1ac430768e488a449d350ce245975baa  pigsty-pkg-v3.7.0.el9.x86_64.tgz
e033aaf23690755848db255904ab3bcd  pigsty-pkg-v3.7.0.u22.aarch64.tgz
cc022ea89181d89d271a9aaabca04165  pigsty-pkg-v3.7.0.u22.x86_64.tgz
0e978598796db3ce96caebd76c76e960  pigsty-pkg-v3.7.0.u24.aarch64.tgz
48223898ace8812cc4ea79cf3178476a  pigsty-pkg-v3.7.0.u24.x86_64.tgz

v3.6.1

curl https://repo.pigsty.cc/get | bash -s v3.6.1

亮点特性

• PostgreSQL 17.6, 16.10, 15.14, 14.19, 13.22, 以及 18 Beta 3 支持
• 在中国大陆地区使用 Pigsty 提供的 PGDG APT/YUM 镜像解决更新断供问题。
• 新的网站首页： https://pgsty.com
• 增加了 el10, debian 13 的实现存根，以及 el10 的 Terraform 镜像

基础设施软件包更新

• Grafana 12.1.0
• pg_exporter 1.0.2
• pig 0.6.1
• vector 0.49.0
• redis_exporter 1.75.0
• mongo_exporter 0.47.0
• victoriametrics 1.123.0
• victorialogs: 1.28.0
• grafana-victoriametrics-ds 0.18.3
• grafana-victorialogs-ds 0.19.3
• grafana-infinity-ds 3.4.1
• etcd 3.6.4
• ferretdb 2.5.0
• tigerbeetle 0.16.54
• genai-toolbox 0.12.0

数据库软件包更新

• pg_search 0.17.3

API变更

• 从 node_kernel_modules 默认值中移除 br_filter 内核模块。
• 在添加 PGDG YUM 源时使用操作大版本号，不再使用小版本号。

校验和

045977aff647acbfa77f0df32d863739  pigsty-pkg-v3.6.1.d12.aarch64.tgz
636b15c2d87830f2353680732e1af9d2  pigsty-pkg-v3.6.1.d12.x86_64.tgz
700a9f6d0db9c686d371bf1c05b54221  pigsty-pkg-v3.6.1.el8.aarch64.tgz
2aff03f911dd7be363ba38a392b71a16  pigsty-pkg-v3.6.1.el8.x86_64.tgz
ce07261b02b02b36a307dab83e460437  pigsty-pkg-v3.6.1.el9.aarch64.tgz
d598d62a47bbba2e811059a53fe3b2b5  pigsty-pkg-v3.6.1.el9.x86_64.tgz
13fd68752e59f5fd2a9217e5bcad0acd  pigsty-pkg-v3.6.1.u22.aarch64.tgz
c25ccfb98840c01eb7a6e18803de55bb  pigsty-pkg-v3.6.1.u22.x86_64.tgz
0d71e58feebe5299df75610607bf428c  pigsty-pkg-v3.6.1.u24.aarch64.tgz
4fbbab1f8465166f494110c5ec448937  pigsty-pkg-v3.6.1.u24.x86_64.tgz
083d8680fa48e9fec3c3fcf481d25d2f  pigsty-v3.6.1.tgz

v3.6.0

curl https://repo.pigsty.cc/get | bash -s v3.6.0

亮点特性

• 全新文档站： https://doc.pgsty.com
• 新增 pgsql-pitr 剧本与备份/恢复教程，改善 PITR 体验，
• 新增内核支持：Percona PG TDE (PG17)
• 优化 Supabase 自建体验，更新至最新版本，并解决了一系列官方模板的问题
• 简化安装步骤，默认使用在线安装，更加高效简单，bootstrap 过程（安装ansible）嵌入安装脚本中

设计改进

• 改善了 Etcd 模块的实现，新增独立的 etcd-rm.yml 剧本与扩缩容 SOP 脚本。
• 改善了 MinIO 模块的实现，支持 HTTP 模式，创建不同属性的三个桶供开箱即用
• 重新调整梳理了所有配置模板，使用更为便利
• 针对中国大陆使用速度更快的 Docker Registry 镜像站
• 优化了 tuned 操作系统参数模板，针对现代硬件与 NVMe 磁盘优化
• 新增扩展 pgactive 用于多主复制与亚秒级故障切换
• 调整 pg_fs_main / pg_fs_backup 默认值，简化文件目录结构设计

问题修复

• 修复了 pgbouncer 配置文件的错误 by @housei-zzy
• 修复了 OrioleDB 在 Debian 平台上的问题
• 修复了 tuned shm 配置参数的问题
• 离线软件包直接使用 PGDG 源，避免使用断开同步的镜像站点
• 修复了 IvorySQL libxcrypt 依赖的问题
• 替换了破损与缓慢的 EPEL 软件仓库站点
• 修复了 haproxy_enabled 标记位的功能

基础设施软件包更新

新增 Victoria Metrics / Victoria Logs 相关包

• genai-toolbox 0.9.0 (new)
• victoriametrics 1.120.0 -> 1.121.0 (重构)
• vmutils 1.121.0 (重命名 victoria-metrics-utils)
• grafana-victoriametrics-ds 0.15.1 -> 0.17.0
• victorialogs 1.24.0 -> 1.25.1 (重构)
• vslogcli 1.24.0 -> 1.25.1
• vlagent 1.25.1 (新增)
• grafana-victorialogs-ds 0.16.3 -> 0.18.1
• prometheus 3.4.1 -> 3.5.0
• grafana 12.0.0 -> 12.0.2
• vector 0.47.0 -> 0.48.0
• grafana-infinity-ds 3.2.1 -> 3.3.0
• keepalived_exporter 1.7.0
• blackbox_exporter 0.26.0 -> 0.27.0
• redis_exporter 1.72.1 -> 1.77.0
• rclone 1.69.3 -> 1.70.3

数据库软件包更新

• PostgreSQL 18 Beta2 更新
• pg_exporter 1.0.1，更新至最新依赖并提供 Docker 镜像
• pig 0.6.0，更新了最新扩展与仓库列表，带有 pig install 子命令
• vip-manager 3.0.0 -> 4.0.0
• ferretdb 2.2.0 -> 2.3.1
• dblab 0.32.0 -> 0.33.0
• duckdb 1.3.1 -> 1.3.2
• etcd 3.6.1 -> 3.6.3
• ferretdb 2.2.0 -> 2.4.0
• juicefs 1.2.3 -> 1.3.0
• tigerbeetle 0.16.41 -> 0.16.50
• pev2 1.15.0 -> 1.16.0

PG扩展包更新

• OrioleDB 1.5 beta12
• OriolePG 17.11
• plv8 3.2.3 -> 3.2.4
• postgresql_anonymizer 2.1.1 -> 2.3.0
• pgvectorscale 0.7.1 -> 0.8.0
• wrappers 0.5.0 -> 0.5.3
• supautils 2.9.1 -> 2.10.0
• citus 13.0.3 -> 13.1.0
• timescaledb 2.20.0 -> 2.21.1
• vchord 0.3.0 -> 0.4.3
• pgactive 2.1.5 (new)
• documentdb 0.103.0 -> 0.105.0
• pg_search 0.17.0

API变更

• pg_fs_backup：重命名为 pg_fs_backup，默认值为 /data/backups。
• pg_rm_bkup：重命名为 pg_rm_backup，默认值为 true。
• pg_fs_main：现在默认值调整为 /data/postgres。
• nginx_cert_validity：新增参数，用于控制 Nginx 自签名证书的有效期，默认为 397d。
• minio_buckets：默认值调整为创建名为 pgsql、meta、data 的三个桶。
• minio_users：移除 dba 用户，新增 s3user_meta 和 s3user_data 用户，分别对应 meta 和 data 桶。
• minio_https：新增参数，允许配置 MinIO 使用 HTTP 模式。
• minio_provision：新增参数，允许跳过 MinIO 置备阶段（跳过桶和用户的创建）。
• minio_safeguard：新增参数，启用后会在执行 minio-rm.yml 时中止操作。
• minio_rm_data：新增参数，控制在执行 minio-rm.yml 时是否删除 minio 数据目录。
• minio_rm_pkg：新增参数，控制在执行 minio-rm.yml 时是否卸载 minio 软件包。
• etcd_learner：新增参数，允许 etcd 以学习者身份初始化。
• etcd_rm_data：新增参数，控制在执行 etcd-rm.yml 时是否删除 etcd 数据目录。
• etcd_rm_pkg：新增参数，控制在执行 etcd-rm.yml 时是否卸载 etcd 软件包。

校验和

df64ac0c2b5aab39dd29698a640daf2e  pigsty-v3.6.0.tgz
cea861e2b4ec7ff5318e1b3c30b470cb  pigsty-pkg-v3.6.0.d12.aarch64.tgz
2f253af87e19550057c0e7fca876d37c  pigsty-pkg-v3.6.0.d12.x86_64.tgz
0158145b9bbf0e4a120b8bfa8b44f857  pigsty-pkg-v3.6.0.el8.aarch64.tgz
07330d687d04d26e7d569c8755426c5a  pigsty-pkg-v3.6.0.el8.x86_64.tgz
311df5a342b39e3288ebb8d14d81e0d1  pigsty-pkg-v3.6.0.el9.aarch64.tgz
92aad54cc1822b06d3e04a870ae14e29  pigsty-pkg-v3.6.0.el9.x86_64.tgz
c4fadf1645c8bbe3e83d5a01497fa9ca  pigsty-pkg-v3.6.0.u22.aarch64.tgz
5477ed6be96f156a43acd740df8a9b9b  pigsty-pkg-v3.6.0.u22.x86_64.tgz
196169afc1be02f93fcc599d42d005ca  pigsty-pkg-v3.6.0.u24.aarch64.tgz
dbe5c1e8a242a62fe6f6e1f6e6b6c281  pigsty-pkg-v3.6.0.u24.x86_64.tgz

v3.5.0

亮点特性

• 支持 PG 18 (Beta)，扩展更新，总数达到 421 个
• OrioleDB 与 OpenHalo 内核在全平台上可用
• 可使用 pig do 子命令代替 bin 脚本
• Supabase 自建加强，解决若干遗留问题，例如复制延迟与密钥分发
• 代码重构与架构优化，优化了 Postgres 与 Pgbouncer 默认参数
• 更新了 Grafana 12, pg_exporter 1.0 与相关插件，翻修面板

curl https://repo.pigsty.cc/get | bash -s v3.5.0

• 支持 PostgreSQL 18
• 通过 pg_exporter 1.0.0 支持 PG18 监控指标
• 通过 pig 0.4.1 支持 PG18 安装 Alias。
• 提供 pg18 配置模板
• 重构 pgsql 模块
• PGSQL 重构，将 PG 监控抽离为单独的 pg_monitor 角色，移除 clean 逻辑
• 去除冗余重复的任务，合并同类项，精简配置。移除 dir/utils 任务块
• 所有扩展默认安装至 extensions 模式中（与 supabase 安全实践保持一致）
• 重命名模板文件，移除所有 .j2 后缀
• 为所有模板中的 monitor 函数添加 SET 命令清空 search_path，遵循 Supabase 安全最佳实践。
• 调整 pgbouncer 默认参数，增大默认链接池大小，设置链接池清理查询。
• 新增参数 pgbouncer_ignore_param ，允许配置 pgbouncer 忽略的参数列表
• 新增任务 pg_key 用于生成 pgsodium 所需的服务端密钥
• 针对 PG 17 默认启用 sync_replication_slots
• 重新调整了子任务标签，使其更符合配置小节的拆分逻辑
• 重构 pg_remove 模块
• 重命名参数：pg_rm_data, pg_rm_bkup, pg_rm_pkg 用于控制删除的内容
• 重新调整角色代码结构，使用更清楚的标签进行划分
• 新增 pg_monitor 模块
• pgbouncer_exporter 现在不再和 pg_exporter 共享配置文件
• 新增了 TimescaleDB， Citus，pg_wait_event 的监控指标。
• 使用 pg_exporter 1.0.0 ，更新了 PG16/17/18 相关监控指标。
• 使用更为紧凑，全新设计的指标收集器配置文件。
• Supabase 加强 (感谢来自 @lawso017 的贡献！)
• 将 Supabase 容器镜像与数据库模式更新至最新版本
• 现在默认支持 pgsodium 服务端密钥加载
• 通过 supa-kick 定时任务解决 logflare 无法及时更新复制进度的问题
• 为 monitor 模式中的函数添加 set search_path 子句以遵循安全最佳实践
• CLI 新增 pig do 命令，允许通过命令行工具替代 bin/ 中的 Shell 脚本
• 监控系统更新
• 更新 Grafana 大版本至 12.0.0，更新相关插件/数据源软件包
• 更新 Postgres 数据源 uid 命名方式（以适应新的 uid 长度限制与字符限制）
• 新增了 Static Datasource
• 更新了现有 Dashboard，修复若干遗留问题

基础设施软件包更新

• pig 0.4.2
• duckdb 1.3.0
• etcd 3.6.0
• vector 0.47.0
• minio 20250422221226
• mcli 20250416181326
• pev 1.5.0
• rclone 1.69.3
• mtail 3.0.8 (new)

可观测性软件包更新

• grafana 12.0.0
• grafana-victorialogs-ds 0.16.3
• grafana-victoriametrics-ds 0.15.1
• grafana-infinity-ds 3.2.1
• grafana_plugins 12.0.0
• prometheus 3.4.0
• pushgateway 1.11.1
• nginx_exporter 1.4.2
• pg_exporter 1.0.0
• pgbackrest_exporter 0.20.0
• redis_exporter 1.72.1
• keepalived_exporter 1.6.2
• victoriametrics 1.117.1
• victoria_logs 1.22.2

数据库软件包更新

• PostgreSQL 17.5, 16.9, 15.13, 14.18, 13.21
• PostgreSQL 18beta1 支持
• pgbouncer 1.24.1
• pgbackrest 2.55
• pgbadger 13.1

Postgres 扩展包更新

• spat 0.1.0a4 新扩展
• pgsentinel 1.1.0 新扩展
• pgdd 0.6.0 (pgrx 0.14.1) 新扩展
• convert 0.0.4 (pgrx 0.14.1) 新扩展
• pg_tokenizer.rs 0.1.0 (pgrx 0.13.1)
• pg_render 0.1.2 (pgrx 0.12.8)
• pgx_ulid 0.2.0 (pgrx 0.12.7)
• pg_idkit 0.3.0 (pgrx 0.14.1)
• pg_ivm 1.11.0
• orioledb 1.4.0 beta11 新增 debian/ubuntu 支持
• openhalo 14.10 新增 debian/ubuntu 支持
• omnigres 20250507 (在 d12/u22 编译最新版本失败)
• citus 12.0.3
• timescaledb 2.20.0 (移除 PG14 支持)
• supautils 2.9.2
• pg_envvar 1.0.1
• pgcollection 1.0.0
• aggs_for_vecs 1.4.0
• pg_tracing 0.1.3
• pgmq 1.5.1
• tzf-pg 0.2.0 (pgrx 0.14.1)
• pg_search 0.15.18 (pgrx 0.14.1)
• anon 2.1.1 (pgrx 0.14.1)
• pg_parquet 0.4.0 (0.14.1)
• pg_cardano 1.0.5 (pgrx 0.12) -> 0.14.1
• pglite_fusion 0.0.5 (pgrx 0.12.8) -> 14.1
• vchord_bm25 0.2.1 (pgrx 0.13.1)
• vchord 0.3.0 (pgrx 0.13.1)
• pg_vectorize 0.22.1 (pgrx 0.13.1)
• wrappers 0.4.6 (pgrx 0.12.9)
• timescaledb-toolkit 1.21.0 (pgrx 0.12.9)
• pgvectorscale 0.7.1 (pgrx 0.12.9)
• pg_session_jwt 0.3.1 (pgrx 0.12.6) -> 0.12.9
• pg_timetable 5.13.0
• ferretdb 2.2.0
• documentdb 0.103.0 (新增 aarch64支持)
• pgml 2.10.0 (pgrx 0.12.9)
• sqlite_fdw 2.5.0 (fix pg17 deb)
• tzf 0.2.2 0.14.1 (rename src)
• pg_vectorize 0.22.2 (pgrx 0.13.1)
• wrappers 0.5.0 (pgrx 0.12.9)

校验和

ab91bc05c54b88c455bf66533c1d8d43  pigsty-v3.6.0.tgz
4c9fabc2d1f0ed733145af2b6aff2f48 pigsty-pkg-v3.5.0.d12.x86_64.tgz
796d47de12673b2eb9882e527c3b6ba0 pigsty-pkg-v3.5.0.el8.x86_64.tgz
a53ef2cede1363f11e9faaaa43718fdc pigsty-pkg-v3.5.0.el9.x86_64.tgz
36da28f97a845fdc0b7bbde2d3812a67 pigsty-pkg-v3.5.0.u22.x86_64.tgz
8551b3e04b38af382163e6857778437d pigsty-pkg-v3.5.0.u24.x86_64.tgz

v3.4.1

GitHub 发布页面：v3.4.1

• 在 EL 系统上增加了对 MySQL 协议兼容 PostgreSQL 内核的支持：openHalo
• 在 EL 系统上增加了对 OLTP 增强 PostgreSQL 内核的支持：orioledb
• 优化了 pgAdmin 9.2 应用模板，具有自动服务器列表更新和 pgpass 密码填充功能
• 将 PG 默认最大连接数增加到 250、500、1000
• 从 EL8 中删除了有依赖错误的 mysql_fdw 扩展

基础设施更新

• pig 0.3.4
• etcd 3.5.21
• restic 0.18.0
• ferretdb 2.1.0
• tigerbeetle 0.16.34
• pg_exporter 0.8.1
• node_exporter 1.9.1
• grafana 11.6.0
• zfs_exporter 3.8.1
• mongodb_exporter 0.44.0
• victoriametrics 1.114.0
• minio 20250403145628
• mcli 20250403170756

扩展更新

• 将 pg_search 升级到 0.15.13
• 将 citus 升级到 13.0.3
• 将 timescaledb 升级到 2.19.1
• 将 pgcollection RPM 升级到 1.0.0
• 将 pg_vectorize RPM 升级到 0.22.1
• 将 pglite_fusion RPM 升级到 0.0.4
• 将 aggs_for_vecs RPM 升级到 1.4.0
• 将 pg_tracing RPM 升级到 0.1.3
• 将 pgmq RPM 升级到 1.5.1

校验和

471c82e5f050510bd3cc04d61f098560  pigsty-v3.4.1.tgz
4ce17cc1b549cf8bd22686646b1c33d2  pigsty-pkg-v3.4.1.d12.aarch64.tgz
c80391c6f93c9f4cad8079698e910972  pigsty-pkg-v3.4.1.d12.x86_64.tgz
811bf89d1087512a4f8801242ca8bed5  pigsty-pkg-v3.4.1.el9.x86_64.tgzz
9fe2e6482b14a3e60863eeae64a78945  pigsty-pkg-v3.4.1.u22.x86_64.tgz

v3.4.0

GitHub 发布页面：v3.4.0

介绍博客：Pigsty v3.4 MySQL 兼容性和全面增强

新功能

• 增加了新的 pgBackRest 备份监控指标和仪表板
• 增强了 Nginx 服务器配置选项，支持自动 Certbot 签发
• 现在优先使用 PostgreSQL 内置的 C/C.UTF-8 区域设置
• IvorySQL 4.4 现在在所有平台上完全支持（RPM/DEB 在 x86/ARM 上）
• 增加了新的软件包：Juicefs、Restic、TimescaleDB EventStreamer
• Apache AGE 图数据库扩展现在在 EL 上完全支持 PostgreSQL 13–17
• 改进了 app.yml playbook：无需额外配置即可启动标准 Docker 应用
• 升级 Supabase、Dify 和 Odoo 应用模板到最新版本
• 增加 electric 应用模板，本地优先的 PostgreSQL 同步引擎

基础设施包

• +restic 0.17.3
• +juicefs 1.2.3
• +timescaledb-event-streamer 0.12.0
• Prometheus 3.2.1
• AlertManager 0.28.1
• blackbox_exporter 0.26.0
• node_exporter 1.9.0
• mysqld_exporter 0.17.2
• kafka_exporter 1.9.0
• redis_exporter 1.69.0
• pgbackrest_exporter 0.19.0-2
• DuckDB 1.2.1
• etcd 3.5.20
• FerretDB 2.0.0
• tigerbeetle 0.16.31
• vector 0.45.0
• VictoriaMetrics 1.113.0
• VictoriaLogs 1.17.0
• rclone 1.69.1
• pev2 1.14.0
• grafana-victorialogs-ds 0.16.0
• grafana-victoriametrics-ds 0.14.0
• grafana-infinity-ds 3.0.0

PostgreSQL 相关

• Patroni 4.0.5
• PolarDB 15.12.3.0-e1e6d85b
• IvorySQL 4.4
• pgbackrest 2.54.2
• pev2 1.14
• Babelfish 13.17

PostgreSQL 扩展

• pgspider_ext 1.3.0（新扩展）
• apache age 13–17 el rpm (1.5.0)
• timescaledb 2.18.2 → 2.19.0
• citus 13.0.1 → 13.0.2
• documentdb 1.101-0 → 1.102-0
• pg_analytics 0.3.4 → 0.3.7
• pg_search 0.15.2 → 0.15.8
• pg_ivm 1.9 → 1.10
• emaj 4.4.0 → 4.6.0
• pgsql_tweaks 0.10.0 → 0.11.0
• pgvectorscale 0.4.0 → 0.6.0 (pgrx 0.12.5)
• pg_session_jwt 0.1.2 → 0.2.0 (pgrx 0.12.6)
• wrappers 0.4.4 → 0.4.5 (pgrx 0.12.9)
• pg_parquet 0.2.0 → 0.3.1 (pgrx 0.13.1)
• vchord 0.2.1 → 0.2.2 (pgrx 0.13.1)
• pg_tle 1.2.0 → 1.5.0
• supautils 2.5.0 → 2.6.0
• sslutils 1.3 → 1.4
• pg_profile 4.7 → 4.8
• pg_snakeoil 1.3 → 1.4
• pg_jsonschema 0.3.2 → 0.3.3
• pg_incremental 1.1.1 → 1.2.0
• pg_stat_monitor 2.1.0 → 2.1.1
• ddl_historization 0.7 → 0.0.7（错误修复）
• pg_sqlog 3.1.7 → 1.6（错误修复）
• pg_random 删除开发后缀（错误修复）
• asn1oid 1.5 → 1.6
• table_log 0.6.1 → 0.6.4

接口变更

• 增加了新的 Docker 参数：docker_data 和 docker_storage_driver（#521 由 @waitingsong 提供）
• 增加了新的基础设施参数：alertmanager_port，让您指定 AlertManager 端口
• 增加了新的基础设施参数：certbot_sign，在 nginx 初始化期间申请证书？（默认为 false）
• 增加了新的基础设施参数：certbot_email，指定通过 Certbot 请求证书时使用的邮箱
• 增加了新的基础设施参数：certbot_options，指定 Certbot 的额外参数
• 更新 IvorySQL，从 IvorySQL 4.4 开始将其默认二进制文件放在 /usr/ivory-4 下
• 将 pg_lc_ctype 和其他区域相关参数的默认值从 en_US.UTF-8 更改为 C
• 对于 PostgreSQL 17，如果使用 UTF8 编码与 C 或 C.UTF-8 区域，PostgreSQL 的内置本地化规则现在优先
• configure 自动检测 PG 版本和环境是否都支持 C.utf8，并相应调整区域相关选项
• 将默认 IvorySQL 二进制路径设置为 /usr/ivory-4
• 更新 pg_packages 的默认值为 pgsql-main patroni pgbouncer pgbackrest pg_exporter pgbadger vip-manager
• 更新 repo_packages 的默认值为 [node-bootstrap, infra-package, infra-addons, node-package1, node-package2, pgsql-utility, extra-modules]
• 从 /etc/profile.d/node.sh 中删除 LANG 和 LC_ALL 环境变量设置
• 现在使用 bento/rockylinux-8 和 bento/rockylinux-9 作为 EL 的 Vagrant box 镜像
• 增加了新别名 extra_modules，包含额外的可选模块
• 更新 PostgreSQL 别名：postgresql、pgsql-main、pgsql-core、pgsql-full
• GitLab 仓库现在包含在可用模块中
• Docker 模块已合并到基础设施模块中
• node.yml playbook 现在包含 node_pip 任务，在每个节点上配置 pip 镜像
• pgsql.yml playbook 现在包含 pgbackrest_exporter 任务，用于收集备份指标
• Makefile 现在允许使用 META/PKG 环境变量
• 增加 /pg/spool 目录作为 pgBackRest 的临时存储
• 默认禁用 pgBackRest 的 link-all 选项
• 默认为 MinIO 仓库启用块级增量备份

错误修复

• 修复 pg-backup 中的退出状态码（#532 由 @waitingsong 提供）
• 在 pg-tune-hugepage 中，限制 PostgreSQL 仅使用大页面（#527 由 @waitingsong 提供）
• 修复 pg-role 任务中的逻辑错误
• 纠正大页面配置参数的类型转换
• 修复 slim 模板中 node_repo_modules 的默认值问题

校验和

768bea3bfc5d492f4c033cb019a81d3a  pigsty-v3.4.0.tgz
7c3d47ef488a9c7961ca6579dc9543d6  pigsty-pkg-v3.4.0.d12.aarch64.tgz
b5d76aefb1e1caa7890b3a37f6a14ea5  pigsty-pkg-v3.4.0.d12.x86_64.tgz
42dacf2f544ca9a02148aeea91f3153a  pigsty-pkg-v3.4.0.el8.aarch64.tgz
d0a694f6cd6a7f2111b0971a60c49ad0  pigsty-pkg-v3.4.0.el8.x86_64.tgz
7caa82254c1b0750e89f78a54bf065f8  pigsty-pkg-v3.4.0.el9.aarch64.tgz
8f817e5fad708b20ee217eb2e12b99cb  pigsty-pkg-v3.4.0.el9.x86_64.tgz
8b2fcaa6ef6fd8d2726f6eafbb488aaf  pigsty-pkg-v3.4.0.u22.aarch64.tgz
83291db7871557566ab6524beb792636  pigsty-pkg-v3.4.0.u22.x86_64.tgz
c927238f0343cde82a4a9ab230ecd2ac  pigsty-pkg-v3.4.0.u24.aarch64.tgz
14cbcb90693ed5de8116648a1f2c3e34  pigsty-pkg-v3.4.0.u24.x86_64.tgz

v3.3.0

• 可用扩展总数增加到 404！
• PostgreSQL 二月小版本更新：17.4、16.8、15.12、14.17、13.20
• 新功能：app.yml 脚本，用于自动安装 Odoo、Supabase、Dify 等应用。
• 新功能：在 infra_portal 中进一步自定义 Nginx 配置。
• 新功能：增加 Certbot 支持，快速申请免费 HTTPS 证书。
• 新功能：pg_default_extensions 现在支持纯文本扩展列表。
• 新功能：默认仓库现在包含 mongo、redis、groonga、haproxy 等。
• 新参数：node_aliases，为节点添加命令别名。
• 修复：解决 Bootstrap 脚本中的默认 EPEL 仓库地址问题。
• 改进：为 Debian Security 仓库添加阿里云镜像。
• 改进：IvorySQL 内核的 pgBackRest 备份支持。
• 改进：PolarDB 的 ARM64 和 Debian/Ubuntu 支持。
• pg_exporter 0.8.0 现在支持 pgbouncer 1.24 中的新指标。
• 新功能：git、docker、systemctl 等常用命令的自动补全 #506 #507 由 @waitingsong 提供。
• 改进：优化 pgbouncer 配置模板中的 ignore_startup_parameters #488 由 @waitingsong 提供。
• 新主页设计：Pigsty 的网站现在拥有全新的外观。
• 扩展目录：RPM/DEB 二进制包的详细信息和下载链接。
• 扩展构建：pig CLI 现在自动设置 PostgreSQL 扩展构建环境。

更多版本信息请参考 GitHub 发布页面。

v3.2.2

• 新增扩展包: Omnigres 33个扩展，将postgres作为应用开发平台
• 新增扩展: pg_mooncake: postgres中的duckdb
• 新增扩展: pg_xxhash
• 新增扩展: timescaledb_toolkit
• 新增扩展: pg_xenophile
• 新增扩展: pg_drop_events
• 新增扩展: pg_incremental
• 升级 citus 至13.0.0，支持PostgreSQL 17
• 升级 pgml 至2.10.0
• 升级 pg_extra_time 至2.0.0
• 升级 pg_vectorize 至0.20.0

变更内容

• 升级IvorySQL至4.2版本(基于PostgreSQL 17.2)
• 为PolarDB内核添加Arm64和Debian支持
• 在默认infra_packages中添加certbot和certbot-nginx
• 增加pgbouncer的max_prepared_statements参数至256
• 移除pgxxx-citus包别名
• 在pg_extensions中默认隐藏pgxxx-olap类别（因为存在两对扩展冲突）

v3.2.1

亮点特性

• PG扩展插件数量提升至350个，新增强力Rust扩展anon。
• IvorySQL支持更新至PG17兼容的4.0版本
• 使用Pigsty编译的Citus，TimescaleDB与PGroonga。
• 添加Odoo一键自建模板与新app.yml剧本

新增 13 扩展插件:

• 新增 pg_anon 2.0.0
• 新增 omnisketch 1.0.2
• 新增 ddsketch 1.0.1
• 新增 pg_duration 1.0.1
• 新增 ddl_historization 0.0.7
• 新增 data_historization 1.1.0
• 新增 schedoc 0.0.1
• 新增 floatfile 1.3.1
• 新增 pg_upless 0.0.3
• 新增 pg_task 1.0.0
• 新增 pg_readme 0.7.0
• 新增 vasco 0.1.0
• 新增 pg_xxhash 0.0.1

更新扩展版本

• lower_quantile 1.0.3
• quantile 1.1.8
• sequential_uuids 1.0.3
• pgmq 1.5.0 (subdir)
• floatvec 1.1.1
• pg_parquet 0.2.0
• wrappers 0.4.4
• pg_later 0.3.0
• topn fix for deb.arm64
• add age 17 on debian
• powa + pg17, 5.0.1
• h3 + pg17
• ogr_fdw + pg17
• age + pg17 1.5 on debian
• pgtap + pg17 1.3.3
• repmgr
• topn + pg17
• pg_partman 5.2.4
• credcheck 3.0
• ogr_fdw 1.1.5
• ddlx 0.29
• postgis 3.5.1
• tdigest 1.4.3
• pg_repack 1.5.2

v3.2.0

亮点特性

• Pigsty 命令行工具：pig 0.2.0，可用于管理扩展插件。
• 提供五大发行版上 390 个扩展 的 ARM64 扩展支持
• Supabase 发布周最新版本更新，全发行版均可自建。
• Grafana 更新至 11.4 ，新增 infinity 数据源。

软件包变化

• 新增扩展

  • 新增 timescaledb, timescaledb-loader timescaledb-toolkit timescaledb-tool to PIGSTY repo
  • 新增 pg_timescaledb，针对 EL 进行的编译重制版本
  • 新增 pgroonga，针对 EL 全系进行编译重制
  • 新增 vchord 0.1.0
  • 新增 pg_bestmatch.rs 0.0.1
  • 新增 pglite_fusion 0.0.3
  • 新增 pgpdf 0.1.0

• 更新扩展

  • pgvectorscale 0.4.0 -> 0.5.1
  • pg_parquet 0.1.0 -> 0.1.1
  • pg_polyline 0.0.1
  • pg_cardano 1.0.2 -> 1.0.3
  • pg_vectorize 0.20.0
  • pg_duckdb 0.1.0 -> 0.2.0
  • pg_search 0.13.0 -> 0.13.1
  • aggs_for_vecs 1.3.1 -> 1.3.2
  • pgoutput 被标记为新的 PostgreSQL Contrib 扩展

• 基础设施

  • 新增 promscale 0.17.0
  • 新增 grafana-plugins 11.4
  • 新增 grafana-infinity-plugins
  • 新增 grafana-victoriametrics-ds
  • 新增 grafana-victorialogs-ds
  • vip-manager 2.8.0 -> 3.0.0
  • vector 0.42.0 -> 0.43.0
  • grafana 11.3 -> 11.4
  • prometheus 3.0.0 -> 3.0.1 (软件包名从 prometheus2 变更为 prometheus)
  • nginx_exporter 1.3.0 -> 1.4.0
  • mongodb_exporter 0.41.2 -> 0.43.0
  • VictoriaMetrics 1.106.1 -> 1.107.0
  • VictoriaLogs 1.0.0 -> 1.3.2
  • pg_timetable 5.9.0 -> 5.10.0
  • tigerbeetle 0.16.13 -> 0.16.17
  • pg_export 0.7.0 -> 0.7.1

• 缺陷修复

  • el8.aarch64 添加 python3-cdiff 修复 patroni 依赖错漏问题
  • el9.aarch64 添加 timescaledb-tools ，修复官方仓库缺失问题
  • el9.aarch64 添加 pg_filedump ，修复官方仓库缺失问题

• 移除扩展

  • pg_mooncake 因为与 pg_duckdb 冲突而被移除。
  • pg_top 因为出现太多版本出现缺失，因质量问题而淘汰。
  • hunspell_pt_pt 因为与 PG 官方字典文件冲突而被淘汰。
  • pg_timeit 因为无法在 AARCH64 架构上使用而被淘汰。
  • pgdd 因为缺乏维护，PG 17 与 pgrx 版本老旧而被标记为弃用。
  • old_snapshot 与 adminpack 被标记为 PG 17 不可用。
  • pgml 被设置为默认不下载不安装。

API变化

• repo_url_packages 参数现在默认值为空数组，因为所有软件包现在都通过操作系统包管理器进行安装。
• grafana_plugin_cache 参数弃用，现在 Grafana 插件通过操作系统包管理器进行安装
• grafana_plugin_list 参数弃用，现在 Grafana 插件通过操作系统包管理器进行安装
• 原名为 prod 的 36 节点仿真模板现在重命名为 simu。
• 原本在 node_id/vars 针对每个发行版代码生成的配置，现在同样针对 aarch64 生成。
• infra_packages 中默认添加命令行管理工具 pig
• configure 命令同样会修改自动生成配置文件中 pgsql-xxx 别名的版本号。
• adminpack 在 PG 17 中被移除，因此从 Pigsty 默认扩展中被移除。

问题修复

• 修复了 pgbouncer 仪表盘选择器问题 #474
• pg-pitr 新增 --arg value 参数解析支持 by @waitingsong
• 修复 Redis 日志信息 typo by @waitingsong

软件包校验和

8fdc6a60820909b0a2464b0e2b90a3a6  pigsty-v3.2.0.tgz
d2b85676235c9b9f2f8a0ad96c5b15fd  pigsty-pkg-v3.2.0.el9.aarch64.tgz
649f79e1d94ec1845931c73f663ae545  pigsty-pkg-v3.2.0.el9.x86_64.tgz
c42da231067f25104b71a065b4a50e68  pigsty-pkg-v3.2.0.d12.aarch64.tgz
ebb818f98f058f932b57d093d310f5c2  pigsty-pkg-v3.2.0.d12.x86_64.tgz
24c0be1d8436f3c64627c12f82665a17  pigsty-pkg-v3.2.0.u22.aarch64.tgz
0b9be0e137661e440cd4f171226d321d  pigsty-pkg-v3.2.0.u22.x86_64.tgz

v3.1.0

亮点特性

• PostgreSQL 17 现已成为默认使用的主要版本 (17.2)
• Ubuntu 24.04 系统支持
• arm 架构支持：EL9, Debian12, Ubuntu 22.04
• Supabase 一键自建，新的剧本 supabase.yml
• MinIO 最佳实践改进，配置模板与 Vagrant 模板
• 提供了一系列开箱即用的配置模板与文档说明。
• 允许在 configure 过程中使用 -v|--version 指定使用的 PG 大版本。
• 调整 PG 默认插件策略：默认安装 pg_repack, wal2json 以及 pgvector 三个关键扩展。
• 大幅简化 repo_packages 本地软件源构建逻辑，允许在 repo_packages 中使用软件包组别名
• 提供了 Babelfish，IvorySQL，PolarDB 的软件源镜像，简化三者的安装。
• 默认启用数据库校验和。
• 修复 ETCD 与 MINIO 日志面板

软件升级

• PostgreSQL 17.2, 16.6, 15.10, 14.15, 13.18, 12.22
• PostgreSQL 扩展版本变动请参考：https://pgext.cloud
• Patroni 4.0.4
• MinIO 20241107 / MCLI 20241117
• Rclone 1.68.2
• Prometheus: 2.54.0 -> 3.0.0
• VictoriaMetrics 1.102.1 -> 1.106.1
• VictoriaLogs v0.28.0 -> 1.0.0
• vslogcli 1.0.0
• MySQL Exporter 0.15.1 -> 0.16.0
• Redis Exporter 1.62.0 -> 1.66.0
• MongoDB Exporter 0.41.2 -> 0.42.0
• Keepalived Exporter 1.3.3 -> 1.4.0
• DuckDB 1.1.2 -> 1.1.3
• etcd 3.5.16 -> 3.5.17
• tigerbeetle 16.8 -> 0.16.13

API变更

• repo_upstream: 针对每个具体的操作系统发行版生成默认值：roles/node_id/vars
• repo_packages: 允许使用 package_map 中定义的别名。
• repo_extra_packages: 新增未指定时的默认值，允许使用 package_map 中定义的别名。
• pg_checksum: 默认值修改为 true，默认打开。
• pg_packages: 默认值修改为：postgresql, wal2json pg_repack pgvector, patroni pgbouncer pgbackrest pg_exporter pgbadger vip-manager
• pg_extensions: 默认值修改为空数组 []。
• infra_portal: 允许为 home 服务器指定 path，替代默认的本地仓库路径 nginx_home (/www)

校验和

e62f9ce9f89a58958609da7b234bf2f2  pigsty-v3.1.0.tgz

v3.0.4

特性

• 针对 PostgreSQL 17 编译了所有支持的 Pigsty 扩展插件
• 提供了全新的 OLAP 扩展支持：pg_duckdb 与 pg_parquet
• 简化并优化了最新版本 Supabase 自建的流程
• 新增参数 docker_image，允许在 Docker 安装后自动拉取镜像。

扩展

欢迎查阅我们最新的 PostgreSQL 扩展目录： https://pgext.cloud

版本升级

• 新的PGSQL扩展

  • pg_parquet
  • pg_explain_ui
  • pg_polyline
  • pg_cardano
  • pg_base58
  • pg_summarize
  • pg_relusage
  • pgmq
  • pg_timeseries
  • pg_plan_filter

• 升级与跟进PG扩展

  • pg_search 0.11.0
  • pg_analytics 0.2.0
  • plv8 3.2.3
  • supautils 2.5.0
  • icu_ext 1.9.0
  • redis_fdw 17
  • pg_failover_slots 1.1.0
  • pg_later 0.1.3
  • plprql 1.0.0
  • pg_vectorize 0.18.3
  • unit 7.7 -> 7.9
  • log_fdw 1.4
  • pg_duckdb 0.1.0
  • pg_graphql 1.5.9 (+17)
  • pg_jsonschema 0.3.2 (+17)
  • pgvectorscale 0.4.0 (+17)
  • wrappers 0.4.3 +pg17
  • pg_ivm 1.9
  • pg_timeseries 0.1.6
  • pgmq 1.4.4
  • pg_protobuf 16 17
  • pg_uuidv7 1.6
  • pg_readonly
  • pgddl 0.28
  • pg_safeupdate
  • pg_stat_monitor 2.1
  • pg_profile 4.7
  • system_stats 3.2
  • pg_auth_mon 3.0
  • login_hook 1.6
  • logerrors 2.1.3
  • pg-orphaned
  • pgnodemx 1.7
  • sslutils 1.4 (deb+pg16,17)
  • timestamp9 (deb)

• 修复不支持PG16/17的扩展

  • pg_mon
  • pg_uri
  • agg_for_vecs
  • quantile
  • lower_quantile
  • pg_protobuf
  • acl
  • pg_emailaddr
  • pg_zstd
  • smlar
  • geohash
  • pgsmcrypto (+17)
  • pg_tiktoken (+17)
  • pg_idkit (+17)

• 基础设施软件包

  • Grafana 11.3
  • duckdb 1.1.2
  • etcd 3.5.16
  • ferretdb 1.24.0
  • minio 20241013133411
  • mcli 2024101313411
  • pushgateway 1.10
  • tigerbeetle 0.16.8
  • mongodb_exporter 0.41.2
  • redis_exporter 1.64.1
  • vector 0.41.1
  • vip-manager 2.7
  • sealos 5.0.1

v3.0.3

特性

• 提供对最新发布的 PostgreSQL 17 支持。
• 优化了 etcd 配置，监控，与告警规则
• （Oracle兼容的）IvorySQL 3.4 支持，与 PostgreSQL 16.4 同步

版本升级

• PostGIS 3.5
• Grafana 11.2
• duckdb 1.1
• pg_search 0.10.2
• pg_analytics 0.1.4

v3.0.2

特性

• 精简安装模式：使用 slim.yml 进行最精简的 HA PGSQL 部署。
• PolarDB PG 15 的原生支持。
• 优化 monitor.pg_table_bloat 与 monitor.pg_index_bloat，使用安全定义包装函数规避 PolarDB 统计视图权限问题。
• 在各模块的监控注册阶段，尊重 prometheus_enabled 与 grafana_enabled 配置选项，关闭时不再注册。
• 在 /etc/profile.d/pgsql.sh 中添加 PGDATABASE 与 PGPORT 环境变量，设置为 pg_primary_db（默认postgres）

变更

• 在 Pigsty PGSQL 仓库中移除 PolarDB 11 与 CloudberryDB 1.5.4 的 RPM/APT 包。
• 使用专用的仓库分发 PolarDB 15 与 CloudberryDB 1.6.0 的 RPM/APT 包。

问题修复

• 修复 Redis 的 /etc/tmp.files.d 文件名错误。
• 在管理 pgbouncer 用户时，设置 PGHOST 与 PGPORT 环境变量。
• 临时移除 pg_snakeoil 扩展支持，因为 EL8 上游源 clamv 出现依赖缺失问题。
• 移除 pgsql 角色的 Notify / Handler，以兼容更老的 Ansible 2.9 版本。

v3.0.1

特性改进

• PolarDB Oracle 兼容性模式支持（需要第三方商业闭源内核）
• 使用 Oracle 兼容的 SQL 语法改写监控视图与相关 SQL 语句
• Patroni 4 支持与适配
• 新增扩展 pg_analytics，通过 duckdb 为 PG 加装分析能力
• 添加新扩展：odbc_fdw 与 jdbc_fdw，提供通用的外部数据源连接能力
• 仓库添加新内核 cloudberrydb (Greenplum 原班开发者的开源分支)
• 仓库添加新工具 walminer，从WAL（replica等级）中提取原始 SQL。（高级特性需自行购买License）
• 更新执行计划可视化工具 Pev2 版本至 1.12.1
• 新增Grafana插件：volkovlabs-rss-datasource
• 在PGCAT databases监控面板中添加了已安装和待安装的扩展插件
• PGSQL 主库初始化后，会重启一次以便 pg_param & pg_files 生效，因此 Supabase PG / PolarDB 集群置备后无需重启。

问题修复

• 修复了 Grafana 11.1.4 面板插件默认不加载的问题
• 修复了特定操作系统上 BlackBox Exporter Ping 探针失效的问题
• 确保 /var/run/postgresql 与 /var/run/redis 临时目录总是在重启后自动创建
• 修复了 cache.yml 剧本没有正确移除老旧的 patroni 3.0.4 RPM 包问题
• 修复了个别告警规则中的描述信息错误
• 移除了 Patroni 配置文件中过时的 Bootstrap User/HBA 参数

v3.0.0

亮点特性

• 扩展大爆炸：

Pigsty v3 提供了史无前例的 333 个可用扩展插件。 包括 121 个扩展 RPM包 与 133 个 DEB包，数量已经超过了 PGDG 官方仓库提供的扩展数量总和（135 RPM/ 109 DEB）。 而且，Pigsty 还将EL系统与Debian生态的独有PG扩展插件相互移植，实现了两大发行版的插件生态大对齐。

- timescaledb periods temporal_tables emaj table_version pg_cron pg_later pg_background pg_timetable
- postgis pgrouting pointcloud pg_h3 q3c ogr_fdw geoip #pg_geohash #mobilitydb
- pgvector pgvectorscale pg_vectorize pg_similarity pg_tiktoken pgml #smlar
- pg_search pg_bigm zhparser hunspell
- hydra pg_lakehouse pg_duckdb duckdb_fdw pg_fkpart pg_partman plproxy #pg_strom citus
- pg_hint_plan age hll rum pg_graphql pg_jsonschema jsquery index_advisor hypopg imgsmlr pg_ivm pgmq pgq #rdkit
- pg_tle plv8 pllua plprql pldebugger plpgsql_check plprofiler plsh #pljava plr pgtap faker dbt2
- prefix semver pgunit md5hash asn1oid roaringbitmap pgfaceting pgsphere pg_country pg_currency pgmp numeral pg_rational pguint ip4r timestamp9 chkpass #pg_uri #pgemailaddr #acl #debversion #pg_rrule
- topn pg_gzip pg_http pg_net pg_html5_email_address pgsql_tweaks pg_extra_time pg_timeit count_distinct extra_window_functions first_last_agg tdigest aggs_for_arrays pg_arraymath pg_idkit pg_uuidv7 permuteseq pg_hashids
- sequential_uuids pg_math pg_random pg_base36 pg_base62 floatvec pg_financial pgjwt pg_hashlib shacrypt cryptint pg_ecdsa pgpcre icu_ext envvar url_encode #pg_zstd #aggs_for_vecs #quantile #lower_quantile #pgqr #pg_protobuf
- pg_repack pg_squeeze pg_dirtyread pgfincore pgdd ddlx pg_prioritize pg_checksums pg_readonly safeupdate pg_permissions pgautofailover pg_catcheck preprepare pgcozy pg_orphaned pg_crash pg_cheat_funcs pg_savior table_log pg_fio #pgpool pgagent
- pg_profile pg_show_plans pg_stat_kcache pg_stat_monitor pg_qualstats pg_store_plans pg_track_settings pg_wait_sampling system_stats pg_meta pgnodemx pg_sqlog bgw_replstatus pgmeminfo toastinfo pagevis powa pg_top #pg_statviz #pgexporter_ext #pg_mon
- passwordcheck supautils pgsodium pg_vault anonymizer pg_tde pgsmcrypto pgaudit pgauditlogtofile pg_auth_mon credcheck pgcryptokey pg_jobmon logerrors login_hook set_user pg_snakeoil pgextwlist pg_auditor noset #sslutils
- wrappers multicorn mysql_fdw tds_fdw sqlite_fdw pgbouncer_fdw mongo_fdw redis_fdw pg_redis_pubsub kafka_fdw hdfs_fdw firebird_fdw aws_s3 log_fdw #oracle_fdw #db2_fdw
- orafce pgtt session_variable pg_statement_rollback pg_dbms_metadata pg_dbms_lock pgmemcache #pg_dbms_job #babelfish
- pglogical pgl_ddl_deploy pg_failover_slots wal2json wal2mongo decoderbufs decoder_raw mimeo pgcopydb pgloader pg_fact_loader pg_bulkload pg_comparator pgimportdoc pgexportdoc #repmgr #slony
- gis-stack rag-stack fdw-stack fts-stack etl-stack feat-stack olap-stack supa-stack stat-stack json-stack

• 可插拔内核：

Pigsty v3 允许您更换 PostgreSQL 内核，目前支持了 SQL Server 兼容的 Babelfish （线缆协议级仿真），Oracle 兼容的 IvorySQL，以及 PG 版的 RAC PolarDB；此外，现在自托管 Supabase 也在 Debian 系统中可用。 您可以让 Pigsty 中带有 HA，IaC，PITR，监控的生产级 PostgreSQL 集群仿真 MSSQL (via Babelfish)，Oracle via (IvorySQL)，Oracle RAC (via PolarDB), MongoDB（via FerretDB），以及 Firebase （via Supabase）。

• 专业级服务：

我们现在提供 Pigsty Pro 专业版，在开源版的功能基础上提供增值服务。专业版提供额外的功能模块：MSSQL，Oracle，Mongo，K8S，Victoria，Kafka，TigerBeetle 等……，并提供更广泛的 PG 大版本、操作系统、芯片架构的支持。 提供针对全系操作系统精准小版本定制的离线安装包，以及 EL7，Debian 11，Ubuntu 20.04 等过保老系统的支持；此外，专业版还提供内核可插拔定制服务，并对PolarDB PG 的原生部署、监控管控支持以满足“国产化”需要。

使用以下命令快速安装体验：

curl -fsSL https://repo.pigsty.cc/get | bash
cd ~/pigsty; ./bootstrap; ./configure; ./install.yml

重大变更

本次 Pigsty 发布调整大版本号，从 2.x 升级到 3.0，带有一些重大变更：

• 首要支持操作系统调整为：EL 8 / EL 9 / Debian 12 / Ubuntu 22.04

  • EL7 / Debian 11 / Ubuntu 20.04 等系统进入弃用阶段，不再提供支持
  • 有在这些系统上运行需求的用户请考虑我们的 订阅服务

• 默认使用在线安装，不再提供离线软件包，从而解决操作系统小版本兼容性问题。

  • bootstrap 过程现在不再询问是否下载离线安装包，但如果 /tmp/pkg.tgz 存在，仍然会自动使用离线安装包。
  • 有离线安装需求请自行制作离线软件包或考虑我们的 订阅服务

• Pigsty 使用的上游软件仓库进行统一调整，地址变更，并对所有软件包进行 GPG 签名与校验

  • 标准仓库： https://repo.pigsty.io/{apt/yum}
  • 国内镜像： https://repo.pigsty.cc/{apt/yum}

• API 参数变更与配置模板变更

  • EL 系与 Debian 系配置模板现在收拢统一，有差异的参数统一放置于 roles/node_id/vars/ 目录进行管理。
  • 配置目录变更，所有配置文件模板统一放置在 conf 目录下，并分为 default, dbms, demo, build 四大类。

其他新特性

• PG OLAP 分析能力史诗级加强：DuckDB 1.0.0，DuckDB FDW，以及 PG Lakehouse，Hydra 移植至 Deb 系统中。
• PG 向量检索与全文检索能力加强：Vectorscale 提供 DiskANN 向量索引，Hunspell 分词字典支持，pg_search 0.8.6。
• 帮助 ParadeDB 解决了软件包构建问题，现在我们在 Debian/Ubuntu 上也能提供这一扩展。
• Supabase 所需的扩展在 Debian/Ubuntu 上全部可用，Supabase 现在可在全OS上自托管。
• 提供了场景化预置扩展堆栈的能力，如果您不知道安装哪些扩展，我们准备了针对特定应用场景的扩展推荐包（Stack）。
• 针对所有 PostgreSQL 生态的扩展，制作了元数据表格、文档、索引、名称映射，针对 EL与Deb 进行对齐，确保扩展可用性。
• 为了解决 DockerHub 被 Ban 的问题，我们加强了 proxy_env 参数的功能并简化其配置方式。
• 建设了一个专用的新软件仓库，提供了 12-17 版本的全部扩展插件，其中，PG16的扩展仓库会在 Pigsty 默认的版本中实装。
• 现有软件仓库升级改造，使用标准的签名与校验机制，确保软件包的完整性与安全性。APT 仓库采用新的标准布局通过 reprepro 构建。
• 提供了 1,2,3,4,43 节点的沙箱环境：meta, dual, trio, full, prod，以及针对 7 大 OS Distro 的快捷配置模板。
• PG Exporter 新增了 PostgreSQL 17 与 pgBouncer 1.23 新监控指标收集器的定义，与使用这些指标的 Grafana Panel
• 监控面板修缮，修复了各种问题，为 PGSQL Pgbouncer 与 PGSQL Patroni 监控面板添加了日志仪表盘。
• 使用全新的 cache.yml Ansible 剧本，替换了原有制作离线软件包的 bin/cache 与 bin/release-pkg 脚本。

API变更

• 新参数选项： pg_mode 现在支持的模式有 pgsql, citus, gpsql, mssql, ivory, polar，用于指定 PostgreSQL 集群的模式
  • pgsql： 标准 PostgreSQL 高可用集群
  • citus： Citus 水平分布式 PostgreSQL 原生高可用集群
  • gpsql： 用于 Greenplum 与 GP 兼容数据库的监控（专业版）
  • mssql： 安装 Babelfish，提供 Microsoft SQL Server 兼容性模式的标准 PostgreSQL 高可用集群，线缆协议级支持，扩展不可用
  • ivory： 安装 IvorySQL 提供的 Oracle 兼容性 PostgreSQL 高可用集群，Oracle语法/数据类型/函数/存储过程兼容，扩展不可用 （专业版）
  • polar： 安装 PolarDB for PostgreSQL （PG RAC）开源版本，提供国产化数据库能力支持，扩展不可用。（专业版）
• 新参数： pg_parameters，用于在实例级别指定 postgresql.auto.conf 中的参数，覆盖集群配置，实现不同实例成员的个性化配置。
• 新参数： pg_files，用于将额外的文件拷贝到PGDATA数据目录，针对需要License文件的商业版PostgreSQL分叉内核设计。
• 新参数： repo_extra_packages，用于额外指定需要下载的软件包，与 repo_packages 共同使用，便于指定OS版本独有的扩展列表。
• 参数重命名： patroni_citus_db 重命名为 pg_primary_db，用于指定集群中的主要数据库（在 Citus 模式中使用）
• 参数强化：proxy_env 中的代理服务器配置会写入 Docker Daemon，解决科学上网问题，configure -x 选项会自动在配置中写入当前环境中的代理服务器配置。
• 参数强化：infra_portal 参数现在支持指定 path 选项，对外暴露本机上的目录，提供web服务。
• 参数强化：repo_url_packages 中的 repo.pigsty.io 会在区域为中国时自动替换为 repo.pigsty.cc，解决科学上网问题，此外，现在可以指定下载后的文件名称。
• 参数强化：pg_databases.extensions 中的 extension 字段现在可以支持字典与扩展名字符串两种模式，字典模式提供 version 支持，允许安装特定版本的扩展。
• 参数强化：repo_upstream 参数如果没有显式覆盖定义，将从 rpm.yml 或 deb.yml 中定义的 repo_upstream_default 提取对应系统的默认值。
• 参数强化：repo_packages 参数如果没有显式覆盖定义，将从 rpm.yml 或 deb.yml 中定义的 repo_packages_default 提取对应系统的默认值。
• 参数强化：infra_packages 参数如果没有显式覆盖定义，将从 rpm.yml 或 deb.yml 中定义的 infra_packages_default 提取对应系统的默认值。
• 参数强化：node_default_packages 参数如果没有显式覆盖定义，将从 rpm.yml 或 deb.yml 中定义的 node_packages_default 提取对应系统的默认值。
• 参数强化：pg_packages 与 pg_extensions 中的扩展现在都会从 rpm.yml 或 deb.yml 中定义的 pg_package_map 执行一次查找与翻译。
• 参数强化：node_packages 与 pg_extensions 参数中指定的软件包在安装时会升级至最新版本， node_packages 中现在默认值变为 [openssh-server]，帮助修复 OpenSSH CVE
• 参数强化：pg_dbsu_uid 会自动根据操作系统类型调整为 26 （EL）或 543 （Debian），避免了手工调整。
• 设置了 pgbouncer 默认参数，max_prepared_statements = 128 启用了事物池化模式下的准备语句支持，并设置 server_lifetime 为 600，
• 修改了 patroni 模板默认参数，统一增大 max_worker_processes +8 可用后端进程，提高 max_wal_senders 与 max_replication_slots 至 50，并增大 OLAP 模板临时文件的大小限制为主磁盘的 1/5

版本升级

截止至发布时刻，Pigsty 主要组件的版本升级如下：

• PostgreSQL 16.4, 15.8, 14.13, 13.16, 12.20
• pg_exporter : 0.7.0
• Patroni: 3.3.2
• pgBouncer: 1.23.1
• pgBackRest: 2.53.1
• duckdb : 1.0.0
• etcd : 3.5.15
• pg_timetable: 5.9.0
• ferretdb: 1.23.1
• vip-manager: 2.6.0
• minio: 20240817012454
• mcli: 20240817113350
• grafana : 11.1.4
• loki : 3.1.1
• promtail : 3.0.0
• prometheus : 2.54.0
• pushgateway : 1.9.0
• alertmanager : 0.27.0
• blackbox_exporter : 0.25.0
• nginx_exporter : 1.3.0
• node_exporter : 1.8.2
• keepalived_exporter : 0.7.0
• pgbackrest_exporter 0.18.0
• mysqld_exporter : 0.15.1
• redis_exporter : v1.62.0
• kafka_exporter : 1.8.0
• mongodb_exporter : 0.40.0
• VictoriaMetrics : 1.102.1
• VictoriaLogs : v0.28.0
• sealos: 5.0.0
• vector : 0.40.0

Pigsty 重新编译了所有 PostgreSQL 扩展插件，PostgreSQL 扩展插件的最新版本，可用的 333 个扩展插件请参考 扩展列表

新应用

Pigsty 现在提供开箱即用的 Dify 与 Odoo 两款使用 PostgreSQL 软件的 Docker Compose 模板：

• Dify： AI智能体工作流编排与 LLMOps，使用 PostgreSQL 作为元数据库，PGVector 作为向量存储。
• Odoo： 企业级开源 ERP 系统，使用 PostgreSQL 作为底层数据库。

Pigsty 专业版现在提供试点的 Kubernetes 部署支持与 Kafka KRaft 集群部署与监控支持

• KUBE： 使用 cri-dockerd 或 containerd 部署由 Pigsty 托管的 Kubernetes 集群
• KAFKA：部署由 Kraft 协议支持的高可用 Kafka 集群

问题修复

• 修复了 Ubuntu / Debian 系统中，节点重启后可能出现的 postgresql-common 服务自动启动替代默认数据库集群的缺陷
• 通过 node_packages 中的默认值 [openssh-server]，CVE-2024-6387 可以在 Pigsty 安装过程中被自动修复。
• 修复了 Loki 解析 Nginx 日志标签基数过大导致的内存消耗问题。
• 修复了 EL8 系统中上游 Ansible 依赖变化导致的 bootstrap 失效问题（python3.11-jmespath 升级至 python3.12-jmespath）

v2.7.0

亮点特性

新增了大量强力扩展插件，特别是一些使用 rust 与 pgrx 进行开发的强力扩展：

• pg_search v0.7.0：使用 BM25 算法对 SQL 表进行全文搜索
• pg_lakehouse v0.7.0：在对象存储（如 S3）和表格式（如 DeltaLake）上进行查询的引擎
• pg_analytics v0.6.1：加速 PostgreSQL 内部的分析查询处理
• pg_graphql v1.5.4：为 PostgreSQL 数据库提供 GraphQL 支持
• pg_jsonschema v0.3.1：提供 JSON Schema 校验的 PostgreSQL 扩展
• wrappers v0.3.1：由 Supabase 提供的 PostgreSQL 外部数据封装器集合
• pgmq v1.5.2：轻量级消息队列，类似于 AWS SQS 和 RSMQ
• pg_tier v0.0.3：支将将冷数据分级存储到 AWS S3
• pg_vectorize v0.15.0: 在 PG 中实现 RAG 向量检索的封装
• pg_later v0.1.0：现在执行 SQL，并在稍后获取结果
• pg_idkit v0.2.3：生成多种流行类型的标识符（UUID）
• plprql v0.1.0：在 PostgreSQL 中使用 PRQL 查询语言
• pgsmcrypto v0.1.0：PostgreSQL 的国密 SM 算法扩展
• pg_tiktoken v0.0.1：计算 OpenAI 使用的 Token 数量
• pgdd v0.5.2：通过纯 SQL 接口，访问数据目录的元数据

当然，也有一些使用原生 C 和 C++ 开发的强力扩展：

• parquet_s3_fdw 1.1.0：从 S3 存取 Parquet 格式文件，作为湖仓之用
• plv8 3.2.2：使用 V8 引擎，允许在 PostgreSQL 中使用 Javascript 语言编写存储过程
• md5hash 1.0.1：用于存储原生MD5哈希数据类型，而非文本。
• pg_tde 1.0 alpha：PostgreSQL 的实验性加密存储引擎。
• pg_dirtyread 2.6：从 PostgreSQL 表中读取未清理的死元组，用于脏读
• 新的 deb PGDG 扩展：pg_roaringbitmap, pgfaceting, mobilitydb, pgsql-http, pg_hint_plan, pg_statviz, pg_rrule
• 新的 rpm PGDG 扩展：pg_profile, pg_show_plans, 使用 PGDG 的 pgsql_http, pgsql_gzip, pg_net, pg_bigm 替代 Pigsty 维护的 RPM。

新特性

• 允许 Pigsty 在特定 Docker 虚拟机镜像中运行。
• 针对 Ubuntu 与 EL 系操作系统发行版准备了 INFRA & PGSQL 模块的 arm64 软件包
• 新安装脚本，可从 cloudflare 下载软件，可以指定版本，提供更完善的提示信息。
• 新增的 PGSQL PITR 监控面板，用于在 PITR 过程中提供更好的可观测性
• 针对在 Docker 虚拟机镜像中运行 Pigsty 进行了一系列铺垫与准备。
• 新增了 防呆设计，避免在非 Pigsty 纳管的节点上运行 pgsql.yml 剧本 （AdamYLK）
• 针对每个支持的发行版大版本配置了独立的配置文件：el7, el8, el9, debian11, debian12, ubuntu20, ubuntu22

软件版本升级

• PostgreSQL 16.3
• Patroni 3.3.0
• pgBackRest 2.51
• VIP-Manager v2.5.0
• Haproxy 2.9.7
• Grafana 10.4.2
• Prometheus 2.51
• Loki & Promtail: 3.0.0 (警告：大版本非兼容性变更！)
• Alertmanager 0.27.0
• BlackBox Exporter 0.25.0
• Node Exporter 1.8.0
• pgBackrest Exporter 0.17.0
• duckdb 0.10.2
• etcd 3.5.13
• minio-20240510014138 / mcli-20240509170424
• pev2 v1.8.0 -> v1.11.0
• pgvector 0.6.1 -> 0.7.0
• pg_tle: v1.3.4 -> v1.4.0
• hydra: v1.1.1 -> v1.1.2
• duckdb_fdw: v1.1.0 重新针对 libduckdb 0.10.2 进行编译
• pg_bm25 0.5.6 -> pg_search 0.7.0
• pg_analytics: 0.5.6 -> 0.6.1
• pg_graphql: 1.5.0 -> 1.5.4
• pg_net 0.8.0 -> 0.9.1
• pg_sparse (deprecated)

Docker应用模板

• Odoo：开源 ERP 软件与插件
• Jupyter：使用容器运行 Jupyter Notebook
• PolarDB：运行“国产数据库” PolarDB，应付信创检查！
• supabase：更新至最近的 GA 版本
• bytebase：使用 latest 标签替代特定版本号。
• pg_exporter：更新了 Docker 镜像的例子。

缺陷修复

• 修复了 pg_exporters 角色中的变量空白问题。
• 修复了 minio_cluster 变量没有在全局配置中注释掉的问题
• 修复了 EL7 模板中的 postgis34 插件名称问题，应该使用 postgis33
• 修复了 EL8 python3.11-cryptography 依赖名的问题，上游现在变更为 python3-cryptography。
• 修复了 /pg/bin/pg-role 无法在非交互式 Shell 模式下获取操作系统用户名的问题
• 修复了 /pg/bin/pg-pitr 无法正确提示 -X -P 选项的问题

API变更

• 新参数 node_write_etc_hosts，用于控制是否向目标节点的 /etc/hosts 文件写入静态 DNS 解析记录
• 新增了 prometheus_sd_dir 参数，用于指定 Prometheus 静态服务发现的目标文件目录
• configure 脚本新增了 -x|--proxy 参数，用于将当前环境的代理信息写入配置文件 by @waitingsong in https://github.com/Vonng/pigsty/pull/405
• 不再使用 Promtail & Loki 解析 Infra 节点上的 Nginx 日志细节标签，因为这样会导致标签基数爆炸。
• 在 Prometheus 配置中使用 alertmanager API v2 替代 v1
• 在 PGSQL 模块中，使用 /pg/cert/ca.crt 代替 /etc/pki/ca.crt，降低对节点根证书的依赖。

新的贡献者

• @NeroSong made their first contribution in https://github.com/Vonng/pigsty/pull/373
• @waitingsong made their first contribution in https://github.com/Vonng/pigsty/pull/405

完整的变更日志: https://github.com/Vonng/pigsty/compar

离线软件包校验和

ec271a1d34b2b1360f78bfa635986c3a  pigsty-pkg-v2.7.0.el8.x86_64.tgz
f3304bfd896b7e3234d81d8ff4b83577  pigsty-pkg-v2.7.0.debian12.x86_64.tgz
5b071c2a651e8d1e68fc02e7e922f2b3  pigsty-pkg-v2.7.0.ubuntu22.x86_64.tgz