# Pigsty v3.4.0

> 备份改进，自动证书，AGE，Ivory 全平台，本地化，架构与参数改进

---

LLMS 索引： [llms.txt](/zh/llms.txt)

---

**v3\.4\.0 · 2025-03-30**
- [查看发布](https://github.com/pgsty/pigsty/releases/tag/v3.4.0)
- [源码 · tar\.gz](https://github.com/pgsty/pigsty/archive/refs/tags/v3.4.0.tar.gz)
- [源码 · zip](https://github.com/pgsty/pigsty/archive/refs/tags/v3.4.0.zip)
- [pgsty\/pigsty](https://github.com/pgsty/pigsty)

GitHub 发布页面：[v3.4.0](https://github.com/pgsty/pigsty/releases/tag/v3.4.0)

介绍博客：[**Pigsty v3.4 MySQL 兼容性和全面增强**](https://pigsty.cc/blog/pigsty/v3.4)

## 新功能

- 增加了新的 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](https://github.com/pgsty/pigsty/pull/521) 由 [@waitingsong](https://github.com/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](https://github.com/pgsty/pigsty/pull/532) 由 [@waitingsong](https://github.com/waitingsong) 提供）
- 在 `pg-tune-hugepage` 中，限制 PostgreSQL 仅使用大页面（[#527](https://github.com/pgsty/pigsty/pull/527) 由 [@waitingsong](https://github.com/waitingsong) 提供）
- 修复 `pg-role` 任务中的逻辑错误
- 纠正大页面配置参数的类型转换
- 修复 `slim` 模板中 `node_repo_modules` 的默认值问题

## 校验和

```bash
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
```

## 信息来源

- [GitHub Release](https://github.com/pgsty/pigsty/releases/tag/v3.4.0)
- [Pigsty v3.4 发布文章](https://pigsty.cc/blog/pigsty/v3.4/)
- [历史 About / 发布注记](https://pigsty.cc/docs/about/release/#v340)
- [源码对比：`v3.3.0...v3.4.0`](https://github.com/pgsty/pigsty/compare/v3.3.0...v3.4.0)