PostgreSQL / 系统课时
在 Linux 上安装 PostgreSQL
在 Linux 上安装 PostgreSQL
本课解决 Linux 环境中如何正确安装 PostgreSQL 的问题。以 Ubuntu/Debian 为例,完成软件安装、服务启动、本地连接验证和数据目录检查。完成后,你将获得一个可以正常执行 SQL 的 PostgreSQL 数据库环境,为后续数据库操作做好准备。
学习目标
- 掌握使用 Linux 包管理器安装 PostgreSQL 的基本流程。
- 学会检查 PostgreSQL 服务状态、数据库实例状态并验证连接。
- 了解常见数据目录、权限要求和安装故障的排查方法。
安装 PostgreSQL 软件
Linux 上安装 PostgreSQL 通常使用系统包管理器。不同发行版命令略有区别,但核心流程都是安装服务端程序、初始化数据库集群并启动服务。Ubuntu/Debian 使用 APT,RHEL、Rocky Linux 等发行版通常使用 DNF,具体软件包和初始化方式需要遵循对应发行版的说明。
以 Ubuntu 为例,先确认当前账户拥有 sudo 权限、网络能够访问软件仓库,再执行以下命令:
# 更新软件包索引,安装服务端与常用扩展包
# 只有安装成功才输出完成标记
sudo apt update && sudo apt install -y postgresql postgresql-contrib && printf 'INSTALL_OK\n'预期输出(省略随系统版本变化的 APT 日志,最后一行):
INSTALL_OKpostgresql 安装 PostgreSQL 服务端及必要依赖,postgresql-contrib 提供常用扩展组件。发行版仓库会决定具体的 PostgreSQL 大版本,因此安装结果不一定是 PostgreSQL 官方发布的最新版本。
安装完成后,Ubuntu/Debian 通常会自动创建一个名为 main 的数据库集群。这里的集群是 PostgreSQL 管理工具对一套数据库实例及其数据目录的称呼,并不意味着已经部署了多台服务器。
启动服务并验证状态
安装后需要确认 PostgreSQL 是否正常运行。在使用 systemd 的 Ubuntu/Debian 主机上,可以通过 systemctl 启动服务,再使用 pg_lsclusters 检查实际数据库集群的运行状态。
# 启动 PostgreSQL 服务
sudo systemctl start postgresql
# 检查已安装集群的版本、端口和运行状态
pg_lsclusters预期输出(以存在一个默认集群为例,省略列宽对齐):
Ver Cluster Port Status Owner Data directory Log file
<VERSION> main <PORT> online postgres <DATA_DIR> <LOG_FILE>其中 Status 为 online 表示对应数据库集群正在运行,down 表示未运行。postgresql.service 在 Ubuntu/Debian 上可能显示 active (exited),因为它可以是管理多个数据库实例的汇总服务单元,不能仅凭该状态认定实际数据库进程已经就绪。
接下来使用安装时创建的 postgres 系统账户连接数据库,执行一个最小查询,确认 PostgreSQL 不仅已经启动,而且能够正常接受本地连接并执行 SQL。
# 使用 postgres 系统账户,通过本地认证连接数据库
sudo -u postgres psql -Atqc "SELECT current_user, current_database();"预期输出:
postgres|postgres输出中的第一个 postgres 是当前数据库角色,第二个 postgres 是当前连接的数据库。-A 关闭表格对齐,-t 去掉表头和附加行数,-q 减少无关提示,-c 指定执行的 SQL。
能够得到上述结果,说明默认数据库实例已具备本地连接与执行查询的能力。如果连接失败,应先查看 pg_lsclusters 是否显示 online,再检查认证方式和连接配置。
查看数据目录
PostgreSQL 的数据目录保存数据库表、索引、事务日志等运行所需的文件。不同发行版和安装版本的目录位置可能不同,因此不要通过猜测版本号确定路径,而应直接查询正在运行的实例。
# 从当前数据库实例读取实际的数据目录
sudo -u postgres psql -Atqc "SHOW data_directory;"预期输出(Ubuntu/Debian 默认安装的常见路径形态):
/var/lib/postgresql/<VERSION>/main其中 <VERSION> 表示实际安装的 PostgreSQL 大版本,例如 16;输出路径以当前系统的查询结果为准。前面示例中的 <PORT>、<DATA_DIR> 和 <LOG_FILE> 同样代表实际环境中的端口、数据目录和日志文件路径,各机器可能不同。
在 Ubuntu/Debian 的常见安装方式下,还需要区分以下位置:
- 数据目录:通常位于
/var/lib/postgresql/<VERSION>/main/,保存数据库实际数据。 - 配置目录:通常位于
/etc/postgresql/<VERSION>/main/,存放postgresql.conf、pg_hba.conf等配置文件。 - 日志目录:通常位于
/var/log/postgresql/,可用于检查数据库启动与运行错误。
这些是发行版打包安装的常见默认路径,并非所有 Linux 系统都相同。数据目录通常由 postgres 系统用户管理。普通用户不应直接修改数据库文件,也不要为了方便访问而将整个数据目录改成宽松的读写权限。
常见安装问题
如果安装命令失败,首先检查 APT 是否报告软件包不存在、仓库不可访问或依赖冲突。软件包不存在时,应检查系统版本和软件源配置,而不是直接下载来历不明的安装包。
如果 PostgreSQL 无法启动,可以按以下顺序排查:
- 执行
pg_lsclusters,确认默认main集群是否存在,以及Status是否为down。 - 执行
sudo systemctl status postgresql --no-pager,检查服务管理器是否报告错误。还可以使用sudo journalctl -u postgresql -n 50 --no-pager查看相关日志。 - 查看
/var/log/postgresql/下对应实例的日志,确认是否存在端口占用、数据目录权限错误、配置错误或磁盘空间不足。 - 修正明确的故障原因后重新启动服务,并再次执行前面的
pg_lsclusters和 SQL 查询进行验证。
如果集群存在但未启动,Ubuntu/Debian 还可使用 pg_ctlcluster 单独启动实例。例如 sudo pg_ctlcluster 16 main start 启动版本为 16、名称为 main 的集群;实际操作时必须将 16 替换为 pg_lsclusters 显示的版本。
在没有 systemd 的容器或精简系统中,systemctl 可能无法使用,此时需要采用该环境提供的进程管理方式。对于常规 Ubuntu/Debian 主机,只要数据库集群状态为 online、本地 SQL 查询能够返回预期结果,并且可以确认真实数据目录,就完成了本课的安装验证。