Pigsty 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 解析记录现放置于 dnsmasq 专属的 /etc/dnsmasq.d/pigsty 目录，并保留原子发布，兼容 SELinux 与 AppArmor
• 默认首页域名从 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

信息来源

• GitHub Release
• Pigsty v4.0 发布文章
• 历史 About / 发布注记
• 源码对比：v3.7.0...v4.0.0