pgBackRest远程备份配置问题解析与解决方案

背景介绍

pgBackRest是一款功能强大的PostgreSQL数据库备份工具，支持多种备份存储方式。在实际生产环境中，管理员常常需要配置远程备份以实现数据冗余。本文将通过一个典型配置案例，分析远程备份失败的原因并提供解决方案。

问题现象

用户在使用pgBackRest 2.53.1版本为PostgreSQL 15.6配置远程备份时遇到两个主要问题：

1. 执行备份命令时出现错误："backup command must be run on the repository host"
2. WAL归档时出现校验和不匹配错误："WAL file already exists in the repo2 archive with a different checksum"

配置分析

用户当前的配置采用了混合模式：

• repo1：本地存储路径/app/postgres_backups
• repo2：远程服务器backup-server上的/app/postgres_backups

这种同时配置本地和远程存储库的方式在实际应用中较为常见，但需要特别注意执行方式。

根本原因

备份命令执行位置问题

pgBackRest对于远程备份有两种工作模式：

1. 推送模式：在PostgreSQL服务器上执行备份命令，将数据推送到远程存储
2. 拉取模式：在备份服务器上执行备份命令，从PostgreSQL服务器拉取数据

当配置了repo-host参数时，pgBackRest默认期望采用拉取模式，即备份命令必须在备份服务器上执行。而用户尝试在PostgreSQL服务器上执行备份命令，因此系统报错。

WAL校验和不匹配问题

该错误表明远程存储库中已存在同名但内容不同的WAL文件，这通常由以下情况引起：

• 之前有过失败的备份尝试
• 时间线发生了切换
• 存储库被手动修改过

解决方案

方案一：统一使用推送模式

1. 移除repo2-host配置项
2. 配置SFTP或S3等协议直接访问远程存储
3. 确保PostgreSQL服务器可以访问远程存储路径

方案二：统一使用拉取模式

1. 在备份服务器上安装pgBackRest
2. 配置从备份服务器连接到PostgreSQL服务器
3. 所有备份操作在备份服务器上执行

WAL校验和问题处理

1. 检查并清理远程存储库中的冲突WAL文件
2. 确认PostgreSQL时间线历史
3. 必要时重建存储库索引

最佳实践建议

1. 模式选择：生产环境推荐使用拉取模式，减少对数据库服务器的影响
2. 权限配置：确保备份用户对存储路径有适当权限
3. 监控设置：配置日志监控，及时发现归档问题
4. 定期验证：定期执行备份恢复测试

总结

pgBackRest的远程备份功能强大但需要正确配置。理解推送和拉取模式的区别是关键所在。对于需要同时使用本地和远程存储库的场景，建议采用一致的访问模式，避免混合配置带来的复杂性。