主从复制通过流式复制实现,主库配置wal_level=replica、max_wal_senders及pg_hba.conf后创建复制用户;从库用pg_basebackup初始化并创建recovery.signal,设置primary_conninfo和hot_standby=on后启动,通过pg_stat_replication和pg_is_in_recovery()验证同步状态。

PostgreSQL 主从复制(Replication)是通过流式复制(Streaming Replication)实现的,主要用于数据高可用、读写分离和备份。配置过程主要包括主库(Primary)和备库(Standby)的设置。以下是详细的配置流程。
1. 配置主库(Primary Server)
主库负责处理写操作,并将 WAL(Write-Ahead Logging)日志发送给从库。
步骤:
-
启用 WAL 日志记录:确保 WAL 级别为
replica或更高(如logical)。编辑postgresql.conf:
wal_level = replica
- 设置最大连接数:预留连接给复制进程:
max_wal_senders = 10
- 设置 WAL 发送超时(可选):
wal_sender_timeout = 60s
-
允许复制连接:在
pg_hba.conf中添加一行,允许从库连接进行复制:
host replication repuser 192.168.1.20/32 md5
其中 repuser 是用于复制的用户,192.168.1.20 是从库 IP。
- 创建复制用户:
登录 PostgreSQL 执行:
CREATE USER repuser REPLICATION LOGIN ENCRYPTED PASSWORD 'yourpassword';
- 修改配置后重启主库或重载配置:
SELECT pg_reload_conf();
2. 初始化从库(Standby Server)
从库需要先通过基础备份同步主库数据,然后开始流式复制。
步骤:
- 停止从库 PostgreSQL 服务:
sudo systemctl stop postgresql
- 清空从库数据目录(如果是新实例可跳过):
rm -rf /var/lib/postgresql/14/main/*
- 使用 pg_basebackup 从主库拉取数据:
pg_basebackup -h 192.168.1.10 -U repuser -p 5432 -D /var/lib/postgresql/14/main -F p -X stream -P
说明:-h:主库 IP-U:复制用户名-D:本地数据目录-F p:纯文件格式-X stream:流式传输 WAL-P:显示进度
3. 配置从库为 Standby 模式
让 PostgreSQL 启动时以只读模式运行,并连接主库接收 WAL 流。
- 创建 recovery.signal 文件:
在从库数据目录下创建一个空文件:
touch /var/lib/postgresql/14/main/recovery.signal
-
配置 primary_conninfo:在
postgresql.conf或recovery.conf(旧版本)中设置连接信息。PostgreSQL 12+ 直接写入postgresql.auto.conf或主配置文件。
在 postgresql.conf 添加:
primary_conninfo = 'host=192.168.1.10 port=5432 user=repuser password=yourpassword'
hot_standby = on
- 启动从库:
sudo systemctl start postgresql
4. 验证复制状态
确认主从是否正常同步。
- 在主库查看复制进程:
SELECT * FROM pg_stat_replication;
如果有返回记录,表示从库已连接并正在接收 WAL。
- 在从库查看是否处于恢复模式:
SELECT pg_is_in_recovery();
返回 true 表示正在作为从库运行。
- 测试数据同步:在主库创建表或插入数据,检查从库是否自动更新。
基本上就这些。配置成功后,PostgreSQL 会持续将 WAL 记录发送到从库,实现近实时的数据同步。注意网络稳定性、用户权限和防火墙设置。如果需要更高级功能(如自动故障切换),可结合 Patroni、repmgr 等工具实现高可用架构。










