PostgreSQL 主从集群搭建
下面是 PostgreSQL 主从复制（Streaming Replication）环境的安装与配置指南，适合在两台或多台服务器之间构建一主一从（或一主多从）的高可用读写分离系统。
环境准备
| 角色 | 主机名/IP | 说明 |
|---|---|---|
| 主库 | 192.168.1.10 | 可读写，负责复制源 |
| 从库 | 192.168.1.11 | 只读，从主库同步数据 |
推荐 PostgreSQL 版本一致，例如 15.x；操作系统为 Ubuntu/CentOS 均可。
一、安装 PostgreSQL（主从都要装）
以 Ubuntu 为例：
sudo apt update
sudo apt install postgresql postgresql-contrib -y
CentOS：
sudo yum install -y postgresql-server postgresql-contrib
初始化数据库（如未自动初始化）：
sudo -u postgres /usr/pgsql-15/bin/initdb -D /var/lib/pgsql/15/data
二、配置主库（192.168.1.10）
1. 修改 postgresql.conf
路径通常为 /etc/postgresql/15/main/postgresql.conf 或 /var/lib/pgsql/15/data/postgresql.conf
# 启用 WAL 日志并设置参数
wal_level = replica
max_wal_senders = 10
wal_keep_size = 128MB
hot_standby = on
listen_addresses = '*'
2. 修改 pg_hba.conf（允许从库连接复制）
# 添加允许从库复制连接
host replication all 192.168.1.11/32 md5
3. 重启主库
sudo systemctl restart postgresql
三、从库配置（192.168.1.11）
1. 停止 PostgreSQL 服务并清空数据目录
sudo systemctl stop postgresql
rm -rf /var/lib/postgresql/15/main/*
2. 使用 pg_basebackup 拉取主库数据
pg_basebackup -h 192.168.1.10 -D /var/lib/postgresql/15/main -U postgres -P -R
说明：
-h：主库 IP-D：写入数据目录-U：复制用户（需先创建）-R：自动创建standby.signal和primary_conninfo
如果提示用户不存在，请先在主库执行：
CREATE ROLE repl WITH REPLICATION LOGIN PASSWORD 'replpass';
并确保 pg_hba.conf 中允许该 IP 使用此用户连接。
3. 修改复制用户密码（如果 -R 中未设置）
编辑 postgresql.conf 确保：
primary_conninfo = 'host=192.168.1.10 port=5432 user=repl password=replpass'
四、启动从库
sudo systemctl start postgresql
检查日志 /var/log/postgresql/postgresql-15-main.log 是否同步成功。
五、验证主从同步
主库执行：
SELECT * FROM pg_stat_replication;
从库查看：
SELECT pg_is_in_recovery(); -- 返回 true 表示是从库
六、主从读写测试建议
| 操作 | 主库 | 从库 |
|---|---|---|
| 创建表/插入数据 | ✅ 支持 | ❌ 禁止 |
| 查询数据 | ✅ 支持 | ✅ 支持 |
| 自动同步 | ✅ 向从库推送 | ✅ 被动接收 |
七、开机自启动设置（主从）
sudo systemctl enable postgresql
八、参考目录结构（Debian/Ubuntu）
| 配置文件 | 路径 |
|---|---|
postgresql.conf | /etc/postgresql/15/main/ |
pg_hba.conf | /etc/postgresql/15/main/ |
| 数据目录 | /var/lib/postgresql/15/main/ |
| 日志文件 | /var/log/postgresql/postgresql-15-main.log |
常见问题排查
| 问题 | 解决办法 |
|---|---|
pg_basebackup 报权限错误 | 主库需创建 replication 权限用户 |
| 从库无法连接主库 | 检查主库防火墙 / pg_hba.conf |
主库 pg_stat_replication 为空 | 检查从库连接信息是否正确 |
| 写入从库失败 | 合理，PostgreSQL 只读备库默认禁止写入 |
高级扩展建议
| 目标 | 建议工具 |
|---|---|
| 自动故障切换 | repmgr, Patroni |
| 虚拟 IP 高可用切换 | Keepalived + VIP |
| 读写分离中间件 | pgpool-II |
| 多从、链式复制 | 支持 |
| 双机部署脚本化自动搭建 | Ansible/脚本工具 |