PostgreSQL 主从集群搭建

下面是 PostgreSQL 主从复制（Streaming Replication）环境的安装与配置指南，适合在两台或多台服务器之间构建一主一从（或一主多从）的高可用读写分离系统。

环境准备

推荐 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）

常见问题排查

高级扩展建议