PostgreSQL 主从架构搭建指南
一、离线环境准备
由于部署环境处于内网，需预先在外网主机下载所需的依赖包，并将其拷贝至各服务器的 /tmp/pg_offline 目录下。
yumdownloader --resolve \
gcc \
gcc-c++ \
make \
glibc-devel \
glibc-headers \
kernel-headers \
binutils \
cpp \
readline-devel \
zlib-devel \
openssl-devel \
libicu-devel \
libxml2-devel \
libxslt-devel \
perl-ExtUtils-Embed \
python3-devel \
systemd-devel \
libselinux-devel \
policycoreutils-devel \
ossp-uuid-devel \
ossp-uuid
# 关闭 SELinux 和防火墙
setenforce 0
sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
systemctl stop firewalld.service
# 安装 RPM 包
rpm -ivh *.rpm --nodeps --force
二、PostgreSQL 安装与配置
2.1 基础环境设置
# 创建 postgres 用户及用户组
groupadd postgres
useradd -g postgres postgres
passwd postgres
# 创建相关目录并赋权
mkdir -p /data/app/pg/{data,logs,archive}
chmod 0700 /data/app/pg/{data,logs,archive}
2.2 编译安装 PostgreSQL
解压源码包并进入目录：
tar -xf postgresql-16.2.tar.gz
cd postgresql-16.2
配置编译参数：
./configure \
--prefix=/usr/local/pgsql \
--with-pgport=5432 \
--with-perl \
--with-python \
--with-openssl \
--with-libxml \
--with-libxslt \
--with-icu \
--with-systemd \
--with-uuid=ossp
编译并安装：
make -j4 && make install
chown -R postgres:postgres /usr/local/pgsql /data/app/pg
2.3 初始化数据库与服务配置
# 配置环境变量
echo 'export PATH=$PATH:/usr/local/pgsql/bin' >> /etc/profile
echo 'export PGDATA=/data/app/pg/data' >> /etc/profile
source /etc/profile
# 初始化数据库
su - postgres
initdb -D /data/app/pg/data -E UTF8 --locale=en_US.UTF-8
exit
配置 systemd 服务文件 /usr/lib/systemd/system/postgresql.service：
[Unit]
Description=PostgreSQL 16 database server
Documentation=https://www.postgresql.org/docs/16/static/
After=network.target
[Service]
Type=notify
User=postgres
Group=postgres
Environment=PGDATA=/data/app/pg/data
Environment=PGLOG=/data/app/pg/logs/postgresql.log
ExecStart=/usr/local/pgsql/bin/postgres -D ${PGDATA}
ExecReload=/bin/kill -HUP $MAINPID
KillMode=mixed
KillSignal=SIGINT
TimeoutSec=0
[Install]
WantedBy=multi-user.target
加载并启用服务：
systemctl daemon-reload
systemctl enable postgresql
修改配置文件 /data/app/pg/data/postgresql.conf 中的关键参数：
listen_addresses = '*'
port = 5432
max_connections = 100
wal_level = replica
max_wal_senders = 10
wal_keep_size = 16384
archive_mode = on
archive_command = 'cp %p /data/app/pg/archive/%f'
hot_standby = on
配置访问控制文件 /data/app/pg/data/pg_hba.conf：
host replication replica 192.168.193.21/32 md5
host replication replica 192.168.193.27/32 md5
host all all 0.0.0.0/0 md5
启动服务并创建用于复制的用户：
systemctl start postgresql
su - postgres
psql -c "CREATE ROLE replica WITH REPLICATION LOGIN ENCRYPTED PASSWORD 'Hybridcloud2025';"
exit
2.4 从节点部署
在从节点重复执行 2.1 至 2.3 步骤中的环境准备和安装流程，跳过 initdb 初始化操作。
同步主节点数据：
systemctl stop postgresql
su - postgres
pg_basebackup -h 192.168.193.18 -U replica -D /data/app/pg/data -P -Xs
创建触发备库模式的信号文件：
touch /data/app/pg/data/standby.signal
编辑 /data/app/pg/data/postgresql.conf 添加主库连接信息（每台从库应指定不同的 application_name）：
primary_conninfo = 'host=192.168.193.18 port=5432 user=replica password=Hybridcloud2025 application_name=slave1'
recovery_target_timeline = 'latest'
hot_standby = on
确保权限正确并启动服务：
chown -R postgres:postgres /data/app/pg/data
chmod 0700 /data/app/pg/{data,logs,archive}
systemctl start postgresql
2.5 复制功能验证
检查主库上的复制状态：
su - postgres
psql -c "SELECT client_addr, application_name, state FROM pg_stat_replication;"
预期输出应包含两行记录，state 字段值为 streaming。
创建测试表验证数据同步：
psql
CREATE DATABASE testdb;
\c testdb
CREATE TABLE test_table (id SERIAL PRIMARY KEY, info TEXT);
INSERT INTO test_table (info) VALUES ('Replication test data');
\q
在从库查询确认数据已同步：
psql -c "\c testdb" -c "SELECT * FROM test_table;"
测试 uuid-ossp 扩展：
若提示扩展不存在，则需单独编译安装：
cd /data/app/pg/postgresql-16.2/contrib/uuid-ossp
make && make install
然后在数据库中启用扩展：
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
CREATE TABLE ceshi_uuid (
id uuid PRIMARY KEY DEFAULT uuid_generate_v4(),
info TEXT
);
INSERT INTO ceshi_uuid (info) VALUES ('UUID extension test');
在从库中验证：
psql -d testdb -c "SELECT * FROM ceshi_uuid;"
清理测试资源：
psql -c "DROP DATABASE IF EXISTS testdb;"
