单机环境下pgBackRest的完整部署与配置指南

一、pgBackRest简介与单机部署优势

pgBackRest是专为PostgreSQL设计的高性能备份恢复工具，具有以下核心特性：

• 支持全量/增量/差异备份
• 并行备份恢复（显著提升大数据库处理速度）
• 内置存储库完整性校验
• 支持远程操作和加密传输

在单机部署场景中，pgBackRest展现出独特优势：

1. 资源占用可控：无需额外备份服务器
2. 配置复杂度低：免去网络传输环节
3. 适合中小规模数据库：10TB以下数据库备份效率最佳

二、部署前准备

2.1 系统要求

• 操作系统：Linux（CentOS/RHEL/Ubuntu等）
• PostgreSQL版本：9.5+
• 存储空间：至少是数据库大小的2倍

2.2 软件安装（以CentOS 7为例）

# 添加EPEL仓库
sudo yum install -y epel-release
# 安装pgBackRest
sudo yum install -y pgbackrest
# 验证安装
pgbackrest version

三、详细配置流程

3.1 基础配置文件（/etc/pgbackrest.conf）

[global]
repo1-path=/var/lib/pgbackrest
repo1-retention-full=2
[my_db]
pg1-path=/var/lib/pgsql/12/data

关键参数说明：

• repo1-path：备份存储目录
• retention-full：保留的全量备份数量
• pg1-path：PostgreSQL数据目录

3.2 PostgreSQL配置调整

需修改postgresql.conf：

wal_level = replica
archive_mode = on
archive_command = 'pgbackrest --stanza=my_db archive-push %p'
max_wal_senders = 3

四、备份操作实战

4.1 初始化存储库

sudo -u postgres pgbackrest --stanza=my_db --log-level-console=info stanza-create

4.2 执行首次全量备份

sudo -u postgres pgbackrest --stanza=my_db --type=full backup

4.3 增量备份示例

sudo -u postgres pgbackrest --stanza=my_db --type=incr backup

五、恢复操作指南

5.1 时间点恢复（PITR）

sudo systemctl stop postgresql-12
sudo -u postgres pgbackrest --stanza=my_db --type=time \
  --target="2023-07-01 14:00:00" restore
sudo systemctl start postgresql-12

5.2 全量恢复

sudo -u postgres pgbackrest --stanza=my_db --type=immediate restore

六、高级配置技巧

6.1 备份压缩优化

[global]
compress-type=lz4
compress-level=3

6.2 备份验证

pgbackrest --stanza=my_db --log-level-console=info verify

6.3 自动化备份脚本

#!/bin/bash
# 每周日全量备份，其余时间增量备份
if [ $(date +%u) -eq 7 ]; then
  pgbackrest --stanza=my_db --type=full backup
else
  pgbackrest --stanza=my_db --type=incr backup
fi

七、常见问题解决

1. 权限问题排查：

   • 确保postgres用户对备份目录有读写权限
   • 检查SELinux上下文是否正确

2. 空间不足处理：

   • 定期清理过期备份
   • 使用repo1-retention-full控制备份保留策略

3. 性能优化建议：

   • 增加process-max参数提升并行度
   • 使用SSD存储提升IO性能

八、监控与维护

推荐监控指标：

• 最后一次备份状态
• 备份耗时趋势
• 存储库空间使用率

可通过以下命令获取状态信息：

pgbackrest --stanza=my_db info

结语

本文完整介绍了pgBackRest在单机环境下的部署实践，从基础配置到高级应用全面覆盖。实际部署时建议：

1. 先在测试环境验证备份恢复流程
2. 制定符合业务需求的备份策略
3. 定期进行恢复演练
4. 监控备份系统的健康状态

通过合理配置，单机pgBackRest方案可为企业级PostgreSQL数据库提供可靠的保护屏障。