香港服务器部署PostgreSQL后,如何设置服务启动与远程访问
在香港服务器上部署 PostgreSQL,除了让数据库进程运行,还要确保重启后能够自动启动,并且只允许授权来源远程连接。以下以 Debian 12、Ubuntu 22.04/24.04 的 APT 安装方式为例,说明首次配置流程。不同发行版或自行编译安装的配置路径、服务单元可能不同,操作前应先核实实际环境。
示例中的 203.0.113.25 是文档示例地址,不是可直接使用的客户端地址;请替换为实际需要连接的客户端公网 IP。生产环境不建议将 PostgreSQL 的 5432 端口对所有来源开放。
准备条件
开始前确认:
- 服务器已安装 Debian 或 Ubuntu,拥有
sudo权限。 - 已确认服务器的公网或内网 IP,以及客户端连接服务器时使用的出口 IP。
- 如使用云平台安全组或网络防火墙,已能管理入站规则。云平台防火墙与服务器内的防火墙是两层独立控制。
- 已有 SSH 管理通道。调整服务器防火墙前,应先确认 SSH 端口已放行,避免中断远程管理。
- 已准备数据库名称、应用角色名称及密码。应用账号应使用专用的非超级用户角色,不要让应用直接以
postgres超级用户身份连接。
查看系统版本与 PostgreSQL 是否已经安装:
cat /etc/os-release
psql --version
如果 psql 提示找不到命令,通常表示客户端工具尚未安装;如果已经安装 PostgreSQL,应先检查是否存在正在使用的数据库集群,避免重复创建或误改已有配置:
sudo pg_lsclusters
sudo systemctl status postgresql --no-pager
在 Debian/Ubuntu 的打包安装中,postgresql 通常是管理集群的服务入口,实际集群可能使用带版本号的服务单元。不要仅凭版本号猜测配置目录或服务名,以实际查询结果为准。
围绕香港服务器上的 PostgreSQL 部署,A5idc数据提供涵盖 Xeon Gold、AMD EPYC 等平台的香港物理服务器,搭配不同内存档位及 SSD、NVMe 存储,可为业务后台、接口服务和数据库运行提供资源基础。香港产品还提供 CN2 与国际带宽线路选择,能够对应不同访问地区的网络需求。
安装并确认服务状态
若服务器尚未安装 PostgreSQL,可通过系统软件包安装:
sudo apt update
sudo apt install postgresql postgresql-client
安装后检查服务与集群:
sudo systemctl status postgresql --no-pager
sudo pg_lsclusters
systemctl status 中出现 active (exited) 不一定代表数据库未运行:在部分 Debian/Ubuntu 打包方式中,postgresql 是管理多个集群的服务入口。应结合 pg_lsclusters 查看集群状态;状态为 online 通常表示对应集群正在运行。
如服务未启动,先查看错误信息,再尝试启动:
sudo systemctl start postgresql
sudo systemctl status postgresql --no-pager
sudo pg_lsclusters
确认启动后,再设置开机自动启动:
sudo systemctl enable postgresql
sudo systemctl is-enabled postgresql
预期结果为 enabled。如果 systemctl 提示找不到服务,或 pg_lsclusters 没有列出集群,不要直接创建新的服务配置;先检查安装包、集群列表和安装方式:
dpkg -l 'postgresql*' | grep '^ii'
systemctl list-unit-files | grep -i postgres
创建专用数据库角色
先通过本机管理账户进入 PostgreSQL。Debian/Ubuntu 软件包通常配置为使用操作系统账户 postgres 进行本地管理:
sudo -u postgres psql
在 psql 中创建专用角色和数据库。角色名、数据库名可按实际项目调整:
CREATE ROLE app_user LOGIN;
CREATE DATABASE app_db OWNER app_user;
使用交互命令设置角色密码,避免将密码直接写入 shell 命令或 SQL 脚本:
\password app_user
按提示输入并确认密码。然后退出:
\q
若创建角色时报告同名对象已经存在,应先确认对象归属和用途,不要为了消除报错直接删除或覆盖。可在 psql 中查询角色和数据库:
\du
\l
应用账号只应拥有应用所需的数据库权限。若数据库已存在且不属于该角色,需由管理员评估后再调整权限;不要为图方便授予 SUPERUSER。
配置监听地址与访问规则
PostgreSQL 默认可能只监听本机回环地址。远程访问需要同时满足三个条件:服务监听可达的地址、访问控制规则允许客户端来源、防火墙放行对应流量。只调整其中一项通常不足以建立连接。

先查询当前集群实际使用的配置文件路径:
sudo -u postgres psql -Atc "SHOW config_file;"
sudo -u postgres psql -Atc "SHOW hba_file;"
记录输出路径,并备份这两个文件。下面的命令会在文件所在目录生成带时间戳的副本:
CONFIG_FILE=$(sudo -u postgres psql -Atc "SHOW config_file;")
HBA_FILE=$(sudo -u postgres psql -Atc "SHOW hba_file;")
sudo cp -a "$CONFIG_FILE" "$CONFIG_FILE.bak.$(date +%Y%m%d%H%M%S)"
sudo cp -a "$HBA_FILE" "$HBA_FILE.bak.$(date +%Y%m%d%H%M%S)"
设置监听地址
编辑 SHOW config_file 返回的文件:
sudo nano "$(sudo -u postgres psql -Atc 'SHOW config_file;')"
找到 listen_addresses 配置项。优先填写服务器实际用于接收客户端连接的内网或指定网卡地址;只有确有需要时才使用 '*' 监听所有本机网络接口。例如:
listen_addresses = '服务器内网地址'
port = 5432
如果服务器没有适合客户端使用的内网地址,且确实需要通过公网 IP 连接,可设置:
listen_addresses = '*'
port = 5432
'*' 只表示 PostgreSQL 在本机所有可用网络接口上监听,并不等于自动允许所有客户端登录;访问仍受 pg_hba.conf 和防火墙控制。但它会扩大服务的网络暴露面,因此应与严格的来源 IP 限制配合使用。
设置客户端访问规则
编辑 SHOW hba_file 返回的文件:
sudo nano "$(sudo -u postgres psql -Atc 'SHOW hba_file;')"
在文件中添加仅允许指定数据库、角色和客户端地址的规则。以下示例使用密码认证:
host app_db app_user 203.0.113.25/32 scram-sha-256
将示例地址替换为实际客户端公网 IP。/32 表示仅匹配这一个 IPv4 地址;如果客户端通过 IPv6 出口访问,应使用对应 IPv6 地址和前缀,例如单地址使用 /128。规则应放在可能匹配同一连接的宽泛规则之前,因为 pg_hba.conf 按顺序匹配,命中首条适用规则后不会继续尝试后面的规则。
也可以先在本机查询当前密码加密设置:
sudo -u postgres psql -Atc "SHOW password_encryption;"
对于新建角色,常见设置为 scram-sha-256。修改密码加密设置不会自动把已有角色密码转换为新格式;如需变更已有角色的密码,应通过 \password 重新设置,并确认客户端驱动支持该认证方式。
保存配置后,监听地址变更需要重启 PostgreSQL 才会生效;pg_hba.conf 的变更通常可以通过重载生效:
sudo systemctl restart postgresql
sudo systemctl status postgresql --no-pager
sudo -u postgres psql -Atc "SHOW listen_addresses;"
若只修改了访问规则,可重载配置:
sudo systemctl reload postgresql
检查规则是否存在语法错误:
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。若使用 UFW,可以添加限定来源的规则:
sudo ufw allow from 203.0.113.25 to any port 5432 proto tcp
sudo ufw status numbered
操作前确认 UFW 状态,并核对 SSH 入站规则。不要在未确认 SSH 已放行的情况下启用或重置防火墙。若还要在云平台控制台设置安全组规则,应在云侧也限定客户端来源,不要只依赖服务器内的 UFW。
远程数据库连接会传输账号凭据和业务数据,生产环境应配置 TLS。服务器证书应与客户端连接时使用的 DNS 名称匹配,并由客户端信任的 CA 签发或纳入信任链。证书及私钥路径取决于证书签发方式和系统;不要直接照搬其他服务器的路径。确认 PostgreSQL 用户可以读取证书,且私钥权限足够严格,再在实际配置文件中设置:
ssl = on
ssl_cert_file = '/实际路径/server.crt'
ssl_key_file = '/实际路径/server.key'
确认服务已能使用证书后,可将 pg_hba.conf 中对应规则改为 hostssl,要求该规则只接受 TLS 连接:
hostssl app_db app_user 203.0.113.25/32 scram-sha-256
客户端连接时使用证书校验模式,并以证书中的 DNS 名称连接,例如:
psql "host=db.example.com port=5432 dbname=app_db user=app_user sslmode=verify-full sslrootcert=/实际路径/ca.crt"
verify-full 会校验证书链和主机名。若证书不包含客户端使用的主机名,连接会失败;应修正证书或使用与证书匹配的名称,而不是在生产环境中关闭验证来规避问题。若暂时尚未配置 TLS,不要把数据库端口开放给任意公网来源。
逐层验证远程连接
先在服务器本机确认 PostgreSQL 正在监听预期端口:
sudo ss -lntp | grep ':5432'
若没有输出,可能是服务未启动、监听地址配置错误,或重启未成功。若只看到 127.0.0.1:5432,说明远程网卡上尚未监听。
再检查数据库是否就绪:
sudo -u postgres pg_isready
返回 accepting connections 表示服务器本机的 PostgreSQL 已接受连接请求,但不代表公网防火墙、客户端访问规则或 TLS 都正确。
在客户端安装 PostgreSQL 客户端工具后进行连接测试。已配置 TLS 时,使用与证书相匹配的主机名和验证模式:
psql "host=db.example.com port=5432 dbname=app_db user=app_user sslmode=verify-full sslrootcert=/实际路径/ca.crt"
连接成功后执行:
SELECT current_database(), current_user, inet_server_addr(), inet_server_port();
\conninfo
预期结果应显示目标数据库、应用角色和服务器地址;\conninfo 可用于确认当前连接的主机、端口及连接方式。测试完毕后退出:
\q
如果暂时没有可用的 DNS 名称或 CA 证书,应先在受控网络中验证基础连通性,再补齐证书和客户端验证配置;不要将未验证证书的明文或弱校验连接作为公网生产方案。
常见失败处理
按由外到内的顺序检查,避免一开始就扩大数据库授权范围:
| 现象 | 优先检查 | 结果通常意味着 |
|---|---|---|
| 客户端连接超时 | 云平台安全组、服务器防火墙、服务器 IP 与端口 | 流量未到达数据库,或中间网络未放行 |
| 连接被拒绝 | ss -lntp、listen_addresses、服务状态 | 目标地址或端口没有 PostgreSQL 监听 |
报 no pg_hba.conf entry | 客户端实际出口 IP、数据库名、角色名、规则顺序 | 请求到达 PostgreSQL,但没有匹配的访问规则 |
| 报密码认证失败 | 角色名、密码、认证方式及客户端驱动 | 请求匹配了认证规则,但身份验证未通过 |
| 报 SSL 或证书校验错误 | 证书链、有效期、主机名、客户端 CA 路径 | TLS 建立或证书验证未通过 |
| 修改后服务无法启动 | 服务状态和 PostgreSQL 日志 | 配置语法、证书路径或文件权限可能有误 |
查看服务与数据库日志:
sudo systemctl status postgresql --no-pager
sudo journalctl -u postgresql -n 100 --no-pager
sudo tail -n 100 /var/log/postgresql/postgresql-*-main.log
日志文件路径会随发行版和集群配置变化;如果最后一条命令没有匹配到文件,先检查日志目录和系统日志,不要据此判断数据库没有记录日志。配置修改后若服务无法启动,优先恢复最近一次有效配置,并核对报错行、证书文件权限和路径。
结果检查与回滚
部署完成后,逐项确认:
systemctl is-enabled postgresql返回enabled,服务器重启后服务可自动启动。pg_lsclusters显示目标集群为online,且pg_isready显示正在接受连接。ss -lntp显示的监听地址和端口符合预期,没有意外监听不需要的接口。pg_hba.conf只允许所需数据库、角色和客户端来源;云平台防火墙与服务器防火墙均已核对。- 客户端能够使用应用角色连接目标数据库;如启用 TLS,客户端连接验证成功且确认了证书主机名。
- 服务日志中没有启动失败、证书读取错误或反复认证失败等未处理问题。
如果修改配置后服务异常,可使用前面备份的文件恢复。先列出备份并确认要恢复的时间点,再替换配置;恢复操作会覆盖当前配置文件,操作前应保留当前副本:
ls -l "$CONFIG_FILE".bak.*
ls -l "$HBA_FILE".bak.*
确认文件名无误后执行恢复,再检查配置和服务状态:
sudo cp -a "$CONFIG_FILE" "$CONFIG_FILE.failed.$(date +%Y%m%d%H%M%S)"
sudo cp -a "$HBA_FILE" "$HBA_FILE.failed.$(date +%Y%m%d%H%M%S)"
sudo cp -a "$CONFIG_FILE.bak.实际时间戳" "$CONFIG_FILE"
sudo cp -a "$HBA_FILE.bak.实际时间戳" "$HBA_FILE"
sudo systemctl restart postgresql
sudo systemctl status postgresql --no-pager
sudo pg_isready
若问题仅是新加的防火墙规则造成的,可用 sudo ufw status numbered 确认规则编号,再按当前 UFW 规则删除对应项;删除前核对规则确实是本次新增的远程数据库规则。云平台安全组也应同步撤销对应入站规则。
回滚配置或关闭远程入口,不等于删除数据库。不要为了恢复服务而直接删除数据库、角色或数据目录;涉及数据库对象变更时,应先核对备份及恢复条件。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/6763.html



