PostgreSQL的流复制功能可以让从库实时同步主库的数据变更,是实现数据库高可用和读写分离的核心方案。下面我们一步步完成流复制的配置。

前置准备
需要准备两台服务器,分别作为主库和从库,安装相同版本的PostgreSQL,确保两台服务器之间网络互通,防火墙开放PostgreSQL默认端口5432。
主库配置步骤
1. 修改postgresql.conf配置
打开主库的postgresql.conf文件,修改以下参数:
-- 开启流复制,允许从库连接 listen_addresses = '*' wal_level = replica max_wal_senders = 10 wal_keep_size = 1024
2. 配置pg_hba.conf允许从库连接
在pg_hba.conf文件末尾添加从库的访问规则:
-- 允许从库IP通过复制用户连接 host replication repl_user 从库IP/32 md5
3. 创建复制专用用户
登录主库执行以下SQL创建复制用户:
CREATE USER repl_user WITH REPLICATION LOGIN PASSWORD '设置的密码';
4. 重启主库服务
修改配置后重启PostgreSQL主库服务使配置生效。
从库配置步骤
1. 备份主库数据到从库
在从库服务器上执行pg_basebackup命令拉取主库数据:
pg_basebackup -h 主库IP -U repl_user -D /var/lib/postgresql/data -P -R
命令执行完成后,从库的数据目录会自动生成standby.signal文件,同时postgresql.auto.conf会添加主库连接配置。
2. 调整从库配置(可选)
如果需要从库支持只读查询,可以修改从库的postgresql.conf添加以下参数:
hot_standby = on
3. 启动从库服务
启动从库PostgreSQL服务,从库会自动连接主库开始同步数据。
同步状态验证
登录主库执行以下SQL查看流复制状态:
SELECT client_addr, state, sent_lsn, write_lsn, flush_lsn, replay_lsn FROM pg_stat_replication;
如果查询结果中出现从库的IP,且state为streaming,说明流复制配置成功。
注意事项
- 主从库的PostgreSQL大版本必须一致,避免兼容性问题
- 主库的wal_keep_size需要根据数据变更量调整,避免从库同步时WAL日志被清理
- 从库默认是只读状态,不能执行写入操作
- 如果主库故障,可以通过提升从库为新的主库实现故障转移
PostgreSQL流复制主从同步数据库配置修改时间:2026-06-01 21:00:36