在日本服务器上部署PostgreSQL,如何配置仅允许指定应用服务器连接?
仅允许指定应用服务器连接 PostgreSQL,通常要同时限制三处:数据库监听的网卡地址、pg_hba.conf 中允许的客户端 IP 和数据库用户,以及主机或云平台防火墙的入站来源。只设置数据库密码,不能阻止其他来源的客户端连接数据库端口。

下面以 Ubuntu Server 22.04/24.04、Ubuntu 仓库提供的 PostgreSQL 软件包为例,假设数据库服务器的内网地址是 10.20.0.10,应用服务器连接数据库时使用的源地址是 10.20.0.21。这些地址仅为示例,请替换为实际地址;若应用服务器经 NAT 出网,数据库看到的源地址可能是 NAT 出口地址,而不是应用服务器网卡上的地址。
准备条件
确认数据库和应用服务器的地址
如果服务商提供同一私有网络,优先让应用服务器通过数据库服务器的内网地址连接。先在数据库服务器上查看网卡地址:
ip -br addr
在应用服务器上查看到数据库服务器的路由:
ip route get 10.20.0.10
需要确认:
10.20.0.10是数据库服务器实际配置在网卡上的地址。若服务商通过公网地址做 NAT 映射,公网映射地址未必能直接填入 PostgreSQL 的listen_addresses。- 数据库实际接收到的客户端源地址是固定的。若经 NAT 或服务商网络出口访问,请向网络管理员或服务商确认出口地址。
- 若应用服务器有多个出口地址,应分别确认应用请求会使用哪个地址。不要仅凭配置文件中写的地址推断数据库实际看到的来源。
- 如果只有公网网络,防火墙规则应使用应用服务器的固定公网出口 IP;一个地址使用
/32。若使用 IPv6,应另行配置精确的 IPv6 来源地址,通常使用/128。
本例不依赖日本地区的特殊 PostgreSQL 配置。服务器所在地区影响网络路径和可用地址,不改变 PostgreSQL 按客户端地址匹配访问规则的方式。
A5idc数据提供日本地区物理服务器,覆盖Xeon Gold、AMD EPYC等平台,并配备SSD或NVMe存储,可为PostgreSQL数据库、应用后台及接口服务提供相应的计算与存储资源。针对日本本地访问和跨境业务,产品还提供CIA、GIA、CN2、SoftBank等线路选项及不同带宽配置,便于结合业务访问范围搭建数据库与应用服务器。
明确访问范围
示例只允许应用服务器 10.20.0.21 使用数据库角色 app_user 连接 appdb。本机通过 Unix 域套接字进行管理的方式仍可保留。若还有其他应用服务器,逐台添加各自的固定来源地址和必要规则;不要为省事开放整个网段或所有公网来源。
如需通过公网连接数据库,还应配置可信的 TLS 证书,并让客户端验证证书身份。下文的 host 规则用于说明 IP 和数据库身份限制,本身不强制 TLS。
安装 PostgreSQL
在数据库服务器上更新软件包索引并安装 PostgreSQL 服务端和客户端工具:
sudo apt update
sudo apt install -y postgresql postgresql-client
sudo systemctl enable --now postgresql
查看服务和集群状态:
sudo systemctl status postgresql --no-pager
pg_lsclusters
预期能看到处于 online 状态的集群。Ubuntu 软件包通常通过 postgresql-common 管理集群,具体 PostgreSQL 主版本和配置目录应以本机输出为准,不要直接假设目录中一定是某个固定版本号。
查询当前集群使用的配置文件路径:
sudo -u postgres psql -Atc "SHOW config_file;"
sudo -u postgres psql -Atc "SHOW hba_file;"
如果服务没有启动,先查看安装与服务错误,再继续配置:
sudo journalctl -u postgresql --since "15 minutes ago" --no-pager
配置数据库访问
备份配置文件
取得配置路径并保存原文件。以下命令在当前 Shell 中运行,备份名带有时间戳:
CONF=$(sudo -u postgres psql -Atc "SHOW config_file;")
HBA=$(sudo -u postgres psql -Atc "SHOW hba_file;")
STAMP=$(date +%Y%m%d-%H%M%S)
sudo cp -a "$CONF" "$CONF.$STAMP.bak"
sudo cp -a "$HBA" "$HBA.$STAMP.bak"
printf '配置文件:%s\n访问规则:%s\n备份时间:%s\n' "$CONF" "$HBA" "$STAMP"
确认命令输出的路径和备份文件无误后再编辑。备份文件应保留到验收结束;修改 PostgreSQL 配置或防火墙规则前,也应确认当前有本机控制台或其他管理入口,避免远程操作时失去连接。
设置监听地址和密码加密方式
编辑 postgresql.conf:
sudoedit "$CONF"
找到对应配置项,修改或添加为:
listen_addresses = '10.20.0.10,127.0.0.1'
password_encryption = 'scram-sha-256'
listen_addresses 填数据库服务器实际拥有的网卡地址,不是应用服务器地址。如果数据库服务需要监听多个网卡,可用逗号分隔;不需要的接口不要加入。避免将监听地址改为 '*',除非确实需要监听所有接口,并已逐一确认防火墙和访问规则。
password_encryption 用于设置新密码的存储方式。本文示例使用 SCRAM;较旧的数据库驱动可能不支持 SCRAM,应更新驱动,而不是为了兼容而扩大网络访问范围。
创建专用数据库和角色
先配置网络边界,再通过数据库服务器本机的 PostgreSQL 管理账号创建应用角色和数据库。进入交互终端:
sudo -u postgres psql
在 psql 中执行:
SHOW password_encryption;
CREATE ROLE app_user LOGIN;
随后为角色交互式设置密码:
\password app_user
根据提示输入密码。不要把真实密码写进文章、Shell 历史记录、源代码仓库或应用配置示例中。完成后创建数据库:
CREATE DATABASE appdb OWNER app_user;
确认应用角色没有被授予数据库超级用户等管理权限:
\du app_user
\l+ appdb
退出:
\q
此角色仅用于应用连接,不应使用 postgres 管理账号,也不应额外授予 SUPERUSER、CREATEDB 或 CREATEROLE 权限。
配置 pg_hba.conf
在编辑之前检查现有规则:
sudoedit "$HBA"
pg_hba.conf 按从上到下的顺序匹配,首条匹配规则生效。保留已有的 local 行,以便本机通过 Unix 域套接字管理;将下面的网络规则放在适当位置,确保应用服务器允许规则位于拒绝规则之前:
# 指定应用服务器仅以指定角色连接指定数据库
host appdb app_user 10.20.0.21/32 scram-sha-256
# 保留本机 TCP 访问(如不需要,可不添加)
host all all 127.0.0.1/32 scram-sha-256
host all all ::1/128 scram-sha-256
# 拒绝其他 IPv4 和 IPv6 TCP 来源
host all all 0.0.0.0/0 reject
host all all ::/0 reject
将 10.20.0.21/32 替换为数据库实际看到的应用服务器源地址。如果应用服务器使用 IPv6,应在拒绝规则之前增加该服务器的精确 IPv6 允许规则,例如:
host appdb app_user 2001:db8::21/128 scram-sha-256
2001:db8::21 是文档示例地址,不能直接当作真实地址使用。若现有文件中已经有允许任意来源的规则,例如针对 0.0.0.0/0 或 ::/0 的宽泛允许规则,应检查并删除或调整,不能让它出现在应用服务器拒绝规则之前。保留本机 TCP 规则意味着本机仍可能通过回环地址连接;如果只允许本机套接字管理,可去掉回环地址规则。
保存文件后,用数据库提供的视图检查规则解析错误:
sudo -u postgres psql -c "
SELECT line_number, type, database, user_name, address, auth_method, error
FROM pg_hba_file_rules
WHERE error IS NOT NULL;
"
查询没有返回错误行才表示文件语法通过检查。它不代表客户端已经能连通,也不代表规则顺序符合预期;仍需检查实际规则顺序并进行连接测试。
在监听端口前限制防火墙
在 PostgreSQL 监听远程网卡之前,先配置云平台安全组或服务商防火墙:
- 仅允许 TCP
5432的入站流量,来源填写应用服务器的固定地址,例如10.20.0.21/32。 - 确认其他来源没有更宽泛的
5432放行规则。 - 如果数据库通过公网提供服务,放行来源应是应用实际访问时使用的公网出口地址,而不是随意填写应用服务器的私网地址。
- IPv6 入站规则需单独检查;只配置 IPv4 不代表 IPv6 已受限制。
如果服务器使用 UFW,先查看现有状态和规则:
sudo ufw status verbose
sudo ufw status numbered
在 UFW 已启用且入站策略为默认拒绝的前提下,可添加应用服务器到数据库监听地址的规则:
sudo ufw allow from 10.20.0.21 to 10.20.0.10 port 5432 proto tcp
随后再次查看规则,确认没有面向所有来源开放 5432/tcp 的规则。如果 UFW 当前未启用,或入站默认策略为允许,不要只添加一条来源允许规则就认定其余来源已被阻挡;应先核对完整规则策略。启用防火墙或修改默认策略可能影响 SSH 等现有服务,远程操作前应确认 SSH 已有明确的允许规则,并准备好控制台回退方式。
应用监听和访问规则
先确保云平台和主机防火墙已经按指定来源限制入站,再重启 PostgreSQL,使 listen_addresses 生效:
sudo systemctl restart postgresql
sudo systemctl status postgresql --no-pager
pg_lsclusters
listen_addresses 的修改需要重启服务;pg_hba.conf 修改通常只需重新加载。可在本机执行以下命令重新加载访问规则:
sudo -u postgres psql -c "SELECT pg_reload_conf();"
预期结果为 t。重新检查 HBA 规则解析错误,并确认实际监听地址:
sudo -u postgres psql -c "SHOW listen_addresses;"
sudo -u postgres psql -c "SHOW port;"
sudo ss -lntp | grep ':5432'
监听结果应包含预期的数据库网卡地址和本机回环地址,不应意外监听未计划开放的网卡。若服务重启后状态不是 online,先修复配置错误,不要继续开放防火墙。
从应用服务器验证连接
验证指定应用服务器可连接
在应用服务器上连接数据库。使用交互式密码提示,避免把密码直接写进命令行:
psql -h 10.20.0.10 -p 5432 -U app_user -d appdb -W \
-c "SELECT inet_client_addr(), inet_server_addr(), current_user, current_database();"
成功时,查询应显示当前数据库为 appdb、用户为 app_user,客户端地址应与数据库实际看到的应用来源相符。也可以先检查 TCP 端口是否可达:
nc -vz -w 3 10.20.0.10 5432
nc 连接成功只说明 TCP 端口可达,不能证明数据库认证和授权正确;仍要以 psql 的登录结果为准。
若已配置受信任的服务器证书,生产应用连接串应使用能验证证书主机名的 sslmode=verify-full,并指定正确的 CA 证书。此时可将应用服务器允许行从 host 改为 hostssl,只允许加密连接;数据库证书中的名称必须与客户端连接时使用的主机名匹配。不要把 sslmode=require 误当成完整的服务器身份验证。
验证其他来源被拒绝
从一个不在允许列表中的测试主机尝试访问同一数据库地址。应使用能到达数据库网络的测试环境;只在本机或应用服务器上测试,不能证明其他来源已经被阻挡。

如果防火墙已阻断,TCP 测试通常会超时或被拒绝。如果 TCP 能建立,但 PostgreSQL 返回 no pg_hba.conf entry,说明连接已经到达数据库,但没有匹配的访问规则。无论哪种情况,未授权来源都不应能成功登录。测试时不要使用生产账号密码反复尝试,以免触发账号或监控告警。
常见异常处理
- 连接超时:先核对应用的路由、数据库目标地址、云安全组和主机防火墙,再检查数据库监听地址。超时通常说明网络路径被丢弃或不可达,但单凭超时不能判断具体是哪一层阻挡。
- 连接被拒绝:检查 PostgreSQL 是否运行、目标地址是否正在监听
5432,以及防火墙是否采用拒绝而非丢弃策略。可查看pg_lsclusters和ss -lntp。 - 提示没有匹配的
pg_hba.conf记录:核对数据库看到的客户端源地址、数据库名、用户名、IPv4/IPv6 类型及 HBA 规则顺序。若前面有更宽泛的匹配规则,也要检查是否造成意外放行。 - 密码认证失败:核对应用使用的角色、数据库和密码;确认应用没有连接到另一台服务器或另一套 PostgreSQL 集群。不要通过改成
trust或开放任意来源来绕过认证问题。 - SCRAM 认证失败或驱动不兼容:确认应用使用的 PostgreSQL 驱动支持 SCRAM,并检查所用驱动版本。优先升级驱动;不要为了旧客户端而把网络规则改宽。
- 配置修改后服务无法启动:检查配置文件拼写、地址是否实际配置在服务器网卡上,以及 HBA 规则语法。可查看服务日志:
sudo journalctl -u postgresql --since "15 minutes ago" --no-pager
确认 PostgreSQL 的配置文件路径后,也可以检查 pg_hba_file_rules 的错误列。修复配置前不要反复重启服务或临时放宽防火墙。
验收结果
部署完成后,至少确认以下项目:
- PostgreSQL 集群处于
online状态,服务监听的是计划使用的数据库地址和端口。 pg_hba_file_rules没有解析错误;应用服务器的允许规则只匹配指定数据库、角色和客户端地址。- 云平台防火墙及主机防火墙没有对所有来源开放
5432。 - 指定应用服务器可以用
app_user连接appdb并执行只读验证查询。 - 不在允许列表中的测试来源不能成功登录;如能建立 TCP 连接,应确认数据库最终拒绝其认证。
app_user没有超级用户、创建角色或创建数据库等不必要权限。- 配置备份、服务商防火墙变更记录和实际使用的应用出口地址已留存,供后续检查或回退。
回滚
回滚前确认应用是否已经依赖 appdb 或其中的数据。删除数据库或角色可能造成数据不可恢复;默认回滚配置和网络规则,不自动删除数据库对象。
- 如果需要立即停止远程访问,先在云平台防火墙删除本次添加的
5432来源允许规则;UFW 则先查看编号,再删除本次新增的精确规则。不要删除其他服务共用的规则。 - 使用备份文件恢复
postgresql.conf和pg_hba.conf。将下面的路径替换为前面记录的实际文件路径及时间戳:
sudo cp -a /etc/postgresql/<版本>/main/postgresql.conf.<时间戳>.bak \
/etc/postgresql/<版本>/main/postgresql.conf
sudo cp -a /etc/postgresql/<版本>/main/pg_hba.conf.<时间戳>.bak \
/etc/postgresql/<版本>/main/pg_hba.conf
如果配置文件不在示例目录,以 SHOW config_file; 和 SHOW hba_file; 的输出为准。
- 重启服务并确认集群恢复正常:
sudo systemctl restart postgresql
pg_lsclusters
sudo systemctl status postgresql --no-pager
- 从本机验证管理方式和应用所需的连接。如果决定卸载 PostgreSQL 或删除
appdb,应先确认备份可恢复、数据不再需要,并取得明确操作批准;不要把删除数据作为常规回滚步骤。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/9500.html



