韩国服务器如何安装并运行PostgreSQL 16?

发布人:A5数据发布时间:2026-11-13 13:55阅读量:38

本文以 Ubuntu 22.04/24.04 或 Debian 12 的韩国 Linux 服务器为例,说明如何安装 PostgreSQL 16、创建可用的数据库与账号,并验证本机连接。服务器所在地不改变主要安装步骤;实际能否从其他机器连接,还取决于服务器防火墙、云平台网络规则和 PostgreSQL 访问配置。

操作前需要具备具有 sudo 权限的系统账号、可用的包管理器和稳定的软件下载网络。以下使用 PostgreSQL 官方软件源(PGDG),以便在系统默认仓库版本不是 16 时安装指定版本。命令示例面向 Debian 系发行版,不适用于 Rocky Linux、AlmaLinux 等 RPM 系统。

PostgreSQL 16可作为业务数据库运行在韩国本地服务器上。A5idc数据提供韩国首尔物理服务器方案,涵盖不同的CPU、存储与网络配置,可为数据库服务及相关业务应用提供部署资源;多地区服务器资源也便于围绕业务访问区域规划服务部署。

准备条件

先确认系统发行版、版本代号、磁盘空间和当前用户权限:

cat /etc/os-release
df -h /
id
sudo -v

输出中的 ID 应为 ubuntu 或 debian,VERSION_CODENAME 应能识别为相应版本代号,例如 Ubuntu 22.04 的 jammy、Ubuntu 24.04 的 noble、Debian 12 的 bookworm。若代号为空或系统不属于上述范围,先核实该发行版是否受 PostgreSQL 16 软件源支持,不要直接套用后续命令。

确认服务器可以访问软件源:

sudo apt-get update

若更新失败,先检查 DNS、出站网络、系统时间及软件源配置。韩国机房与其他地区一样,访问速度会受线路和软件源连通性影响;不建议在更新尚未成功时继续安装。

部署前还应确认:

  • 计划使用本机连接,还是需要从应用服务器远程连接。首次安装建议先完成本机验证,再单独开放远程访问。
  • 服务器有足够的可用磁盘空间。数据库文件、日志和后续备份都会占用空间,具体用量取决于数据规模和写入量。
  • 如果机器上已经有 PostgreSQL 集群或业务数据,先检查现有服务、数据目录和备份情况。以下配置路径适用于 Debian 系软件包创建的 PostgreSQL 16 默认集群,不应直接覆盖已有配置。

安装 PostgreSQL 16

添加 PGDG 软件源

安装添加软件源所需的基础工具,并将 PostgreSQL 软件源的签名密钥存入专用目录:

sudo apt-get install -y ca-certificates curl
sudo install -d /usr/share/postgresql-common/pgdg
sudo curl -fsSL \
  -o /usr/share/postgresql-common/pgdg/apt.postgresql.org.asc \
  https://www.postgresql.org/media/keys/ACCC4CF8.asc

通过系统代号写入软件源配置:

. /etc/os-release
echo "deb [signed-by=/usr/share/postgresql-common/pgdg/apt.postgresql.org.asc] https://apt.postgresql.org/pub/repos/apt ${VERSION_CODENAME}-pgdg main" \
  | sudo tee /etc/apt/sources.list.d/pgdg.list

更新软件包索引,并确认仓库能提供 16 版本:

sudo apt-get update
apt-cache policy postgresql-16

检查结果中应能看到 postgresql-16 的候选版本。如果没有候选版本,先确认系统代号是否正确、PGDG 源是否成功更新,再检查网络或仓库访问状态,不要改装成系统默认的其他主版本来替代。

安装并检查集群

安装 PostgreSQL 16 服务器和客户端:

sudo apt-get install -y postgresql-16 postgresql-client-16

Debian 系软件包通常会创建名为 16/main 的默认集群并启动服务。检查安装版本、集群状态和服务状态:

psql --version
sudo pg_lsclusters
sudo systemctl status postgresql --no-pager

应看到客户端版本为 16,pg_lsclusters 中的 16 main 状态为 online,服务状态为 active。版本字符串中的次版本号会随软件源更新而变化;这里要确认的是主版本为 16。

如果服务没有运行,可先尝试启动并查看错误信息:

sudo systemctl start postgresql
sudo systemctl status postgresql --no-pager
sudo journalctl -u postgresql -n 80 --no-pager

若集群状态是 down,也可以针对集群启动:

sudo pg_ctlcluster 16 main start
sudo pg_lsclusters

如果启动失败,不要删除数据目录或重新初始化集群。先查看日志,并检查磁盘空间、配置文件语法及端口占用。

首次配置并创建数据库

验证本机管理员连接

Debian 系安装会创建系统用户 postgres 和数据库角色 postgres。使用系统用户切换身份后连接数据库:

sudo -u postgres psql

在提示符下执行:

SELECT version();
SHOW data_directory;
SHOW config_file;
SHOW hba_file;
\q

查询结果应显示 PostgreSQL 16,并给出实际数据目录和配置文件路径。默认配置通常位于 /etc/postgresql/16/main/,但以查询结果为准。

创建业务账号和数据库

不要让应用直接使用数据库管理员角色 postgres。以下示例创建一个只用于应用的登录角色和数据库。先进入交互式管理终端:

sudo -u postgres psql

创建账号时不在命令历史中写入明文密码,再按提示输入并确认密码:

CREATE ROLE app_user LOGIN;
\password app_user

设置完成后,创建由该账号拥有的数据库:

CREATE DATABASE app_db OWNER app_user ENCODING 'UTF8';
\q

app_user 和 app_db 是示例名称,实际部署时可替换为符合业务命名规范的名称。密码应使用独立、足够长的随机值,并通过安全的密码管理方式保存;不要将密码直接写入脚本、命令行参数或公开的配置文件。

用新账号测试本机 TCP 连接:

psql -h 127.0.0.1 -U app_user -d app_db

按提示输入密码。连接成功后执行:

SELECT current_database(), current_user;
CREATE TABLE install_check (
    id integer PRIMARY KEY,
    note text
);
INSERT INTO install_check (id, note) VALUES (1, 'PostgreSQL 16 is ready');
SELECT * FROM install_check;
\q

结果应显示当前数据库为 app_db、当前用户为 app_user,并返回刚写入的一行数据。该表仅用于安装验证;确认完成后可在管理连接中删除:

DROP TABLE install_check;

只在确认该表是本次验证创建、且其中没有需要保留的数据时执行删除。

按需开放远程连接

若应用与数据库部署在同一台服务器,通常不需要开放公网数据库端口,保持仅本机连接更简单,也能减少暴露面。确实需要由其他服务器连接时,至少要同时配置 PostgreSQL 监听地址、客户端访问规则和服务器网络防火墙;只完成其中一项仍可能无法连接。

先确认主配置路径:

sudo -u postgres psql -Atc "SHOW config_file;"
sudo -u postgres psql -Atc "SHOW hba_file;"

在对应的 postgresql.conf 中,将监听地址设置为服务器的内网地址,或在确认网络隔离和访问控制后使用 *。例如:

listen_addresses = '服务器内网IP'

不要把示例中的文字原样写入配置;需替换成服务器实际内网 IP。随后在 pg_hba.conf 中为应用服务器的固定来源地址添加规则,例如:

host    app_db    app_user    203.0.113.24/32    scram-sha-256

203.0.113.24/32 是文档示例地址,必须替换为应用服务器实际出口或内网地址。规则限制了数据库、账号和来源网段;不要为了省事使用对所有来源开放的 0.0.0.0/0。配置前备份对应文件,并避免覆盖现有规则:

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

路径应以 SHOW config_file 和 SHOW hba_file 的结果为准。编辑完成后重载配置,并检查服务状态:

sudo systemctl reload postgresql
sudo systemctl status postgresql --no-pager

修改 listen_addresses 通常需要重启才会生效,重启可能中断现有连接。首次部署且尚未承载业务时,可执行:

sudo systemctl restart postgresql
sudo systemctl status postgresql --no-pager

同时,只在服务器防火墙及云平台安全规则中允许应用服务器来源访问 TCP 5432。若使用 UFW,规则可按实际来源地址限制:

sudo ufw allow from 203.0.113.24 to any port 5432 proto tcp
sudo ufw status numbered

该命令会修改防火墙规则,执行前先确认当前 SSH 管理规则仍允许你的管理地址访问,避免误改造成远程失联。若服务器使用其他防火墙或云安全组,应在对应管理面配置同样严格的来源范围,而不是重复开放整个公网。

远程连接测试应在应用服务器上进行:

psql -h 数据库服务器内网IP -p 5432 -U app_user -d app_db

成功后可执行 SELECT current_database(), current_user;。若本机连接正常而远程连接失败,按网络连通性、监听地址、访问规则和账号密码的顺序检查,不要先扩大授权网段。

按需开放远程连接配图

常见失败处理

软件源更新或安装失败

若 apt-get update 报 DNS 解析、连接超时或 TLS 错误,检查服务器 DNS 和出站网络,并确认系统时间正确。若提示没有 postgresql-16 候选版本,查看 /etc/os-release 中的版本代号及 /etc/apt/sources.list.d/pgdg.list 内容,再重新运行 sudo apt-get update。不要把不匹配的发行版代号硬填进软件源配置。

服务启动失败或端口已占用

查看集群状态、日志和监听端口:

sudo pg_lsclusters
sudo journalctl -u postgresql -n 100 --no-pager
sudo ss -lntp | grep ':5432'

端口已被其他进程占用时,应先确认占用者和现有服务用途。不要直接终止未知进程,也不要在未核对客户端配置前随意更改 PostgreSQL 端口。若日志指出配置语法错误,恢复最近一次正确配置后再启动。

本机认证失败

本机通过 sudo -u postgres psql 成功、但账号连接失败时,确认连接的数据库名、角色名和密码是否一致:

sudo -u postgres psql -c "\du"
sudo -u postgres psql -c "\l"

若显示 password authentication failed,可通过管理员会话重设密码:

sudo -u postgres psql
\password app_user
\q

若提示没有匹配的 pg_hba.conf 规则,应先确认实际使用的规则文件及连接方式,再添加范围受限的规则。不要通过改成无密码认证来绕过问题。

远程连接超时或被拒绝

  • 超时:优先检查云安全规则、系统防火墙、路由和目标 IP/端口是否正确。
  • 连接被拒绝:检查 PostgreSQL 服务是否运行、是否监听目标地址,以及 TCP 5432 是否在监听。
  • 提示没有匹配的访问规则:检查 pg_hba.conf 中数据库、角色、来源网段和认证方式是否匹配。
  • 密码认证失败:检查用户名、密码以及客户端连接到的是否为预期数据库实例。

这几类结果对应不同层面的问题。先从客户端到服务器的网络连通性开始验证,再检查服务监听和数据库认证配置。

结果检查与回滚

验收检查项

首次安装完成后,可逐项核对:

  • psql --version 显示 PostgreSQL 16。
  • sudo pg_lsclusters 中 16 main 为 online,systemctl status postgresql 显示服务运行。
  • sudo -u postgres psql 可以连接并查询版本。
  • app_user 能连接 app_db,且能在该数据库中执行经授权的操作。
  • 如果启用了远程访问,仅指定来源地址能连接;未授权来源不会因开放宽泛网段而获得访问机会。
  • 应用所需的账号、数据库名、连接地址和密码已按安全方式保存,且没有将管理员账号用作应用常规连接账号。

回滚前保留数据

回滚前先判断数据库中是否已有需要保留的数据。若要留存业务库,可在 PostgreSQL 服务正常时导出单个数据库:

sudo -u postgres pg_dump -Fc app_db \
  -f /安全备份路径/app_db_before_rollback.dump

若需要导出全部数据库及全局对象,可使用:

sudo -u postgres pg_dumpall \
  -f /安全备份路径/postgresql_all_before_rollback.sql

备份文件应存放在数据库数据目录之外,并确认文件存在、权限合适且磁盘空间足够。恢复前应先确认备份可读;单库归档可用以下命令检查目录清单:

pg_restore -l /安全备份路径/app_db_before_rollback.dump

停止服务或撤销配置

仅需临时停止服务时:

sudo systemctl stop postgresql

若已启用远程访问并准备撤销,应先从云安全规则和系统防火墙中移除对应的 5432 来源规则,再恢复之前备份的 PostgreSQL 配置文件并重启服务。修改防火墙前确认 SSH 管理入口仍可访问。确认回滚目标后,可按之前记录的文件路径恢复配置,例如:

sudo cp -a /etc/postgresql/16/main/postgresql.conf.before-remote \
  /etc/postgresql/16/main/postgresql.conf
sudo cp -a /etc/postgresql/16/main/pg_hba.conf.before-remote \
  /etc/postgresql/16/main/pg_hba.conf
sudo systemctl restart postgresql
sudo systemctl status postgresql --no-pager

软件包需要卸载时,优先使用 apt-get remove postgresql-16 postgresql-client-16,并在执行前核对包管理器计划移除的内容。不要使用未经核实的清理命令删除 /var/lib/postgresql/,也不要把卸载软件包等同于数据回滚。只有确认数据库数据和配置均不再需要、且备份已验证后,才考虑清理残留文件;直接删除数据目录会造成不可逆的数据丢失。

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

相关推荐