备份仓库
PostgreSQL 的备份存储仓库
您可以通过指定 pgbackrest_repo 参数来配置存储备份的位置。
您可以在那里定义多个仓库，Pigsty 将根据 pgbackrest_method 的值选择它。
默认仓库
默认情况下，Pigsty 有两个默认备份仓库定义：local 和 minio 备份仓库。
local：默认，使用本地/pg/backup目录（软链接指向pg_fs_backup：/data/backups）minio：使用 SNSD 1 节点 MinIO 集群（由 pigsty 支持，但默认未启用）
pgbackrest_method: local # 选择备份仓库方法，`local` 或 `minio` 或任何其他用户定义的仓库
pgbackrest_repo: # pgbackrest 仓库：https://pgbackrest.org/configuration.html#section-repository
local: # 使用本地 posix fs 的默认 pgbackrest 仓库
path: /pg/backup # 本地备份目录，默认为 `/pg/backup`
retention_full_type: count # 按数量保留全量备份
retention_full: 2 # 使用本地 fs 仓库时保留 2 个，最多 3 个全量备份
minio: # pgbackrest 的可选 minio 仓库
type: s3 # minio 兼容 s3，所以使用 s3
s3_endpoint: sss.pigsty # minio 端点域名，默认为 `sss.pigsty`
s3_region: us-east-1 # minio 区域，默认 us-east-1，对 minio 无用
s3_bucket: pgsql # minio 存储桶名称，默认为 `pgsql`
s3_key: pgbackrest # pgbackrest 的 minio 用户访问密钥
s3_key_secret: S3User.Backup # pgbackrest 的 minio 用户密钥
s3_uri_style: path # 对 minio 使用路径样式 uri 而不是主机样式
path: /pgbackrest # minio 备份路径，默认为 `/pgbackrest`
storage_port: 9000 # minio 端口，默认为 9000
storage_ca_file: /etc/pki/ca.crt # minio ca 文件路径，默认为 `/etc/pki/ca.crt`
block: y # 启用块增量备份
bundle: y # 将小文件打包成单个文件
bundle_limit: 20MiB # 文件包限制，对象存储为 20MiB
bundle_size: 128MiB # 文件包目标大小，对象存储为 128MiB
cipher_type: aes-256-cbc # 为远程备份仓库启用 AES 加密
cipher_pass: pgBackRest # AES 加密密码，默认为 'pgBackRest'
retention_full_type: time # 在 minio 仓库上按时间保留全量备份
retention_full: 14 # 保留最后 14 天的全量备份保留策略
如果您每天备份而不删除它们，备份仓库将越来越大并占满您的磁盘空间。 您需要定义保留策略以仅保留有限数量的备份。
默认备份策略在 pgbackrest_repo 参数中定义，根据需要更改它们。
local：保留最后 2 个全量备份，备份期间最多 3 个minio：保留最后 14 天内的所有全量备份
空间规划
对象存储提供几乎无限的存储容量，因此您无需担心磁盘空间。 您可以通过混合全量和差异备份策略优化空间使用。
对于本地磁盘备份仓库，pigsty 建议使用保留最后 2 个全量备份的保留策略， 这意味着在磁盘上保留两个最新的全量备份（在运行新备份时可能存在第三个副本）。
这为您提供至少最后 24 小时的保证恢复窗口。详情请查看备份策略。
仓库替代方案
您也可以使用其他服务作为备份仓库，详情请查看 pgbackrest 文档：
仓库版本控制
您甚至可以指定仓库目标时间以获取对象存储的快照。
您可以通过在 minio_buckets 中添加 versioning 标志来启用 MinIO 版本控制：
minio_buckets:
- { name: pgsql ,versioning: true }
- { name: meta ,versioning: true }
- { name: data }仓库锁定
一些对象存储服务（S3、MinIO 等）支持锁定，可以防止备份被删除，即使是 DBA 本人。
您可以通过在 minio_buckets 中添加 lock 标志来启用 MinIO 锁定功能：
minio_buckets:
- { name: pgsql , lock: true }
- { name: meta ,versioning: true }
- { name: data }使用对象存储
对象存储服务提供几乎无限的存储容量，并为您的系统提供远程灾难容错。 如果您没有对象存储，Pigsty 有内置的 MinIO 支持。
MinIO
您可以通过取消注释以下设置来启用 minio 备份仓库。 请注意，pgbackrest 只接受 HTTPS / 域名，因此您必须使用域名和 HTTPS 端点运行 MinIO。
all:
vars:
pgbackrest_method: minio # 使用 minio 作为默认备份仓库
children: # 定义一个单节点 minio SNSD 集群
minio: { hosts: { 10.10.10.10: { minio_seq: 1 }} ,vars: { minio_cluster: minio }}S3
如果您只有一个节点，有意义的备份策略可能是使用云供应商的对象存储服务，如 AWS S3、阿里云 OSS 或 Google Cloud 等... 要实现这一点，您可以定义一个新的仓库：
pgbackrest_method: s3 # 使用 'pgbackrest_repo.s3' 作为备份仓库
pgbackrest_repo: # pgbackrest 仓库：https://pgbackrest.org/configuration.html#section-repository
s3: # 阿里云 oss（s3 兼容）对象存储服务
type: s3 # oss 兼容 s3
s3_endpoint: oss-cn-beijing-internal.aliyuncs.com
s3_region: oss-cn-beijing
s3_bucket: <your_bucket_name>
s3_key: <your_access_key>
s3_key_secret: <your_secret_key>
s3_uri_style: host
path: /pgbackrest
bundle: y # 将小文件打包成单个文件
bundle_limit: 20MiB # 文件包限制，对象存储为 20MiB
bundle_size: 128MiB # 文件包目标大小，对象存储为 128MiB
cipher_type: aes-256-cbc # 为远程备份仓库启用 AES 加密
cipher_pass: pgBackRest # AES 加密密码，默认为 'pgBackRest'
retention_full_type: time # 在 minio 仓库上按时间保留全量备份
retention_full: 14 # 保留最后 14 天的全量备份
local: # 使用本地 posix fs 的默认 pgbackrest 仓库
path: /pg/backup # 本地备份目录，默认为 `/pg/backup`
retention_full_type: count # 按数量保留全量备份
retention_full: 2 # 使用本地 fs 仓库时保留 2 个，最多 3 个全量备份管理备份
启用备份
如果您的数据库集群是在 pgbackrest_enable 设置为 true 的情况下创建的，备份将自动启用。
如果是在 false 值下创建的，您可以使用以下命令启用 pgbackrest 组件：
./pgsql.yml -t pg_backup # 运行 pgbackrest 子任务移除备份
Pigsty 在移除主实例（pg_role = primary）时会移除 pgbackrest 备份 stanza。
./pgsql-rm.yml
./pgsql-rm.yml -e pg_rm_backup=false # 保持备份完整
./pgsql-rm.yml -t pg_backup # 仅移除备份使用 pg_backup 子任务仅移除备份，并使用 keep_backup 参数保留备份。
如果您的备份仓库被锁定（例如，S3 / MinIO 有锁定选项），此操作将失败。
备份移除
移除备份可能导致永久数据丢失，这是一个危险操作，请极其谨慎地执行。
列出备份
此命令将列出 pgbackrest 仓库中的所有备份（由所有集群共享）
pgbackrest info手动备份
Pigsty 有一个内置脚本 /pg/bin/pg-backup，它封装了 pgbackrest 备份命令。
pg-backup # 进行增量备份
pg-backup full # 进行全量备份
pg-backup incr # 进行增量备份
pg-backup diff # 进行差异备份基础备份
Pigsty 有一个替代备份脚本 /pg/bin/pg-basebackup，它不依赖 pgbackrest，并为您提供数据库集群的物理副本。
默认备份目录是 /pg/backup。
NAME
pg-basebackup -- make base backup from PostgreSQL instance
SYNOPSIS
pg-basebackup -sdfeukr
pg-basebackup --src postgres:/// --dst . --file backup.tar.lz4
DESCRIPTION
-s, --src, --url Backup source URL, optional, "postgres:///" by default, if password is required, it should be given in url, ENV or .pgpass
-d, --dst, --dir Where to put backup files, "/pg/backup" by default
-f, --file Overwrite default backup filename, "backup_${tag}_${date}.tar.lz4"
-r, --remove .lz4 Files mtime before n minutes ago will be removed, default is 1200 (20hour)
-t, --tag Backup file tag, if not set, target cluster_name or local ip address will be used. Also used as part of DEFAULT filename
-k, --key Encryption key when --encrypt is specified, default key is ${tag}
-u, --upload Upload backup files to cloud storage, (need your own implementation)
-e, --encryption Encrypt with RC4 using OpenSSL, if not key is specified, tag is used as key
-h, --help Print this messagepostgres@pg-meta-1:~$ pg-basebackup
[2025-07-13 06:16:05][INFO] ================================================================
[2025-07-13 06:16:05][INFO] [INIT] pg-basebackup begin, checking parameters
[2025-07-13 06:16:05][DEBUG] [INIT] #====== BINARY
[2025-07-13 06:16:05][DEBUG] [INIT] pg_basebackup : /usr/pgsql/bin/pg_basebackup
[2025-07-13 06:16:05][DEBUG] [INIT] openssl : /usr/bin/openssl
[2025-07-13 06:16:05][DEBUG] [INIT] #====== PARAMETER
[2025-07-13 06:16:05][DEBUG] [INIT] filename (-f) : backup_pg-meta_20250713.tar.lz4
[2025-07-13 06:16:05][DEBUG] [INIT] src (-s) : postgres:///
[2025-07-13 06:16:05][DEBUG] [INIT] dst (-d) : /pg/backup
[2025-07-13 06:16:05][DEBUG] [INIT] tag (-t) : pg-meta
[2025-07-13 06:16:05][DEBUG] [INIT] key (-k) : pg-meta
[2025-07-13 06:16:05][DEBUG] [INIT] encrypt (-e) : false
[2025-07-13 06:16:05][DEBUG] [INIT] upload (-u) : false
[2025-07-13 06:16:05][DEBUG] [INIT] remove (-r) : -mmin +1200
[2025-07-13 06:16:05][INFO] [LOCK] acquire lock @ /tmp/backup.lock
[2025-07-13 06:16:05][INFO] [LOCK] lock acquired success on /tmp/backup.lock, pid=107417
[2025-07-13 06:16:05][INFO] [BKUP] backup begin, from postgres:/// to /pg/backup/backup_pg-meta_20250713.tar.lz4
[2025-07-13 06:16:05][INFO] [BKUP] backup in normal mode
pg_basebackup: initiating base backup, waiting for checkpoint to complete
pg_basebackup: checkpoint completed
pg_basebackup: write-ahead log start point: 0/7000028 on timeline 1
pg_basebackup: write-ahead log end point: 0/7000FD8
pg_basebackup: syncing data to disk ...
pg_basebackup: base backup completed
[2025-07-13 06:16:06][INFO] [BKUP] backup complete!
[2025-07-13 06:16:06][INFO] [RMBK] remove local obsolete backup: 1200
[2025-07-13 06:16:06][INFO] [BKUP] find obsolete backups: find /pg/backup/ -maxdepth 1 -type f -mmin +1200 -name 'backup*.lz4'
[2025-07-13 06:16:06][WARN] [BKUP] remove obsolete backups:
[2025-07-13 06:16:06][INFO] [RMBK] remove old backup complete
[2025-07-13 06:16:06][INFO] [LOCK] release lock @ /tmp/backup.lock
[2025-07-13 06:16:06][INFO] [DONE] backup procedure complete!
[2025-07-13 06:16:06][INFO] ================================================================备份使用 lz4 压缩，您可以使用以下命令解压缩和提取 tarball：
mkdir -p /tmp/data # 将备份提取到此目录
cat /pg/backup/backup_pg-meta_20250713.tar.lz4 | unlz4 -d -c | tar -xC /tmp/data逻辑备份
您也可以使用 pg_dump 命令执行逻辑备份。
逻辑备份不能用于 PITR（时间点恢复）， 但它们对于在不同主版本之间迁移数据或实现灵活的数据导出逻辑很有用。
从仓库引导
现在假设您有一个现有集群 pg-meta，并且想要分叉它作为 pg-meta2：
您需要创建新的 pg-meta2 集群分叉，然后在其上运行 pitr。