在美国Linux服务器部署PostgreSQL 18,如何配置受限远程连接?
这套方案以 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 |
| PostgreSQL | PostgreSQL 18 | 使用 PGDG 软件仓库 |
| 数据库服务器私有地址 | 10.20.10.15 | 应替换为服务器实际本地地址 |
| 数据库域名 | db-us.example.com | TLS 校验证书时使用 |
| 数据库名 | appdb | 仅允许指定角色连接 |
| 数据库角色 | app_user | 非超级用户 |
| 允许的客户端地址 | 203.0.113.25/32 | 文档示例地址,表示一个固定出口地址 |
| 数据库端口 | TCP 5432 | PostgreSQL 默认端口 |
| 认证方式 | 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 中创建以下规则:
| 协议 | 端口 | 来源 | 目的 |
|---|---|---|---|
| TCP | 5432 | 203.0.113.25/32 | 仅允许指定客户端访问 |
| TCP | 22 | 管理员固定地址 | 保留 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. 连接超时或连接被拒绝
应按由外到内的顺序检查:
- 客户端 DNS 是否解析到正确的服务器地址。
- 云防火墙是否允许客户端实际出口地址访问 TCP 5432。
- UFW 是否存在对应放行规则。
- 服务器是否在预期地址监听 5432。
- PostgreSQL 是否正在运行。
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



