PostgreSQL主从复制的搭建，其实只要把这个流程理解透，操作起来并不复杂。下面咱们从头开始，把一主一从（或者一主多从）的高可用读写分离系统搭起来。

环境准备

先搞清楚两台机器各自扮演什么角色：

推荐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（Debian系）或者 /var/lib/pgsql/15/data/postgresql.conf（RHEL系）。把下面这些参数改好：

# 启用 WAL 日志并设置参数
wal_level = replica
max_wal_senders = 10
wal_keep_size = 128MB
hot_standby = on
listen_addresses = '*'

2. 修改pg_hba.conf（允许从库连接复制）

加一行规则，允许从库IP来同步数据：

# 添加允许从库复制连接
host    replication     all     192.168.1.11/32     md5

3. 重启主库

sudo systemctl restart postgresql

三、从库配置（192.168.1.11）

到这步，从库需要先把服务停掉，把数据目录清干净，然后用pg_basebackup从主库拉一份全量数据。

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里也要把这个用户的连接权限放开。

3. 修改复制用户密码（如果-R中未设置）

去postgresql.conf里检查一下，确保 primary_conninfo 这一段是配好的：

primary_conninfo = 'host=192.168.1.10 port=5432 user=repl password=replpass'

四、启动从库

sudo systemctl start postgresql

启动之后，建议看看日志有没有异常。日志一般在 /var/log/postgresql/postgresql-15-main.log，如果有报错信息会写得很清楚。

五、验证主从同步

在主库执行下面这条SQL，能看到从库的连接状态：

SELECT * FROM pg_stat_replication;

在从库上查询，确认它是否处于恢复（只读）模式：

SELECT pg_is_in_recovery();  -- 返回 true 表示是从库

六、主从读写测试建议

验证一下读写功能是否符合预期：

七、开机自启动设置（主从）

sudo systemctl enable postgresql

八、参考目录结构（Debian/Ubuntu）

如果对文件放在哪里不熟，可以参考下面这个表：

常见问题排查

实操当中最常遇到的几个坑，提前列出来，省得到时候抓瞎：

高级扩展建议

如果后期要做更完善的高可用架构，以下几个工具可以重点了解一下：