搭建 PostgreSQL 高可用集群

适用场景

用 Patroni + etcd + HAProxy/VIP 搭建 1 主多从的 PostgreSQL 高可用集群，支持自动故障切换和读写分离。

前置条件

• 3 台以上数据库节点，1 个 DCS（etcd/Consul）集群或与 Patroni 同机部署。
• 时间同步、稳定网络和独立数据盘。
• 负载均衡/VIP 方案（HAProxy + Keepalived 或云 LB）。
• 备份方案（pgBackRest/WAL-G）。

步骤

1. 安装 PostgreSQL、Patroni、etcd 和 HAProxy。

2. 配置 etcd 集群（3 节点奇数）。

3. 配置 /etc/patroni.yml：

scope: pg-cluster
name: pg1
restapi:
  listen: 0.0.0.0:8008
  connect_address: 10.0.0.11:8008
etcd3:
  hosts: 10.0.0.11:2379,10.0.0.12:2379,10.0.0.13:2379
bootstrap:
  dcs:
    ttl: 30
    loop_wait: 10
    retry_timeout: 10
    maximum_lag_on_failover: 1048576
postgresql:
  listen: 0.0.0.0:5432
  data_dir: /var/lib/postgresql/16/main
  authentication:
    replication:
      username: replicator
      password: secret

4. 启动第一个节点并初始化，其他节点用相同配置加入。

5. 验证集群：

patronictl -c /etc/patroni.yml list
patronictl -c /etc/patroni.yml topology

6. 配置 HAProxy 指向 Patroni REST API 或主库端口，提供读写/只读入口。

7. 测试切换：

patronictl -c /etc/patroni.yml switchover
patronictl -c /etc/patroni.yml failover

验证

• Patroni 显示 1 leader + N replica。
• 主库写入、备库只读和复制延迟正常。
• 计划内 switchover 无数据丢失，VIP/LB 正常切换。
• 备份和 WAL 归档正常。

回滚

• 保留原单机/旧集群和备份。
• 关闭 Patroni 自动切换，手动指向旧主库。
• 恢复连接串和负载均衡配置。

常见坑

• DCS 失去 quorum 会停止自动切换。
• 同步复制配置不当会影响写入可用性。
• 旧主回退需要 pg_rewind，不一定总能成功。
• HAProxy 健康检查要指向正确端口/角色。
• 不要手工改 PostgreSQL 配置，Patroni 会覆盖。
• 生产要定期做切换演练和备份恢复演练。

相关命令

• patroni — 高可用
• psql — 数据库
• etcdctl — DCS
• pgbackrest — 备份

读完自测

合上页面，先回答，再展开对照。

1. 搭建 PostgreSQL 高可用集群前，对节点、DCS 和负载均衡有什么要求？
2. 如何验证集群的高可用和切换确实有效？
3. 回滚到旧集群或旧主库时要注意什么？