跳转到主要内容

Pigsty v4.1.0

大小版本更新支持,Agent-Native CLI,默认防火墙安全策略收紧
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 CLI1.0.0 -> 1.1.0),支持主动暴露上下文并提供 JSON/YAML 输出。
  • pig 新增 PostgreSQL / OS 大小版本更新 统一能力(覆盖 major/minor 升级流程)。
  • pg_exporter 升级到 v1.2.01.1.2 -> 1.2.0),并修复 PG17/18 指标链路与单位换算。
  • 防火墙默认安全策略更新:node_firewall_mode 默认改为 zonenode_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_exporter1.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

软件包 版本 软件包 版本
victoria-metrics 1.135.0 victoria-logs 1.45.0
vector 0.53.0 grafana 12.3.2
alertmanager 0.31.1 etcd 3.6.7
duckdb 1.4.4 pg_exporter 1.2.0
pig 1.1.0 claude 2.1.37
opencode 1.1.59 uv 0.10.0
code-server 4.108.2 caddy 2.10.2
hugo 0.155.2 cloudflared 2026.2.0
headscale 0.28.0

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_thresholdoltp/crit/tiny 从 50 提升到 500,olap 提升到 1000。
  • autovacuum_analyze_thresholdoltp/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 LimitNOFILE16777216 调整为 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[*].parameterspg_hba_rules[*].order 校验支持,并修复 HBA 错误未正确返回失败的问题。
  • infra-rm.yml 新增 deregisterconfigenv 等分段标签。
  • Vibe 默认 jupyter_enabled=falsenpm_packages 默认加入 @anthropic-ai/claude-codehappy-coder,并新增 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
  • PgBouncer 参数别名收敛:pool_size_reserve -> pool_reservepool_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/electricapp/pg_exporter.env 格式为标准 KEY=VALUE
  • 修复 pigsty.ymlpg_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

信息来源