wal-g

PostgreSQL WAL-G 备份与恢复

补充说明

WAL-G 把 PostgreSQL 基础备份和 WAL 归档到 S3、GCS、Azure 等对象存储，支持压缩、加密和保留策略。它通过环境变量配置。

常用示例

export WALG_S3_PREFIX=s3://my-backups/pg
export AWS_REGION=ap-southeast-1
export AWS_ACCESS_KEY_ID=...
export AWS_SECRET_ACCESS_KEY=...

wal-g backup-push $PGDATA
wal-g backup-list
wal-g backup-fetch $PGDATA LATEST
wal-g wal-push /path/to/wal
wal-g wal-fetch 000000010000000000000001 /tmp/wal
wal-g delete retain FULL 7 --confirm
wal-g st ls s3://my-backups/pg

archive_command：

archive_command = 'wal-g wal-push %p'
restore_command = 'wal-g wal-fetch %f %p'

易错点与排错

• 环境变量必须在 PostgreSQL 服务进程中可见；systemd 要显式配置。
• S3 权限、endpoint、region 和前缀错误会导致上传/恢复失败。
• backup-fetch 前目标数据目录要清空或确认覆盖策略。
• 保留策略会删除旧备份；先确认恢复窗口和合规要求。
• 加密密钥丢失后备份无法恢复；密钥要单独保管。
• 版本升级后确认 WAL-G 兼容 PostgreSQL 和存储。
• 定期做恢复演练，不要只看 backup-list。

相关命令

• pgbackrest — 另一种备份工具
• psql — 数据库
• aws — S3 权限排查