PostgreSQL 主从集群搭建

更新时间：2026年02月09日 10:06:46 作者：思静鱼

本文主要介绍了PostgreSQL 主从集群搭建,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

环境准备

角色	主机名/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/脚本工具

到此这篇关于PostgreSQL 主从集群搭建的文章就介绍到这了,更多相关PostgreSQL 主从集群搭建内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

PostgreSQL 如何获取当前日期时间及注意事项
这篇文章主要介绍了PostgreSQL 如何获取当前日期时间及注意事项，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-10-10
PostgreSQL 查看服务器版本的三种方法
这篇文章主要介绍了PostgreSQL 查看服务器版本的几种方法,本文给大家分享三种方法，结合实例代码给大家讲解的非常详细，需要的朋友可以参考下
2023-03-03
解析PostgreSQL中Oid和Relfilenode的映射问题
这篇文章主要介绍了PostgreSQL中Oid和Relfilenode的映射问题,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2021-01-01
PostgreSQL中的collations用法详解
这篇文章主要介绍了PostgreSQL中的collations用法详解，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-01-01
PostgreSQL 自增语法的用法说明
这篇文章主要介绍了PostgreSQL 自增语法的用法说明，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2021-02-02
PostgreSQL中实现自增的三种方式举例
很多小伙伴在把mysql数据库里面的表导入pgsql数据库的时候,会遇到新增数据的时候id不自增,这篇文章主要给大家介绍了关于PostgreSQL中实现自增的三种方式,需要的朋友可以参考下
2024-02-02
PostgresSQL安装教程及初始使用操作方法
这篇文章介绍了如何在Linux系统上安装和配置PostgreSQL数据库,详细介绍了PostgreSQL的数据类型,并解释了如何使用序列来标识字段的自增长,感兴趣的朋友跟随小编一起看看吧
2026-01-01
PostgreSQL 分区表的实现示例
本文主要介绍了PostgreSQL中的分区表实现,包括传统分区表和内置分区表两种方式,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2026-01-01
Ruoyi从mysql切换到postgresql的几个踩坑实战
最近由于工作的原因,需要将Ruoyi从mysql切换到postgresql,所以这篇文章主要给大家介绍了关于Ruoyi从mysql切换到postgresql的几个踩坑实战,需要的朋友可以参考下
2023-02-02
PostgreSQL中进行数据导入和导出的示例代码
在数据库管理中,数据的导入和导出是非常常见的操作,特别是在 PostgreSQL 中,提供了多种工具和方法来实现数据的有效管理,本文将详细介绍在 PostgreSQL 中如何进行数据导入和导出,并给出具体的命令及示例,需要的朋友可以参考下
2026-03-03