在美国Linux服务器部署PostgreSQL 18,如何配置受限远程连接?

发布人:A5数据发布时间:2026-10-15 09:04阅读量:189

这套方案以 Ubuntu Server 24.04 LTS、x86_64、PostgreSQL 18 为部署环境,目标是在美国机房的 Linux 服务器上运行一个可被指定应用主机访问的数据库实例。远程访问不直接对所有公网地址开放,而是同时使用监听地址、云防火墙或 UFW、PostgreSQL pg_hba.conf 和 SCRAM 身份认证进行四层限制。

实际部署时,应优先让应用通过服务器私有地址访问数据库;只有应用不在同一私有网络、确实需要经过公网地址连接时,才开放 TCP 5432,并且只允许固定的客户端出口 IPv4 地址。下面的 IP、域名和数据库名称均为示例,不能直接当作实际环境参数使用。

针对美国地区的数据库与业务后台部署,A5数据提供常规Xeon、AMD EPYC物理服务器,配备DDR5内存、SSD或NVMe存储,可承载PostgreSQL数据库、接口服务及多任务运行。美国系列还提供CN2 GIA线路方案,结合不同CPU、内存、磁盘与带宽资源,为远程访问、跨境业务和应用数据库部署提供服务器基础。

一、目标环境与访问边界

1. 本文采用的示例环境

项目示例值说明
操作系统Ubuntu Server 24.04 LTS使用 APT 和 systemd
PostgreSQLPostgreSQL 18使用 PGDG 软件仓库
数据库服务器私有地址10.20.10.15应替换为服务器实际本地地址
数据库域名db-us.example.comTLS 校验证书时使用
数据库名appdb仅允许指定角色连接
数据库角色app_user非超级用户
允许的客户端地址203.0.113.25/32文档示例地址,表示一个固定出口地址
数据库端口TCP 5432PostgreSQL 默认端口
认证方式scram-sha-256不使用远程 trust

203.0.113.0/24、198.51.100.0/24 和 192.0.2.0/24 属于文档示例地址。实际配置时,应替换为应用服务器、办公出口或其他合法客户端的真实地址。

美国服务器的位置主要影响网络延迟、访问路径和数据合规边界,不会改变 PostgreSQL 的监听、认证和防火墙规则。不要因为服务器位于美国,就把整个美国地址段加入白名单。数据库应放行的是实际客户端的出口地址,而不是机房所在国家或地区的地址范围。

2. 上线前需要确认的条件

开始安装前,至少确认以下条件:

  • 已经可以通过 SSH 登录服务器,并拥有 sudo 权限。
  • 服务器使用 Ubuntu 24.04 LTS,且系统时间基本准确。
  • 服务器拥有固定的私有地址或公网地址。
  • 如果通过公网连接,已经知道客户端真正的出口 IPv4 地址。
  • 云平台安全组、网络 ACL 或边界防火墙可以配置 TCP 5432 的来源限制。
  • 应用端可以配置数据库域名、端口、数据库名、用户名、密码和 TLS 参数。
  • 已经安排配置变更时间。修改监听地址、重启数据库或启用防火墙可能会导致现有连接短暂中断。
  • 如果服务器上已经有业务数据库,先完成数据库和配置备份,再进行变更。

检查操作系统和网络地址:

. /etc/os-release
printf 'OS=%s %s\n' "$ID" "$VERSION_ID"
uname -m
ip -br addr
ip route

预期可以看到类似以下信息:

OS=ubuntu 24.04
x86_64
ens3             UP             10.20.10.15/24
default via 10.20.10.1 dev ens3

如果 10.20.10.15 并不是服务器实际拥有的地址,不要将它写入 listen_addresses。云服务器的公网地址有时通过一对一 NAT 映射到私有网卡,遇到这种情况,PostgreSQL 通常应监听网卡上的私有地址,外部访问由云平台完成转发。

二、安装前备份与软件源检查

1. 备份现有数据库全局对象和配置

全新服务器可以直接执行安装;如果已经安装过 PostgreSQL 或服务器上存在业务数据库,先备份角色、权限和配置。

创建仅 PostgreSQL 用户可访问的备份目录:

sudo install -d -o postgres -g postgres -m 700 /var/backups/postgresql

备份角色、表空间等全局对象:

sudo -u postgres pg_dumpall --globals-only \
  | sudo tee /var/backups/postgresql/globals-before-pg18.sql >/dev/null

Ubuntu 上 PostgreSQL 18 的常见配置目录为 /etc/postgresql/18/main。先确认集群和配置文件位置:

sudo -u postgres psql -XAtc "SHOW config_file; SHOW hba_file; SHOW data_directory;"

如果输出路径与下面不同,以命令实际输出为准。确认路径后备份配置目录:

sudo tar -C /etc/postgresql/18 \
  -czf /root/postgresql-18-config-before-remote.tgz main

如果已经有业务数据库,还应单独导出业务库。下面命令会生成自定义格式备份,便于后续使用 pg_restore:

sudo -u postgres pg_dump -Fc -d appdb \
  -f /var/backups/postgresql/appdb-before-remote.dump

这里的备份用于数据和配置回滚,不代表已经具备完整的灾备能力。正式环境还应将备份复制到独立存储,并定期测试恢复。

2. 添加 PostgreSQL 18 软件仓库

Ubuntu 24.04 的系统仓库版本可能不是 PostgreSQL 18,因此示例使用 PostgreSQL APT 仓库。

先安装仓库管理所需组件:

sudo apt update
sudo apt install -y ca-certificates curl gnupg

导入仓库签名密钥并创建软件源:

sudo install -d -m 0755 /usr/share/postgresql-common/pgdg

curl --fail --silent --show-error \
  https://www.postgresql.org/media/keys/ACCC4CF8.asc \
  | sudo gpg --dearmor --yes \
  -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.gpg

echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.gpg] https://apt.postgresql.org/pub/repos/apt noble-pgdg main" \
  | sudo tee /etc/apt/sources.list.d/pgdg.list >/dev/null

更新软件包索引,并确认 PostgreSQL 18 是否可用:

sudo apt update
apt-cache policy postgresql-18

如果 Candidate 显示版本号,说明软件源可用。若没有候选版本,先不要继续安装,应检查以下项目:

  • /etc/os-release 是否确实显示 Ubuntu 24.04。
  • 软件源中的发行版代号是否为 noble-pgdg。
  • 服务器 DNS、出口防火墙和系统时间是否正常。
  • APT 是否报告签名验证失败或仓库访问失败。

三、安装 PostgreSQL 18 并确认集群状态

安装服务端和客户端工具:

sudo apt install -y postgresql-18 postgresql-client-18

Ubuntu 的 PostgreSQL 软件包通常会在安装后自动创建并启动 18/main 集群。检查集群状态:

sudo pg_lsclusters
sudo systemctl status postgresql@18-main --no-pager

预期状态类似:

Ver Cluster Port Status Owner    Data directory              Log file
18     main    5432 online postgres /var/lib/postgresql/18/main ...

使用本地 Unix Socket 查询版本:

sudo -u postgres psql -X -c "SELECT version();"

再使用本地 TCP 回环地址测试:

pg_isready -h 127.0.0.1 -p 5432

成功时通常会返回:

127.0.0.1:5432 - accepting connections

如果集群不是 online,不要立即修改远程访问配置。先查看服务日志:

sudo journalctl -u postgresql@18-main -n 100 --no-pager

确认安装的是 18 版本后,再继续创建数据库角色和配置访问规则。

四、创建受限数据库角色和业务数据库

1. 创建非超级用户角色

不要让应用直接使用 postgres 角色。postgres 具备较高权限,一旦应用密码泄露,影响范围会明显扩大。

先设置新密码使用 SCRAM 格式:

sudo -u postgres psql -X -c "ALTER SYSTEM SET password_encryption = 'scram-sha-256';"
sudo systemctl reload postgresql@18-main

创建业务角色和数据库:

sudo -u postgres psql -X <<'SQL'
CREATE ROLE app_user
    LOGIN
    NOSUPERUSER
    NOCREATEDB
    NOCREATEROLE
    NOREPLICATION
    NOBYPASSRLS
    CONNECTION LIMIT 20;

CREATE DATABASE appdb OWNER app_user;

REVOKE ALL ON DATABASE appdb FROM PUBLIC;
GRANT CONNECT ON DATABASE appdb TO app_user;
SQL

上述语句只应执行一次。如果角色或数据库已经存在,重复执行会报错,不要为了消除报错而随意删除现有对象。

以交互方式设置密码,避免把密码直接写进 Shell 历史:

sudo -u postgres psql -X -c '\password app_user'

命令执行后会提示输入两次密码。密码应放在密码管理系统或应用的密钥配置中,不要出现在脚本、Git 仓库、工单或公开日志中。

检查角色属性:

sudo -u postgres psql -X -c "\du+ app_user"

检查数据库:

sudo -u postgres psql -X -c "\l+ appdb"

如果应用需要由独立迁移程序创建表结构,可以另设一个只在发布窗口使用的迁移角色,不建议长期让运行时角色拥有数据库所有者权限。本文为了聚焦远程连接,使用单一业务角色完成基础示例。

2. 确认 PostgreSQL 实际配置文件

不要只根据目录猜配置文件。执行:

sudo -u postgres psql -Xc "SHOW config_file;"
sudo -u postgres psql -Xc "SHOW hba_file;"
sudo -u postgres psql -Xc "SHOW data_directory;"

在 Ubuntu 24.04 的 PostgreSQL 18 集群中,常见结果如下:

              config_file
-----------------------------------------
 /etc/postgresql/18/main/postgresql.conf

                 hba_file
-----------------------------------------
 /etc/postgresql/18/main/pg_hba.conf

              data_directory
-----------------------------------------
 /var/lib/postgresql/18/main

后续编辑前,建议再次保存当前配置:

sudo cp -a /etc/postgresql/18/main/postgresql.conf \
  /etc/postgresql/18/main/postgresql.conf.before-remote

sudo cp -a /etc/postgresql/18/main/pg_hba.conf \
  /etc/postgresql/18/main/pg_hba.conf.before-remote

五、配置监听地址和 PostgreSQL 认证规则

1. 设置监听地址

编辑配置文件:

sudoedit /etc/postgresql/18/main/postgresql.conf

将 listen_addresses 设置为服务器实际的私有地址:

listen_addresses = '10.20.10.15'
port = 5432

10.20.10.15 只是示例,必须替换为 ip -br addr 中实际存在的地址。

不同网络环境的处理方式如下:

  • 应用和数据库位于同一私有网络:监听数据库服务器的私有地址。
  • 云平台公网地址通过 NAT 映射到私有网卡:通常仍监听私有网卡地址,并在云防火墙中放行公网访问。
  • 服务器确实直接拥有公网网卡地址:可以监听该实际地址。
  • 服务器有多个网卡:只监听提供数据库服务的那张网卡,不必监听所有地址。
  • 如果确实无法确定入口地址,才考虑 listen_addresses = '*';此时必须先完成云防火墙、UFW 和 pg_hba.conf 的精确限制,不能将其作为默认配置。

listen_addresses 属于启动参数,修改后需要重启,而不是只执行 reload:

sudo systemctl restart postgresql@18-main

重启前确认 SSH 会话、应用维护窗口和现有数据库连接的影响。重启后检查服务:

sudo systemctl status postgresql@18-main --no-pager
sudo ss -lntp | grep ':5432'

如果只监听私有地址,预期类似:

LISTEN 0 244 10.20.10.15:5432 0.0.0.0:* users:(("postgres",pid=...,fd=...))

如果显示 0.0.0.0:5432 或 [::]:5432,表示监听范围比预期更大,应回到 postgresql.conf 检查实际生效的配置来源。

2. 配置 pg_hba.conf 的精确规则

编辑 HBA 文件:

sudoedit /etc/postgresql/18/main/pg_hba.conf

保留本地 Socket 连接规则,并在文件中加入仅允许指定数据库、指定角色和指定来源地址的规则:

hostssl  appdb  app_user  203.0.113.25/32  scram-sha-256

这条规则的含义是:

  • hostssl:只接受 TLS 加密的 TCP 连接。
  • appdb:只允许连接到 appdb。
  • app_user:只允许使用 app_user 角色。
  • 203.0.113.25/32:只允许一个固定 IPv4 地址。
  • scram-sha-256:使用 SCRAM 密码认证。

如果应用服务器通过私有地址访问,可以增加私有网段中的精确来源,例如:

hostssl  appdb  app_user  10.20.10.0/24  scram-sha-256

如果只允许一台应用服务器,优先使用 /32,不要直接写成整个网段。规则必须放在任何更宽泛规则之前。例如,下面这类规则会扩大访问范围,不应保留在允许规则之前:

host  all  all  0.0.0.0/0  md5

如果确实存在历史上的宽泛规则,应删除或改为明确的数据库、角色和来源范围。不要用远程 trust,也不要为了临时测试把来源改成 0.0.0.0/0。

IPv6 也需要单独核对。如果 DNS 同时返回 AAAA 记录,而服务器没有配置对应的 IPv6 HBA 和防火墙规则,客户端可能优先尝试 IPv6,导致连接失败。可以选择只发布 A 记录,或者为 IPv6 使用同样严格的来源地址规则。

3. 检查并加载 HBA 规则

先让 PostgreSQL 重新读取 HBA 文件:

sudo -u postgres psql -X -c "SELECT pg_reload_conf();"

返回 t 表示请求已提交。然后检查 HBA 是否存在解析错误:

sudo -u postgres psql -X -d postgres -c "
SELECT line_number,
       type,
       database,
       user_name,
       address,
       auth_method,
       error
FROM pg_hba_file_rules
WHERE error IS NOT NULL;
"

没有返回行,通常表示当前 HBA 文件没有解析错误。

查看已经加载的相关规则:

sudo -u postgres psql -X -d postgres -c "
SELECT line_number,
       type,
       database,
       user_name,
       address,
       auth_method
FROM pg_hba_file_rules
WHERE type IN ('host', 'hostssl', 'hostnossl')
ORDER BY line_number;
"

如果出现 HBA 语法错误,PostgreSQL 可能继续使用旧规则,也可能拒绝重新加载。此时不要继续测试远程连接,应先修正文件并重新执行检查。

六、启用 TLS,避免密码以明文方式传输

1. 优先使用受信任证书

公网数据库连接不应只依靠密码和 IP 白名单。防火墙只能限制来源,不能替代传输加密和服务器身份校验。

生产环境优先使用由受信任 CA 签发的证书,证书的 SAN 应包含数据库客户端实际使用的域名,例如:

db-us.example.com

如果使用 IP 直接连接,证书 SAN 中必须包含该 IP。仅设置 CN 而不设置 SAN,现代客户端通常不会通过严格的主机名校验。

2. 使用自签名证书进行测试

下面是测试环境的自签名证书示例。它可以加密传输,但客户端必须显式信任该证书;生产环境不建议长期使用单台服务器自行签发的证书。

创建证书目录:

sudo install -d -o postgres -g postgres -m 700 \
  /etc/postgresql/18/main/tls

为示例域名生成证书:

sudo -u postgres openssl req -new -x509 -nodes \
  -newkey rsa:3072 \
  -days 825 \
  -keyout /etc/postgresql/18/main/tls/server.key \
  -out /etc/postgresql/18/main/tls/server.crt \
  -subj "/CN=db-us.example.com" \
  -addext "subjectAltName=DNS:db-us.example.com"

设置文件权限:

sudo chown postgres:postgres \
  /etc/postgresql/18/main/tls/server.key \
  /etc/postgresql/18/main/tls/server.crt

sudo chmod 600 /etc/postgresql/18/main/tls/server.key
sudo chmod 644 /etc/postgresql/18/main/tls/server.crt

编辑 postgresql.conf,加入或修改以下配置:

ssl = on
ssl_min_protocol_version = 'TLSv1.2'
ssl_cert_file = '/etc/postgresql/18/main/tls/server.crt'
ssl_key_file = '/etc/postgresql/18/main/tls/server.key'

证书和密钥路径必须与实际文件一致。检查权限:

sudo -u postgres test -r /etc/postgresql/18/main/tls/server.crt
sudo -u postgres test -r /etc/postgresql/18/main/tls/server.key
printf 'certificate and key are readable by postgres\n'

启用 SSL 配置后重启集群:

sudo systemctl restart postgresql@18-main
sudo systemctl status postgresql@18-main --no-pager

查询生效状态:

sudo -u postgres psql -X -c "SHOW ssl;"
sudo -u postgres psql -X -c "SHOW ssl_min_protocol_version;"

3. 客户端连接参数

如果使用受信任 CA 签发的证书,应用连接串应尽量使用严格校验:

host=db-us.example.com port=5432 dbname=appdb user=app_user sslmode=verify-full sslrootcert=/etc/app/certs/ca.crt connect_timeout=5

测试环境使用自签名证书时,可以将 server.crt 分发到客户端的受保护目录,并将其作为信任根:

host=db-us.example.com port=5432 dbname=appdb user=app_user sslmode=verify-full sslrootcert=/etc/app/certs/server.crt connect_timeout=5

sslmode=require 只能确认连接使用加密传输,不能完整校验服务器身份。正式环境应使用 verify-full,并通过域名连接。

如果客户端暂时只能通过 IP 连接,而证书只包含 db-us.example.com,严格校验会失败。正确处理方式是补充包含 IP SAN 的证书或改用正确域名,不要关闭证书校验来规避错误。

七、配置云防火墙和主机防火墙

1. 先配置云平台入口规则

如果服务器由云平台提供,先在安全组、云防火墙或网络 ACL 中创建以下规则:

协议端口来源目的
TCP5432203.0.113.25/32仅允许指定客户端访问
TCP22管理员固定地址保留 SSH 管理能力
其他入站—默认拒绝减少暴露面

如果应用在同一私有网络中,数据库规则应填写应用服务器的私有地址或私有网段,而不是公网地址。

云防火墙和系统防火墙是两层不同的控制。云平台允许而 UFW 拒绝时,连接仍然失败;云平台拒绝而 UFW 允许时,请求也到不了服务器。两层规则必须使用相同的来源范围,并记录变更时间和责任人。

2. 使用 UFW 的配置方式

以下命令只适用于由 UFW 管理主机防火墙的 Ubuntu 服务器。若服务器已经使用其他防火墙管理工具,不要同时修改多个工具的规则。

先放行管理地址的 SSH。ADMIN_IP 必须替换为当前管理出口地址:

sudo ufw allow from ADMIN_IP to any port 22 proto tcp

仅允许指定客户端访问 PostgreSQL:

sudo ufw allow from 203.0.113.25 to any port 5432 proto tcp

查看规则:

sudo ufw status numbered
sudo ufw status verbose

如果 UFW 目前处于 inactive 状态,启用前必须确认 SSH 已放行,否则可能中断当前管理连接:

sudo ufw --force enable
sudo ufw status verbose

不建议在公网服务器上直接执行下面的默认拒绝操作,除非已经确认 SSH、监控、备份和其他必要入站规则全部存在:

sudo ufw default deny incoming

如果误加了数据库放行规则,可以按原规则删除:

sudo ufw delete allow from 203.0.113.25 to any port 5432 proto tcp

防火墙规则只控制网络层访问,不能代替 pg_hba.conf。即使客户端地址已经被 UFW 放行,也必须继续满足数据库名、角色名、TLS 和 SCRAM 认证条件。

七、配置云防火墙和主机防火墙配图

八、按顺序验证部署结果

1. 验证服务和监听状态

先在服务器本机执行:

sudo systemctl is-active postgresql@18-main
sudo systemctl is-enabled postgresql
sudo ss -lntp | grep ':5432'
pg_isready -h 127.0.0.1 -p 5432

预期结果:

  • is-active 返回 active。
  • pg_isready 返回 accepting connections。
  • ss 中只出现计划内的监听地址。
  • 没有意外出现 0.0.0.0:5432 或 [::]:5432。

2. 验证允许地址的远程连接

在允许的客户端主机上执行:

nc -vz -w 5 db-us.example.com 5432

成功后使用 psql 连接:

psql "host=db-us.example.com port=5432 dbname=appdb user=app_user sslmode=verify-full sslrootcert=/etc/app/certs/server.crt connect_timeout=5"

密码应在交互提示中输入,不要直接拼接到命令行。

连接成功后执行:

SELECT current_database(),
       current_user,
       inet_client_addr(),
       inet_client_port();

SELECT ssl,
       version,
       cipher
FROM pg_stat_ssl
WHERE pid = pg_backend_pid();

预期结果应满足:

  • current_database 为 appdb。
  • current_user 为 app_user。
  • inet_client_addr() 是预期的客户端出口地址。
  • pg_stat_ssl.ssl 为 t。
  • TLS 版本不低于服务端配置的最低版本。

inet_client_addr() 对确认真实来源地址非常重要。如果实际显示的是 NAT 后的地址,就必须在 pg_hba.conf 和云防火墙中放行这个实际出口地址,而不是客户端内网地址。

3. 验证未授权地址

在不属于白名单的测试主机上执行:

nc -vz -w 5 db-us.example.com 5432

理想结果是连接超时或被拒绝。如果网络层可以连通,但执行 psql 时收到类似以下错误:

no pg_hba.conf entry for host "...", user "app_user", database "appdb", SSL on

说明请求已经到达 PostgreSQL,但被 HBA 拒绝。此时数据库层限制有效,不过还应检查云防火墙或 UFW 是否应该在更外层直接丢弃该连接。

未授权测试只能使用经过批准的测试地址,不要通过扫描无关主机或第三方网络验证规则。

4. 查看服务日志

遇到连接失败时,查看最近的 PostgreSQL 日志:

sudo journalctl -u postgresql@18-main -n 100 --no-pager

也可以先查询当前日志配置:

sudo -u postgres psql -X -c "SHOW log_destination;"
sudo -u postgres psql -X -c "SHOW log_directory;"
sudo -u postgres psql -X -c "SHOW log_filename;"

日志中常见的有效信息包括:

  • 连接请求的来源地址。
  • 使用的数据库和角色。
  • 是否启用了 SSL。
  • HBA 规则是否拒绝请求。
  • 证书和私钥是否无法读取。
  • 配置文件是否存在语法错误。

九、常见失败情况与处理顺序

1. APT 找不到 postgresql-18

先检查发行版和软件源:

cat /etc/os-release
cat /etc/apt/sources.list.d/pgdg.list
apt-cache policy postgresql-18

如果系统不是 Ubuntu 24.04,不要直接使用 noble-pgdg。应根据实际系统版本选择对应仓库,或者改用与操作系统匹配的安装方式。若 apt update 报签名、DNS 或证书错误,应先修复这些基础问题。

2. 服务启动失败

先查看状态和日志:

sudo systemctl status postgresql@18-main --no-pager
sudo journalctl -u postgresql@18-main -n 100 --no-pager

常见原因包括:

  • listen_addresses 写入了服务器不存在的 IP。
  • postgresql.conf 参数拼写或引号错误。
  • TLS 私钥权限不符合 PostgreSQL 要求。
  • 证书路径不存在。
  • 5432 端口已经被其他进程占用。

检查端口占用:

sudo ss -lntp | grep ':5432'

检查服务器地址:

ip -br addr

如果是配置错误,先恢复备份的配置文件,再启动服务,不要连续反复重启:

sudo cp -a /etc/postgresql/18/main/postgresql.conf.before-remote \
  /etc/postgresql/18/main/postgresql.conf

sudo cp -a /etc/postgresql/18/main/pg_hba.conf.before-remote \
  /etc/postgresql/18/main/pg_hba.conf

sudo systemctl start postgresql@18-main

3. 连接超时或连接被拒绝

应按由外到内的顺序检查:

  1. 客户端 DNS 是否解析到正确的服务器地址。
  2. 云防火墙是否允许客户端实际出口地址访问 TCP 5432。
  3. UFW 是否存在对应放行规则。
  4. 服务器是否在预期地址监听 5432。
  5. PostgreSQL 是否正在运行。
  6. pg_hba.conf 是否允许该数据库、角色和来源地址。

客户端可执行:

getent ahosts db-us.example.com
nc -vz -w 5 db-us.example.com 5432

服务器可执行:

sudo ss -lntp | grep ':5432'
sudo ufw status verbose
sudo pg_lsclusters

如果 nc 超时,通常优先检查路由和防火墙;如果 nc 显示连接被拒绝,通常是没有监听、服务停止或端口被主动拒绝。

4. 出现 no pg_hba.conf entry

重点检查以下内容:

  • 客户端实际来源地址是否为 203.0.113.25。
  • 连接的数据库是否确实是 appdb。
  • 用户名是否确实是 app_user。
  • 客户端是否使用了 TLS。
  • 规则是否写成了 hostssl,而客户端却使用了非 SSL 连接。
  • 是否有更早的规则先匹配并拒绝请求。
  • 规则中的 CIDR 是否正确,单个地址应使用 /32。

如果客户端实际通过 NAT 出口访问,HBA 看到的是 NAT 后地址。只允许真实出口地址,不要为了排错临时加入整个公网网段。

5. 出现密码认证失败

错误可能来自密码、角色、连接目标或规则顺序。先确认实际连接的是 PostgreSQL 18 的目标集群:

sudo -u postgres psql -X -c "SHOW port;"
sudo -u postgres psql -X -c "SHOW data_directory;"

检查角色是否允许登录:

sudo -u postgres psql -X -c "\du+ app_user"

如需重置密码,使用交互方式:

sudo -u postgres psql -X -c '\password app_user'

不要把认证方法改成 trust。如果此前角色使用旧的 MD5 密码,重置密码后再测试 SCRAM,避免不同客户端和服务端之间出现兼容性差异。

6. 出现 TLS 或证书错误

常见原因包括:

  • 客户端连接的域名不在证书 SAN 中。
  • 客户端没有配置 sslrootcert。
  • 自签名证书没有被客户端信任。
  • 客户端通过 IP 连接,但证书只包含域名。
  • PostgreSQL 无法读取私钥。
  • 证书已经过期。

可以查看证书的有效期和 SAN:

openssl x509 \
  -in /etc/postgresql/18/main/tls/server.crt \
  -noout -subject -issuer -dates -ext subjectAltName

检查密钥权限:

sudo stat -c '%U:%G %a %n' \
  /etc/postgresql/18/main/tls/server.key \
  /etc/postgresql/18/main/tls/server.crt

私钥应由 postgres 用户拥有,权限不应允许其他普通用户读取。修改证书后,执行重启或按照当前版本支持的证书 reload 方式加载,并通过 pg_stat_ssl 验证真实连接状态。

九、常见失败情况与处理顺序配图

十、验收与回滚检查项

1. 上线验收清单

完成部署后,逐项记录结果:

  • [ ] 操作系统为 Ubuntu Server 24.04 LTS,架构与软件包匹配。
  • [ ] postgresql-18 和 postgresql-client-18 已安装。
  • [ ] 18/main 集群状态为 online。
  • [ ] 服务已设置为随系统启动。
  • [ ] listen_addresses 只包含计划内的服务器地址。
  • [ ] TCP 5432 没有意外监听在所有公网地址。
  • [ ] 云防火墙只允许指定客户端地址。
  • [ ] UFW 规则与云防火墙规则一致。
  • [ ] pg_hba.conf 只允许目标数据库、目标角色和指定 CIDR。
  • [ ] 未使用远程 trust 或 0.0.0.0/0。
  • [ ] app_user 不是超级用户,且没有创建数据库、创建角色等额外权限。
  • [ ] 客户端使用 sslmode=verify-full 或等效的严格证书校验。
  • [ ] 允许来源可以连接并通过 SCRAM 认证。
  • [ ] 非允许来源无法完成数据库连接。
  • [ ] pg_stat_ssl 显示连接已加密。
  • [ ] 数据库、角色、配置和 TLS 文件均有备份或可重新生成记录。
  • [ ] 已记录实际生效的客户端出口 IP、域名、证书到期时间和防火墙规则。

2. 配置回滚

如果远程配置上线后导致服务异常,优先恢复配置,不要先卸载 PostgreSQL。

停止目标集群:

sudo systemctl stop postgresql@18-main

恢复变更前的配置文件:

sudo cp -a /etc/postgresql/18/main/postgresql.conf.before-remote \
  /etc/postgresql/18/main/postgresql.conf

sudo cp -a /etc/postgresql/18/main/pg_hba.conf.before-remote \
  /etc/postgresql/18/main/pg_hba.conf

启动并确认服务:

sudo systemctl start postgresql@18-main
sudo systemctl status postgresql@18-main --no-pager
pg_isready -h 127.0.0.1 -p 5432

如果使用的是完整配置归档,可在确认归档内容和覆盖范围后恢复:

sudo systemctl stop postgresql@18-main
sudo tar -xzf /root/postgresql-18-config-before-remote.tgz \
  -C /etc/postgresql/18
sudo systemctl start postgresql@18-main

该操作会覆盖归档目录中的配置,可能撤销归档创建之后的其他调整。恢复前应确认没有新的业务配置被同时写入。

删除不再需要的 UFW 数据库放行规则:

sudo ufw delete allow from 203.0.113.25 to any port 5432 proto tcp

同时在云平台安全组或云防火墙中删除对应规则。TLS 证书文件不要在服务仍引用时直接删除;如果回滚到不使用 TLS 的旧配置,应先确认服务已经不再引用这些路径,再将证书归档。

3. 数据回滚

网络配置回滚通常不会修改数据库数据。如果需要回滚数据库对象,应先恢复到新数据库验证,不要立即对生产库执行带有 --clean 的破坏性恢复。

例如创建临时恢复库:

sudo -u postgres createdb appdb_rollback

恢复自定义格式备份:

sudo -u postgres pg_restore \
  --exit-on-error \
  -d appdb_rollback \
  /var/backups/postgresql/appdb-before-remote.dump

确认表、数据量和应用兼容性后,再安排正式切换。pg_restore --clean 会删除目标库中已有对象,使用前必须确认备份完整、业务已停写并且具备明确的再次回滚路径。安装失败时也不建议直接执行 apt purge,因为卸载软件包并不等于安全清理或恢复数据库数据。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3758.html

相关推荐