PostgreSQL / 系统课时
准备 PITR 恢复数据目录
准备 PITR 恢复数据目录
PITR 的第一步不是配置恢复目标,而是把物理备份还原成一个与生产完全隔离、可安全启动的恢复目录。本节重点处理目录复制、旧运行状态、pg_wal、配置与表空间,确保后续 WAL 回放不会误用生产路径或过期文件。
学习目标
- 从基础备份或合并后的物理备份构建独立恢复目录
- 正确区分必须保留的备份元数据、应清理的备份内 WAL 与可补回的未归档 WAL
- 在启动恢复前验证版本、权限、配置来源和表空间隔离
先划清恢复目录边界
恢复实例必须使用独立的 PGDATA、端口、日志位置和表空间路径。不要在仍运行的生产目录上直接做 PITR,也不要让恢复副本继续引用生产实例的 pg_wal 或表空间目录。物理备份只能由兼容的 PostgreSQL 主版本启动,因此复制后先检查 PG_VERSION。
如果使用 PostgreSQL 增量备份,应先通过对应版本的 pg_combinebackup 将完整备份和依赖的增量备份合并成可恢复的合成完整备份,再把合并结果作为恢复起点;不要把多个增量目录手工覆盖到 PGDATA。
恢复时要区分三类内容:数据文件以及 backup_label、存在时的 tablespace_map 应随备份保留;备份副本中原有的 pg_wal 内容应清理;故障前另外保存、尚未归档的 WAL 则应保留在独立位置,并在恢复目录完成隔离后复制回新的 pg_wal。这三者不能混为一谈。

复制备份并清理旧状态
下面假设已经得到可恢复的物理备份 /srv/backup/postgresql/base,目标目录为 /srv/postgresql/pitr-data。示例把复制、运行状态清理、pg_wal 重建和基础检查合并成一次主流程。rsync --delete 会删除目标中备份不存在的内容,因此目标必须专用于本次恢复。
set -euo pipefail
export BACKUP_DIR=/srv/backup/postgresql/base
export RECOVERY_DIR=/srv/postgresql/pitr-data
sudo install -d -m 700 -o postgres -g postgres "$RECOVERY_DIR"
sudo rsync -aH --delete "$BACKUP_DIR"/ "$RECOVERY_DIR"/
sudo chown -R postgres:postgres "$RECOVERY_DIR"
sudo chmod 700 "$RECOVERY_DIR"
# 旧实例的进程状态和恢复信号不能直接带入新的 PITR 实例。
sudo rm -f "$RECOVERY_DIR/postmaster.pid" "$RECOVERY_DIR/postmaster.opts"
sudo rm -f "$RECOVERY_DIR/standby.signal" "$RECOVERY_DIR/recovery.signal"
# 不跟随备份中可能指向生产磁盘的 pg_wal 符号链接。
if [ -L "$RECOVERY_DIR/pg_wal" ]; then
sudo rm "$RECOVERY_DIR/pg_wal"
fi
sudo install -d -m 700 -o postgres -g postgres "$RECOVERY_DIR/pg_wal"
# 基础备份副本中的 WAL 可能已经过时;恢复应从干净的 pg_wal 开始。
sudo find "$RECOVERY_DIR/pg_wal" -mindepth 1 -delete
sudo install -d -m 700 -o postgres -g postgres "$RECOVERY_DIR/pg_wal/archive_status"
sudo -u postgres test -s "$RECOVERY_DIR/PG_VERSION"
sudo -u postgres cat "$RECOVERY_DIR/PG_VERSION"
sudo -u postgres test ! -e "$RECOVERY_DIR/postmaster.pid" && echo "runtime files: clean"
sudo -u postgres test -z "$(sudo -u postgres find "$RECOVERY_DIR/pg_wal" -mindepth 1 ! -path "$RECOVERY_DIR/pg_wal/archive_status" -print -quit)" && echo "pg_wal: clean"
sudo stat -c '%U:%G %a %n' "$RECOVERY_DIR"预期输出
<MAJOR_VERSION>
runtime files: clean
pg_wal: clean
postgres:postgres 700 /srv/postgresql/pitr-data<MAJOR_VERSION> 取决于备份实际版本,例如 16 或 17。如果故障时另外保存了未归档 WAL,应在上述清理完成后复制所需 WAL 段到新的 pg_wal,不要移动唯一副本;归档中已有的 WAL 仍由后续 restore_command 获取。
检查配置与表空间隔离
物理数据目录不一定包含完整配置。某些发行版把 postgresql.conf、pg_hba.conf 放在数据目录之外,也可能通过符号链接引用外部文件。恢复前应确认配置来源,并为恢复实例设置独立端口、监听地址和日志位置;后续再加入 restore_command、恢复目标以及新的 recovery.signal。
postgresql.auto.conf 也可能保留 primary_conninfo 或 primary_slot_name。如果本次 PITR 只允许从归档恢复,应在启动前删除或覆盖这些旧连接设置,避免恢复实例意外连接生产主库。
pg_tblspc 保存表空间符号链接。如果链接仍指向生产表空间目录,恢复实例可能直接读写生产数据。应先检查链接目标,再把表空间备份恢复到隔离路径并重建链接。
export RECOVERY_DIR=/srv/postgresql/pitr-data
sudo -u postgres find "$RECOVERY_DIR/pg_tblspc" -maxdepth 1 -type l -printf '%f -> %l\n'
for file in postgresql.conf pg_hba.conf; do
if sudo -u postgres test -e "$RECOVERY_DIR/$file"; then
echo "found: $RECOVERY_DIR/$file"
else
echo "external-or-missing: $file"
fi
done
if sudo -u postgres grep -Eq '^[[:space:]]*(primary_conninfo|primary_slot_name)[[:space:]]*=' "$RECOVERY_DIR/postgresql.auto.conf" 2>/dev/null; then
echo "postgresql.auto.conf: review replication settings"
else
echo "postgresql.auto.conf: no active primary connection settings found"
fi预期输出
<TABLESPACE_OID> -> <ISOLATED_TABLESPACE_PATH>
found: /srv/postgresql/pitr-data/postgresql.conf
found: /srv/postgresql/pitr-data/pg_hba.conf
postgresql.auto.conf: no active primary connection settings found没有额外表空间时第一条命令可以没有输出;配置也可能显示 external-or-missing。这些结果不是让恢复实例去复用生产文件,而是提示你在启动前显式准备独立配置和表空间路径。
启动前验收
在配置 WAL 恢复之前,恢复目录至少应满足这些条件:目录归 postgres 所有且权限收敛;没有旧 postmaster.pid、postmaster.opts 和旧恢复信号;备份副本中的 pg_wal 已清空并与生产 WAL 路径隔离;backup_label 以及存在时的 tablespace_map 保持完整;所有表空间都指向恢复副本;不会通过旧 primary_conninfo 主动连接生产主库。
达到这些条件后,再配置 restore_command、恢复目标和新的 recovery.signal。恢复启动时,PostgreSQL 会按恢复配置取回归档 WAL;若某个需要的段不在归档中,还可以使用你事先安全复制到 pg_wal 的未归档 WAL,从而在不触碰生产数据的前提下继续 PITR。