Pigsty v4.5：575 扩展、Kafka、MySQL、Valkey 与 Silo

Pigsty v4.5.0 是一次横跨数据服务、PostgreSQL 生态、自动化安全与软件供应链的功能版本：新增 Kafka KRaft 与 MySQL 8.4 试点模块，为 REDIS 模块加入 Valkey 引擎，将 MINIO 模块收敛到 Silo，并把已打包 PostgreSQL 扩展从 531 个推进到 575 个。

本次全量审阅以 v4.4.0（2d5a45f7，2026-07-10）到 main 的 dab5dba3（2026-08-14）为边界，共覆盖 100 个提交、416 个文件、42,058 行新增与 15,984 行删除。完整源码差异见 v4.4.0...dab5dba3。其中相当一部分结构化差异来自 Grafana Dashboard API v2 的整套重导出。

版本亮点

• 575 个 PostgreSQL 扩展：目录新增 46 项、移除 2 项，净增 44；大量 Rust 扩展迁移到 pgrx 0.19.1，RPM/DEB 平台覆盖与包名映射同步刷新。
• Kafka KRaft 模块：新增 Pigsty 原生 Kafka 编排，支持多集群、动态加入与退役、SCRAM-SHA-512/TLS、凭据轮换、健康门禁、监控告警与 4 个 Grafana 仪表盘。
• MySQL 8.4 模块：新增单机与三节点 InnoDB Cluster、MySQL Router、XtraBackup、账户与数据库置备、参数保护、监控告警与保守移除流程。
• Valkey 与 Silo：REDIS 模块增加 redis_type: valkey；MINIO 模块当前只接受 minio_type: silo。开发周期内出现过的 RustFS 后端已在最终基线前撤回。
• 更安全的集群编排：PGSQL、REDIS、MINIO、KAFKA 与 MYSQL 按显式集群身份选择成员；etcd 委派、DBSU 密钥交换、PITR、备份标记和移除流程均进一步收紧。
• 可观测性升级：新增 Kafka 与 MySQL 面板，MinIO/Silo 迁移到 Metrics V3，pg_exporter 配置升级到 1.4 系列并补齐 PG19、事务年龄、锁、复制与清理压力指标。
• 仓库与供应链升级：本地仓库改由 SOW 原子生成，移除伪造 ModuleMD；离线包可携带版本化源码包；Infra 重打包统一 SHA-256 固定输入、SPDX 许可证与 1PGSTY release。
• 51 套独立配置模板：新增 demo/kafka、demo/mysql 与八节点 ha/octo，并将 ha/trio 更新为三节点 Silo 紧凑高可用拓扑。

Kafka KRaft 试点模块

新的 Kafka 模块 使用节点状态作为权威来源，以动态 KRaft 模式管理 Broker 与 Controller。它既支持同一清单中的多个 Kafka 集群，也支持直接运行 kafka.yml；不完整的 --limit 会被拒绝，避免只更新部分仲裁成员。

• 节点持久化权威 manifest 与 secrets，支持动态 Controller 加入、Broker 准入、成员退役和故障成员三阶段替换。
• 支持 SCRAM-SHA-512、TLS、证书和凭据轮换，并在变更后执行分区健康与协议自检。
• kafka-rm.yml 强制要求非空 -l/--limit，在停服前校验绝对数据目录、目标身份与部分退役所需的幸存锚点。
• 新增 JMX Exporter、Kafka Exporter、Victoria 抓取与告警规则，以及 Overview、Instance、Topic、Consumer 四套 Grafana 面板。

Kafka 仍属于试点模块。客户端必须能够直接解析并访问每个 Broker；Kafka 数据平面不能放在 HAProxy、VIP 或普通四层负载均衡器之后。

MySQL 8.4 试点模块

新的 MySQL 模块 面向固定的 MySQL 8.4 LTS 平台，支持单节点实例与三节点 InnoDB Cluster，并提供 MySQL Shell、MySQL Router、TLS、用户/数据库置备、XtraBackup 定时全备与统一监控。

• 初始化流程校验 1 或 3 个成员，建立集群、协调 Router，并以幂等方式处理已有成员和部分状态。
• mysql_parameters 会保护复制、TLS 与平台保留参数，不能通过 loose_、skip_、disable_ 或 enable_ 前缀绕过限制。
• mysql_databases 仅接受 name、encoding 与 collate，数据库固定使用 DEFAULT ENCRYPTION='N' 创建。
• 移除流程先验证目标、仲裁与成员状态，再依次隔离、停服和清理；与其他模块不同，mysql-rm.yml 遇到无 MySQL 身份的目标会失败关闭。
• 新增 Overview、Cluster、Instance、Replication、Alert 五套 Grafana 面板及 mysqld_exporter 告警。

Valkey、Silo 与 Mongo 模式

Redis / Valkey

REDIS 模块保留 Redis 作为默认引擎，可通过 redis_type: valkey 显式选择 Valkey。Valkey 使用 valkey-server / valkey-cli 软件包，但配置路径、监控 job、服务接口和模块参数继续沿用 redis 命名，以兼容既有清单与仪表盘。

Redis/Valkey 的 systemd 单元改为 Type=notify，启动超时提高到 1800 秒；拓扑、主从关系、密码处理、标签化移除和重建保护也得到加强。

MINIO / Silo

MINIO 仍是兼容模块名，但 v4.5 的角色部署并且只部署 Silo；minio_type 当前唯一合法值为 silo。Silo 继续兼容 S3/Admin API、/minio/* 路由、MINIO_* 环境变量和既有磁盘格式，但软件包、二进制与 systemd 服务名已经改为 silo。

• 启动流程同时检查 systemd Invocation ID、ActiveState=active 与 Silo 集群健康，最长等待约 600 秒，避免把旧进程状态误判为本次启动成功。
• 对象存储成员按 minio_cluster 聚合，清单组名可以不同；多集群清单应分别设置 minio_alias、minio_domain 与 minio_endpoint。
• ha/trio 从单节点对象存储改为三节点单盘 Silo，使用 EC:1，并通过 VIP 与 HAProxy 暴露 9002 端口；模板显式声明三个默认用户，确保 configure -g 后 S3 凭据一致。
• 分布式 Silo 要求 /data/minio 位于独立文件系统；如果它只是根文件系统下的普通目录，Silo 会拒绝使用。
• 本周期曾加入 RustFS 后端，随后在最终源码中完整撤回。Infra 仓库可以保留 RustFS/MinIO 软件包，但它们都不是 v4.5 MINIO 模块支持的后端。

PostgreSQL Mongo 模式

独立 FERRET 角色与 mongo.yml 剧本被移除，能力拆分为 PostgreSQL Mongo 模式 与 FerretDB Docker APP：PostgreSQL/DocumentDB 负责数据层，Docker Compose 中的 FerretDB 负责 MongoDB 协议层。旧的 FerretDB systemd 服务、专用监控抓取和 Mongo 仪表盘不再随 Pigsty 提供。

编排、安全与生命周期

• deploy.yml、slim.yml 以及 PGSQL、REDIS、MINIO、KAFKA、MYSQL 初始化剧本按对应的 *_cluster 身份跳过无关主机；PGSQL、REDIS、MINIO、KAFKA 移除剧本采用同样规则。
• PGSQL 配置、PITR 与移除仅在规范的 etcd 组存在且非空时委派；DBSU SSH 密钥按实际 pg_cluster_members 交换，覆盖 Citus 等跨清单组拓扑。
• PITR 与移除只清理以 /<cluster>/ 为边界的 etcd 子树，避免集群名互为前缀时误删；初始 pgBackRest 备份也只在命令成功后写入 initial.done。
• 各模块移除流程先停服务再清理数据；Kafka、MySQL 与对象存储额外加入目录、仲裁、幸存成员和集群身份检查。
• pgsql.yml 的完整剧本被明确标记为“仅用于首次初始化”：它会重启 Patroni/PostgreSQL 并重新应用托管配置与 bootstrap SQL，不应被当作已初始化集群的日常收敛命令。
• Pigsty 渲染的 systemd 单元统一放在 /etc/systemd/system，敏感配置、环境文件、密钥和特权脚本权限进一步收紧；Debian/Ubuntu 安装期间会抑制 Silo、Redis/Valkey 与遗留日志服务被包脚本提前启动。
• HAProxy 采用 /etc/haproxy/haproxy.cfg 加 /etc/haproxy/conf.d 的固定布局，使用上游 master-worker、master socket 与 Type=notify；dnsmasq 使用动态绑定、本地回答私网 PTR，并处理 INFRA 初始化后才出现的节点地址。
• 节点时间同步在 Debian/Ubuntu 写入原生 /etc/chrony/chrony.conf，EL 继续使用 /etc/chrony.conf；首次校时策略调整为偏差超过 10 秒时允许前 120 次更新步进。

PostgreSQL 内核与扩展

• 默认 PostgreSQL 随仓库更新到 18.6；四套标准 Patroni 模板增加 output_plugin_libraries 白名单，允许 pgoutput、test_decoding 与 wal2json，旧版本会由 Patroni 自动过滤不支持的参数。
• PostgreSQL 19 beta 模板补齐 pgBackRest 2.59 与定时备份支持；该模板仍不默认安装扩展，仅用于 PG19 试用。
• Percona PostgreSQL 18 TDE 使用集群模式，并继续采用 Pigsty 私有安装前缀以避免与原生 PostgreSQL 冲突。
• IvorySQL 补齐默认数据库初始化，并在标准负载模板中启用兼容的 WAL 压缩设置。
• PostgreSQL 事实加载器、各平台 package_map 与默认扩展组同步刷新，修复 PGDG/YUM 命名和缺失包。

以 Pig v1.5.1（531 项）与 v1.7.0（575 项）的内置目录快照复核，本周期新增 46 个扩展、移除 2 个，净增 44：

• 新增 32 个主扩展：argm、cat_tools、cron_utils、fbsql、oidc_validator、online_advisor、pg_cjk_parser、pg_column_tetris、pg_describe、pg_disorder、pg_fts、pg_jieba、pg_kpart、pg_lake、pg_local_cache、pg_mentat、pg_oidc_validator、pg_policy、pg_roast、pg_tiktoken_c、pg_turbovec、pg_vault_tde、pgcontext、pgfr_record、pgmemento、pgmonitor、pgsqlmock、pgwasm、plruby、plx、postbis、qdgc。
• 新增 13 个子扩展：hstore_plruby、jsonb_plruby、ltree_plruby、pg_extension_base、pg_extension_updater、pg_lake_copy、pg_lake_engine、pg_lake_iceberg、pg_lake_table、pg_map、pgcontext_pgvector、pgfr_analyze、qdgc_postgis。
• 新增 1 个 PGDG 扩展：pg_statviz；它保留在在线目录，但不进入默认安装组。
• 移除 pg_analytics 与 spat：前者已经归档，后者是已废弃的 alpha 项目。

此外，emailaddr、explain_ui、Rust 版 oidc_validator、pg_summarize 与 smlar 因上游没有提供可分发许可证而从默认安装组移出；软件包与目录记录仍可保留。pg_relation_sql 是独立 SQL 工具包，不支持 CREATE EXTENSION，因此列入打包变更表但不计入 575 个扩展。

扩展软件包更新表

下表把 v4.4.0 之后的 RPM 与 DEB 批次按扩展名合并为“旧版本 → 最终版本”的四列终态，共 207 个打包条目，并补充 2 个目录移除项。RPM/DEB 版本不同时分别标注；版本未变化表示发生了重构建、包名、许可证元数据或平台覆盖变化。

7 月 10 日后的第一份打包日志覆盖 7 月 7–24 日且没有逐项日期，因此整批纳入，避免遗漏发布后完成的 pgrx 0.19.1 重构建与矩阵修复。版本和实际平台可用性以最终仓库索引为准。

可观测性

• 整套 Grafana 仪表盘通过 Pig/Grafana 工具重导出为 Dashboard API v2；新增 4 个 Kafka 与 5 个 MySQL 面板，并更新 Node、PostgreSQL、Redis 与 Infra 面板的链接、变量和布局。
• MinIO/Silo 的 Overview 与 Instance 面板迁移到 Metrics V3；Victoria 统一抓取 /minio/metrics/v3，并丢弃带非空 bucket 标签的高基数样本。
• pg_exporter 配置升级到 1.4.0，并修复 1.4.1 pg_subrel 查询产生重复时间序列的问题。
• PG19 新增 pg_sub_19、pg_recovery_state、pg_wal_19、pg_lock_stat 与 pg_vacuum_score 采集器；PG10+ 增加 pg_xact_age 事务年龄直方图，并补齐复制槽 idle_timeout 与 WAL Receiver connecting 状态编码。
• Kafka JMX/协议 Exporter 与 MySQL Exporter 纳入统一服务发现、Victoria 抓取和告警规则；journald 日志缺少 PRIORITY 字段时也能安全处理。

仓库、离线包与供应链

• REPO 与 CACHE 角色改用 sow create --pigsty 原子生成 DNF/APT 元数据和 SHA-256 repo_complete 标记，不再注入伪造 ModuleMD。
• module_hotfixes 改为逐仓库显式选择，并仅为需要替换系统模块流的 EL 仓库启用，避免无差别绕过 DNF 模块过滤。
• cache.yml 在 dist/<version>/pigsty-<version>.tgz 已预先生成时，会把该源码包一并放入离线仓库；它不会隐式打包当前工作树，也不会联网下载源码。
• RPM Exporter 包名统一由下划线改为连字符，例如 node_exporter → node-exporter；旧名称通过无版本 Provides/Obsoletes 过渡。
• Infra 本地重打包统一使用 PGSTY vendor、SPDX 许可证表达式、1PGSTY release、/etc/default/<service> 环境文件、/usr/lib/systemd/system 厂商单元与 /usr/share/doc/<package> 法律文件。
• 简单二进制包改用带 SHA-256 的上游归档可重复构建；厂商原生 RPM/DEB 则保持字节与原始元数据不变。Silo、Grafana、Code、Code Server 与 Vector 等直供制品均加入固定 URL/校验和。
• 中国区域源路由系统性刷新：操作系统、Docker、Grafana、Percona、MongoDB APT 与 uv/PyPI 优先腾讯云，EL/Docker 保留华为云与阿里云回退，MySQL/Kubernetes 使用中科大，ClickHouse 使用华为云。

Infra 软件包更新表

下表将本周期的 Infra 批次合并为每个软件包一行，只保留 v4.4.0 旧值、v4.5.0 最终值和必要备注；中间版本不重复展开。表中的“已构建/已核验”只描述打包记录，最终可安装版本仍以发布时的仓库索引和签名元数据为准。

平台、模板与发布工程

• 推荐平台基线更新到 Rocky Linux 9.8/10.2、Debian 12.15/13.6、Ubuntu 22.04.5/24.04.4/26.04.0；Terraform 云镜像与 Vagrant box 固定版本同步刷新。
• Vagrant 根盘改为可配置的 root_disk：默认 64 GiB，all、rpm、deb、oss、pro 构建矩阵使用 128 GiB；原有 disk 仍表示额外 /data 盘，默认 128 GiB。vagrant 用户登录 Shell 统一为 Bash。
• 新增八节点 ha/octo 仿真环境；ha/trio 改为三节点 Silo + VIP/HAProxy，demo/minio 显式选择 Silo 并裁剪本地仓库包组。
• safe 与 demo 模板改用有效的扩展别名；tuned profile 路径按操作系统适配，集群规模比较继续兼容 Ansible 2.19 之前的类型行为，并清理不再使用的内部标志与 MINIO/INFRA 变量。
• Docker 基础镜像更新到 Debian 13.6 并标记 v4.5.0；镜像发布工作流改为手动触发并从标签构建。
• docker/Makefile 的数据目录固定为仓库内 ./data；make purge 不再接受外部 DATA 覆盖，也没有倒计时。
• GitHub Actions 批量升级 checkout、CodeQL、Docker build/login 与 Cosign；发布、引导、安装、校验和构建模板同步收紧参数与文件处理。
• 发布归档从 conf/meta.yml 生成顶层 pigsty.yml，纳入 Kafka/MySQL 剧本并移除旧 Mongo 剧本；签名工作流只为 pigsty-<tag>.tgz 源码包生成 Cosign 签名，不签署多 GB 离线包。
• README、SECURITY、CONTRIBUTING、AGENTS 与 NOTICE 同步到 v4.5、575 扩展、Silo、Redis/Valkey 和 Mongo 模式，并更新 2026 版权与商标说明。

兼容性变化与升级说明

从 v4.4 升级前，请特别检查以下变化：

1. FERRET 拆分：移除旧 ferretdb systemd 服务，使用 Mongo 配置模式部署 DocumentDB 数据层，再用 docker.yml / app.yml 部署 FerretDB 协议层；旧 mongo.yml、mongo_* 参数和专用面板不再提供。
2. Silo 取代 MinIO 服务端：minio_type 只接受 silo。协议与磁盘格式兼容不等于迁移已经验收；切换既有对象存储前必须验证备份、原地兼容性、回滚和真实读写。
3. ha/trio 对象存储拓扑变化：新模板是三节点单盘 Silo。既有单节点池不能通过简单增加两名成员原地扩容，应新建集群并迁移对象。
4. HAProxy 单元变化：Pigsty 不再渲染 /etc/default/haproxy，但单元会可选读取它；只使用 EXTRAOPTS，并保留 -S /run/haproxy-master.sock，不要加入 -f。
5. 显式集群身份：自定义清单必须为目标主机定义 pg_cluster、redis_cluster、minio_cluster、kafka_cluster 或 mysql_cluster；仅依赖固定组名的旧清单需要补齐。
6. PGSQL 完整剧本仅用于初始化：不要在已初始化节点上完整重跑 pgsql.yml。日常维护使用精确标签；需要完整重建时，先按正式流程验证备份并移除目标成员。
7. Valkey 为显式选择：只有设置 redis_type: valkey 才会安装 Valkey；模块参数、配置路径和监控接口仍沿用 Redis 命名。
8. SOW 成为核心依赖：REPO/CACHE 需要 SOW 0.3.0。旧离线包或旧本地仓库如果没有 sow，应先从 Pigsty Infra 仓库补齐。
9. Exporter RPM 政名：外部自动化与私有仓库应从 node_exporter、redis_exporter 等旧名迁移到 node-exporter、redis-exporter。
10. 默认扩展组收紧许可证：依赖 emailaddr、explain_ui、oidc_validator、pg_summarize、smlar 的环境需改为显式安装，并自行确认许可证与再分发边界。
11. Docker 清理语义变化：make purge 会直接删除仓库内 ./data；执行前确认没有需要保留的容器数据。
12. Vagrant 磁盘语义变化：root_disk 控制系统盘，disk 控制额外 /data 盘；分布式 Silo 依赖后者是真实独立挂载。

获取 v4.5.0

在受支持的全新 Linux 节点上安装：

curl -fsSL https://repo.pigsty.io/get | bash -s v4.5.0
cd ~/pigsty
./bootstrap
./configure
./install.yml

生产升级不是简单覆盖安装。请先阅读本页兼容性变化，核对目标集群、备份、清单身份与实际运行状态，再以明确的 -l 范围执行检查模式或维护操作。