PostgreSQL / 系统课时

配置复制账号与访问控制

配置复制账号与访问控制

这一课建立备库到主库的物理复制认证链路:创建专用复制角色,用 pg_hba.conf 精确限制来源地址和认证方式,并从备库进入物理复制 walsender 模式执行 IDENTIFY_SYSTEM,验证网络、TLS、认证和复制权限是否全部可用。

学习目标

  • 创建具有 LOGIN 和 REPLICATION 属性的专用复制账号
  • 使用 pg_hba.conf 限制物理复制连接的来源与认证方式
  • 用 replication=true 验证物理复制协议连接

创建专用复制角色

流复制账号不需要超级用户权限。应单独创建只承担复制职责的登录角色,避免让备库长期保存超级用户凭据。

在主库执行:

sql
CREATE ROLE replicator
WITH LOGIN REPLICATION
PASSWORD '<STRONG_PASSWORD>';

预期结果

text
CREATE ROLE

<STRONG_PASSWORD> 应替换为实际高强度密码,并通过受控的密码管理方式保存,不要提交到脚本仓库。

确认角色属性:

sql
SELECT rolname, rolcanlogin, rolreplication, rolsuper
FROM pg_roles
WHERE rolname = 'replicator';

预期输出

text
  rolname   | rolcanlogin | rolreplication | rolsuper
------------+-------------+----------------+----------
 replicator | t           | t              | f
(1 row)

关键状态是 rolcanlogin=t、rolreplication=t 且 rolsuper=f,说明账号可以登录并发起复制连接,但没有被扩大为超级用户。

限制复制连接来源

pg_hba.conf 决定哪些客户端可以连接以及使用什么认证方式。对于固定主备节点,应把来源限制为备库单个地址或明确网段,而不是开放给所有来源。

假设备库地址为 <STANDBY_IP>,且主库已经正确启用 TLS,可加入下面这一行:

text
hostssl replication replicator <STANDBY_IP>/32 scram-sha-256

这是配置片段,不是独立命令。replication 匹配物理复制连接,replicator 限定角色,/32 只允许指定 IPv4 地址,scram-sha-256 使用 SCRAM 密码认证,hostssl 则要求连接经过 TLS。

复制连接从备库经过访问控制进入主库

修改文件后重新加载访问控制配置。修改 pg_hba.conf 通常不需要重启实例。

sql
SELECT pg_reload_conf();

预期输出

text
 pg_reload_conf
----------------
 t
(1 row)

返回 t 只表示服务器接受了重新加载请求,并不能证明目标连接一定能通过,所以还要从备库实际发起复制协议连接。

确认 SCRAM 密码设置

如果规则使用 scram-sha-256,应确认后续创建或重设密码时使用 SCRAM 格式:

sql
SHOW password_encryption;

预期输出

text
 password_encryption
---------------------
 scram-sha-256
(1 row)

password_encryption 影响新设置密码时生成的密码验证器;如果复制角色密码是在旧配置下创建的,调整该参数后还需要重新设置角色密码,再进行认证测试。

从备库验证物理复制协议

普通 SQL 登录成功只能证明常规数据库连接可用,不能完整验证物理复制权限。物理流复制测试必须让启动报文携带 replication=true(也可写 on、yes 或 1),使后端进入物理复制 walsender 模式。replication=database 会进入逻辑复制 walsender 模式,不能作为本课的物理复制验证方式。

在备库执行,并按提示输入复制账号密码:

bash
psql "host=<PRIMARY_IP> port=5432 user=replicator sslmode=require replication=true" -c "IDENTIFY_SYSTEM;"

预期输出

text
      systemid       | timeline |  xlogpos   | dbname
---------------------+----------+------------+--------
 <ID>                | <ID>     | <VALUE>    |
(1 row)

systemid、timeline 和 xlogpos 都是运行时动态值,实际结果会不同。物理复制模式没有连接到具体数据库,因此 dbname 为空;能够返回 IDENTIFY_SYSTEM,说明客户端已经进入物理复制协议上下文,并通过了网络、TLS、pg_hba.conf、密码认证和 REPLICATION 权限检查。

按报错位置定位失败

出现 no pg_hba.conf entry 时,优先检查来源 IP、replication 规则和规则顺序;出现 password authentication failed 时检查密码验证器与认证配置;出现连接超时或拒绝时,先检查监听地址、防火墙和端口。

还可以使用有权限读取该系统视图的管理账号,在主库确认规则是否被 PostgreSQL 正确解析:

sql
SELECT line_number, type, database, user_name, address, netmask, auth_method, error
FROM pg_hba_file_rules
WHERE 'replicator' = ANY(user_name)
ORDER BY line_number;

预期输出

text
 line_number |  type   |   database    |   user_name    |    address     |      netmask        |  auth_method  | error
-------------+---------+---------------+----------------+----------------+---------------------+---------------+------
 <ID>        | hostssl | {replication} | {replicator}   | <STANDBY_IP>   | 255.255.255.255     | scram-sha-256 |
(1 row)

当物理复制协议测试成功且对应规则的 error 为空时,这条主备认证链路才算完成。后续执行基础备份或启动备库时,应继续使用同一个受限复制角色。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置复制账号与访问控制

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通