前言：为何要在 Debian 上玩转 PostgreSQL 主从复制？

如果你已经在生产环境里折腾了几年的数据库， 突然发现一次硬盘崩溃就把业务拉进了深渊，那种心情……简直比看完一部烂片还难受。于是 高可用容灾备份便成了每个 DBA 必不可少的“灵魂伴侣”。在 Debian 系统上部署 PostgreSQL 的流复制， 不仅能让你的数据实时同步，还能在主库挂掉的瞬间把读请求无缝切到从库，真正做到“一键恢复”。下面我将用最接地气的语言、配合大量代码示例，带你一步步完成这套“魔法”。准备好咖啡和键盘了吗？让我们开始吧，没耳听。。

一、 环境准备与前置检查

项目	要求
操作系统	Debian 10/11/12
PostgreSQL 版本	12 以上
网络连通性	主从机器之间 TCP 5432 端口必须畅通
系统时间同步	NTP 同步，否则 WAL 时间戳会闹笑话
磁盘空间	至少保留 5GB 的 WAL 日志存档空间

公正地讲... 小贴士：如果你是第一次踩踏 Linux 防火墙，别忘了先把 ufw 或 iptables 给关掉——不然连不上也只能怪自己。

1.1 安装基础工具 & 同步时间

# 更新软件源
sudo apt update && sudo apt upgrade -y
# 安装 NTP
sudo apt install -y ntp
sudo systemctl enable --now ntp

1.2 安装 PostgreSQL

# 添加官方仓库
echo "deb http://apt.postgresql.org/pub/repos/apt $-pgdg main" \
| sudo tee /etc/apt/sources.list.d/pgdg.list
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc \
| sudo apt-key add -
sudo apt update
sudo apt install -y postgresql-14 postgresql-contrib

安装完毕后用 psql --version 确认两台机器的版本保持一致。

二、 配置主服务器——让它成为数据的“大老板”

2.1 编辑 postgresql.conf

打开位于 /etc/postgresql/14/main/postgresql.conf 的配置文件，将以下关键参数调好：，太刺激了。

# Listen on all interfaces 
listen_addresses = '*'
# 开启流复制所需的 WAL 设置
wal_level = replica               # 必须是 replica 或 logical
max_wal_senders = 10             # 根据从库数量酌情增减
wal_keep_segments = 64           # 保留足够的 WAL 文件防止落后太多
# 热备模式，让从库可以接受只读查询
hot_standby = on
# 合理设置 checkpoint 参数，防止磁盘突发写入导致卡顿
checkpoint_timeout = 5min
checkpoint_completion_target = 0.9
max_replication_slots = 5        # 若使用逻辑复制，可提前预留槽位

2.2 配置 pg_hba.conf —— 放行复制专用账号

在同目录下的 /etc/postgresql/1 不忍卒读。 4/main/pg_hba.conf 添加一行：

# 主库允许 replicator 从任意 IP 同步数据
host    replication     replicator      192.168.1.0/24          md5
host    all             all             127.0.0.1/32            trust   # 本地连接保持简单
host    all             all             ::1/128                 trust

2.3 创建复制专用用户

# 切换到 postgres 系统用户
sudo -i -u postgres
# 创建一个只用于复制的角色，密码自行设定
createuser --replication --login --no-superuser --no-createdb \
            --no-createrole replicator
psql -c "ALTER USER replicator WITH ENCRYPTED PASSWORD 'YourStrongPass!';"
\q
exit   # 返回普通用户

三、配置从服务器——让它成为可靠的“影子”

3.1 停止 PostgreSQL 服务，为恢复做准备

# 在从库上施行：
sudo systemctl stop postgresql@14-main   # 确保服务已彻底停止
sudo rm -rf /var/lib/postgresql/14/main/*   # 清空旧数据目录

3.2 使用 pg_basebackup 拉取主库全量快照

# 施行一次完整基线备份并压缩归档：
sudo -u postgres pg_basebackup \
   -h 主库IP地址 \
   -D /var/lib/postgresql/14/main \
   -U replicator \
   -W \
   -P \
   --wal-method=stream \
   --format=tar \
   --gzip
# 解压缩得到的数据目录：
cd /var/lib/postgresql/14/main && tar xzf *.tar.gz && rm *.tar.gz

3.3 编写 recovery.conf

A) 在 data 目录下创建一个空文件表示该实例是 standby：，捡漏。

# touch /var/lib/postgresql/14/main/standby.signal

B) 再编辑同目录下的 /etc/postgresql/14 至于吗？ /main/postgresql.conf , 加入以下内容：

也是没谁了。 # 与主库保持心跳链接的信息： primary_conninfo = 'host=主库IP地址 port=5432 user=replicator password=YourStrongPass!'

我悟了。 triggerfile = '/tmp/promoteto_master.trigger'

hot_standby = on

archivemode = on archivecommand = 'cp %p /var/lib/postgresql/14/walarchive/%f' archivetimeout = 60s，我是深有体会。

常见坑点速查表：

PITFALL CURE "could not connect to server: Connection refused"- 检查 listenaddresses 是否为 '*' - 防火墙是否放行端口5432 - 主机名解析是否正确。 "WAL archiving failed"- 确认 archivecommand 路径存在且可写 - 检查磁盘配额。 "replication slot does not exist"- 在主库创建对应 slot： SELECT * FROM pgcreatephysicalreplicationslot; "restartpoint after recovery is required"- 确认 standby.signal 存在；若仍报错，请删除 data 并重新 basebackup。 "duplicate key value violates unique constraint"- 数据冲突通常是主要原因是手动修改了 from‑standby 的表结构，请保持两端 schema 一致，不夸张地说...。

四、 启动服务并验证同步状态

4.1 启动两台机器上的 PostgreSQL 服务

# 主库: sudo systemctl enabl 改进一下。 e --now postgresql@14-main

4.2 在主库创建测试数据

# 切换到 postgres 用户并进入 psql:
sudo -i -u postgres psql

CREATE DATABASE demo; \c demo

CREATE TABLE notes ( id SERIAL PRIMARY KEY, content TEXT NOT NULL, created_at TIMESTAMP DEFAULT now ); INSERT INTO notes VALUES , ; \q

4.3 在从库检查同步情况

SELECT * FROM notes;

If you see two rows inserted earlier, 🎉恭喜，你已经成功完成了流复制！若还没有同步，请耐心等几秒钟或查看日志排查延迟原因，来日方长。。

五、 监控、故障转移与日常运维小技巧

5.1 使用 pg_stat_replication 查看实时状态

# 在主库运行： SELECT pid, clientaddr, state, syncstate, sentlsn, writelsn, flushlsn, replaylsn, 佛系。 now - backendstart AS uptime, now - pglastxactreplaytimestamp AS lagtime FROM pgstatreplication;

看好你哦！ This query gives you a quick glance at latency and wher standby is in sync.

5.2 自动化故障转移方案简述

PATONRI：负责监控 primary 状态，一旦检测到宕机，会自动提升某个 standby 为新 primary；一边更新 DNS 或 VIP。 EETCD：分布式 KV 存储，用来保存 leader 锁信息；确保集群只有唯一一个 leader。 Nginx/Haproxy：前端负载均衡层， 薅羊毛。 只向 VIP 提供服务入口，让客户端透明感知故障切换。 SCRIPT 示例：下面是一段简易 Bash 脚本， 用来手动触发 promotion： #!/bin/bash TRIGGER=/tmp/promotetomaster.trigger

if ; n sudo touch $TRIGGER echo "Trigger file created – standby will promote on next restart." else echo "Trigger already exists." fi 运行完毕后只需重启 Postgres 即可完成提升：

`sudo systemctl restart postgresql@14-main` — 从此刻起，它已经是新 master！ 🚀

6️⃣ 小结 & 心得体会 🚦🚦🚦‍♀️‍♂️‍♀️‍♂️‍♀️‍♂️​​​​​​​​​​ ​ ​ ​ ​ ​ ​ ​  ​​​​​​​​​​​​​​​​​​​​​​​​​​ ​​​​ ​​​​​ 本文约 字， 太离谱了。 如需更细致指导，可关注我的博客或直接留言交流~

---