时间点恢复的实现架构

Pigsty 使用 pgBackRest 作为 PostgreSQL 备份与恢复引擎，提供开箱即用的时间点恢复（PITR）能力。

本文从架构层面说明：备份由谁执行、数据流向哪里、仓库如何组织、故障切换后如何保持连续性。

概览

PITR 架构由三条主线构成：备份执行链路、WAL 归档链路、恢复执行链路。

更多执行细节见 备份机制 与 恢复操作。

组件与职责

数据流

flowchart TB
    subgraph cluster["PostgreSQL 集群"]
        direction TB
        primary["Primary<br/>PostgreSQL"]
        pb["pgBackRest"]
        cron["pg-backup / pg_crontab"]
    end
    repo["备份仓库<br/>local / minio / s3"]
    restore["恢复目标数据目录"]

    cron --> pb
    primary -->|base backup| pb
    primary -->|WAL archive| pb
    pb -->|backup/archive| repo
    repo -->|restore/archive-get| pb
    pb -->|restore| restore

要点：

• 备份 由 pg-backup 触发，执行 pgbackrest backup 将基础备份写入仓库。
• 归档 由 PostgreSQL 的 archive_command 触发，持续将 WAL 段写入仓库。
• 恢复 从仓库读取备份与 WAL，通过 pgbackrest restore 重建数据目录。

部署与角色

pgBackRest 安装在 所有 PostgreSQL 节点 上，但只有 主库 实际执行备份：

• pg-backup 会自动检测节点角色，从库执行时直接退出。
• 发生 故障切换 后，新主库自动接管备份与归档，备份连续性不受影响。

这使得备份链路与高可用拓扑解耦，避免因主从切换导致备份中断。

仓库与隔离

Stanza（集群标识）

pgBackRest 使用 stanza 隔离不同集群的备份，Pigsty 将其映射为 pg_cluster：

备份仓库
├── pg-meta/
│   ├── backup/
│   └── archive/
└── pg-test/
    ├── backup/
    └── archive/

仓库类型

Pigsty 通过 pgbackrest_method 选择仓库，通过 pgbackrest_repo 定义仓库参数：

生产环境建议使用远程仓库（MinIO/S3），以避免主机故障导致 数据与备份同时丢失。 详见 备份仓库。

配置映射

Pigsty 会将 pgbackrest_repo 定义渲染为 /etc/pgbackrest/pgbackrest.conf。 备份日志位于 /pg/log/pgbackrest/，恢复过程生成临时配置并记录恢复日志。

更多细节请参阅 备份机制。

可观测性

pgbackrest_exporter 会导出备份状态指标（最近备份时间、类型、大小等），默认启用，监听端口 9854。 您可以通过 pgbackrest_exporter_enabled 控制该组件。

相关文档

• 备份机制
• 备份策略
• 备份仓库
• 恢复操作