概述
在上一章节中,我们介绍了 PostgreSQL 的发展历史、核心优势及背景信息。从本章开始,我们将正式进入实操环节。作为接触 PostgreSQL 的第一步,基础安装部署是后续所有运维与开发工作的前提。
PostgreSQL 提供了多种安装方式,主要包括 RPM 离线安装、YUM 在线安装 和 源码编译安装。不同方式适用于不同场景:生产环境通常要求稳定可控,开发调试追求便捷高效,而深度定制与内核研究则需要最底层的灵活性。本文将围绕这三种方式展开,逐一讲解其操作流程、适用场景及关键技术要点。
纲要
- PostgreSQL 安装方式概述
- RPM 离线安装
- 核心 RPM 包说明(
libs、client、server、contrib、devel、docs) - 安装顺序与依赖处理
- 环境变量配置(
PATH、LD_LIBRARY_PATH)
- 核心 RPM 包说明(
- YUM 在线安装
- 仓库配置与一键安装
- 适用场景分析
- 源码编译安装
- 依赖包安装(
flex、bison、readline-devel、zlib-devel等) configure编译选项(--prefix、--enable-debug、--with-openssl等)- 编译与安装(
make、make install) - 源码安装的优势与适用场景
- 依赖包安装(
- 数据库集群初始化(
initdb)- 核心参数解析(
-D、-k、-u、-E、-A) - 数据页校验和(
data page checksums)的性能影响 - 数据目录权限(
0700)
- 核心参数解析(
- 服务启动与连接验证(
pg_ctl、psql) - 使用 GDB 调试 PostgreSQL 源码(进阶)
- API 速览
- Demo 简单示例
- 官方文档与参考链接
- 总结
RPM 离线安装
RPM 离线安装是企业级生产环境中最常见、最推荐的安装方式。许多生产环境不允许直接联网,因此需要通过预先下载的 RPM 包进行离线部署。此外,RPM 方式能够对安装包的版本、扩展和依赖进行精确控制。
下载 RPM 包
以 PostgreSQL 18(原文示例为 18,以下统一使用 18 作为版本号)为例,访问 PostgreSQL 官方下载页面(https://www.postgresql.org/download/),选择 Linux 操作系统,并进入 direct RPM download 页面。根据系统发行版(如 Rocky Linux 8)和架构,选择对应的 PostgreSQL 18 RPM 包列表。
以下是必须安装的核心 RPM 包:
| RPM 包 | 说明 | 必要性 |
|---|---|---|
postgresql18-libs | 共享库文件,通常被其他包自动依赖安装 | 必须 |
postgresql18-client | 客户端工具及基础库(包含 psql 等),不含服务端 | 必须 |
postgresql18-server | 服务端二进制文件、初始化工具(initdb)、启动脚本及 pg_ctl 控制工具 | 必须 |
postgresql18-contrib | contrib 目录下的官方扩展模块,如 pg_stat_statements、pgcrypto、hstore 等 | 强烈推荐 |
此外,以下 RPM 包为推荐安装:
| RPM 包 | 说明 |
|---|---|
postgresql18-devel | C 语言客户端库与头文件,编译第三方扩展(如 TimescaleDB、Citus)时必需 |
postgresql18-docs | HTML 格式的官方文档,便于本地浏览 |
安装顺序
离线安装时需严格按照依赖顺序执行。以下演示基于 Rocky Linux 8 全新环境:
# 安装基础工具(用于上传文件)
sudo dnf install -y lrzsz
# 按顺序安装 RPM 包
sudo rpm -ivh postgresql18-libs-*.rpm
sudo rpm -ivh postgresql18-client-*.rpm
sudo rpm -ivh postgresql18-server-*.rpm
sudo rpm -ivh postgresql18-contrib-*.rpm
若安装顺序错误(例如先装 server 再装 libs),将会提示依赖缺失错误:
sudo rpm -ivh postgresql18-server-*.rpm
# error: Failed dependencies: postgresql18-libs is needed by ...
安装目录与用户
RPM 安装完成后,PostgreSQL 文件默认位于 /usr/pgsql-18/ 目录下,包含 bin、lib、share 等子目录。安装过程会自动创建 postgres 系统用户。
环境变量配置
为方便使用,需将 PostgreSQL 的 bin 目录加入 PATH,并将库目录加入 LD_LIBRARY_PATH:
export PATH=/usr/pgsql-18/bin:$PATH
export LD_LIBRARY_PATH=/usr/pgsql-18/lib:$LD_LIBRARY_PATH
source ~/.bashrc
验证安装是否成功:
which psql
# /usr/pgsql-18/bin/psql
psql --version
# psql (PostgreSQL) 18.0
YUM 在线安装
YUM 在线安装是最简便的方式,适用于开发环境、测试环境以及网络条件良好的场景。YUM 会自动处理所有依赖关系,无需手动下载和排序 RPM 包。
配置 YUM 仓库
访问 PostgreSQL 官方 YUM 仓库页面(https://www.postgresql.org/download/linux/redhat/),根据操作系统版本和架构选择对应的仓库 RPM 包。以 Rocky Linux 8 为例:
# 安装 PostgreSQL YUM 仓库
sudo yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
# 安装 PostgreSQL 18
sudo yum install -y postgresql18-server postgresql18-contrib
YUM 的一大优势是自动处理依赖,只需确保网络环境畅通即可完成安装。但需要注意的是,YUM 方式需要联网,且在某些网络环境下下载速度可能较慢。
源码编译安装
源码编译安装是最灵活、最底层的安装方式,适用于以下场景:
- 需要深入研究 PostgreSQL 内核源代码
- 需要启用默认未开启的编译选项(如调试符号、断言)
- 需要定制编译时参数(如数据块大小
--with-blocksize) - 需要开发或调试第三方插件
下载源码包
从 PostgreSQL 官方源码下载页面获取源码包:
# 下载 PostgreSQL 18 源码包
wget https://ftp.postgresql.org/pub/source/v18.0/postgresql-18.0.tar.gz
tar -xzf postgresql-18.0.tar.gz
cd postgresql-18.0
安装编译依赖
源码编译需要提前安装一系列依赖包。以 Rocky Linux 8 / RHEL 系列为例:
# Rocky Linux 8 / RHEL 系列
sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y gcc gcc-c++ make readline-devel zlib-devel \
openssl-devel pam-devel libxml2-devel libxslt-devel \
systemd-devel flex bison
以 Ubuntu / Debian 系列为例:
sudo apt-get update
sudo apt-get install -y build-essential libreadline-dev zlib1g-dev \
flex bison libxml2-dev libxslt-dev libssl-dev \
libxml2-utils xsltproc ccache pkg-config
其中 flex 和 bison 是词法分析和语法分析工具,PostgreSQL 借助它们对 SQL 语句进行解析。若环境中缺少这两个工具,编译过程将失败。
配置编译选项(configure)
configure 脚本用于检测系统环境并生成 Makefile。常用选项如下:
| 选项 | 说明 |
|---|---|
--prefix=PREFIX | 指定安装目录,如 /usr/pgsql-18 |
--enable-debug | 编译时加入调试符号(-g),便于 GDB 调试 |
--with-openssl | 启用 OpenSSL 支持 |
--with-perl | 启用 PL/Perl 支持 |
--with-python | 启用 PL/Python 支持 |
--with-blocksize=BLOCKSIZE | 设置数据块大小(单位 KB),默认 8KB |
以下为最小化配置示例:
./configure --prefix=/usr/pgsql-18 --enable-debug
执行 configure 时,脚本会逐一检查依赖项。若某项依赖缺失,会在输出中明确提示 checking for ... no,需根据提示补充安装对应依赖包。
编译与安装
# 并行编译(利用多核 CPU)
make -j $(nproc)
# 安装
make install
编译完成后,安装目录结构如下:
/usr/pgsql-18
├── bin # 可执行文件(initdb, pg_ctl, psql, postgres 等)
├── include # 头文件(编译扩展时必需)
├── lib # 共享库
└── share # 共享文档与配置文件
与 RPM 安装相比,源码安装默认包含 include 目录(头文件),因此编译第三方扩展时无需额外安装 -devel 包。
创建 postgres 用户
源码安装不会自动创建 postgres 用户,需手动操作:
sudo useradd postgres
数据库集群初始化(initdb)
无论采用何种安装方式,安装完成后都需要使用 initdb 初始化数据库集群。initdb 会创建数据目录、生成共享系统表并建立 template1 数据库。
核心参数
| 参数 | 说明 |
|---|---|
-D, --pgdata=DIRECTORY | 指定数据目录位置 |
-k, --data-checksums | 启用数据页校验和(data page checksums) |
-E, --encoding=ENCODING | 设置默认编码,如 UTF8 |
-u, --username=NAME | 指定超级用户名,默认 postgres |
-A, --auth=METHOD | 指定默认认证方式,如 scram-sha-256、trust |
-U, --superuser=NAME | 指定超级用户名(同 -u) |
数据页校验和(-k 参数)
-k 参数用于启用数据页校验和(data page checksums)。开启后,PostgreSQL 在每次读取数据页时会计算校验和并与存储值比对,从而检测磁盘静默损坏(silent corruption)。根据社区评测,开启校验和会带来约 3%~5% 的性能损耗,但对于生产环境而言,这一代价是值得的,因为它能有效预防数据静默损坏带来的灾难性后果。
数据目录权限
initdb 要求数据目录权限为 0700(即仅属主可读写执行)。PostgreSQL 11 及以上版本也支持 0750(属主和同组用户可读写执行)。若权限不符合要求,initdb 或服务启动时会报错:
FATAL: data directory has group or world access; permissions should be u=rwx (0700)
初始化示例
以下为使用 postgres 用户执行初始化的完整示例:
# 切换到 postgres 用户
sudo su - postgres
# 创建数据目录(确保权限为 0700)
mkdir -p /var/lib/pgsql/18/data
chmod 0700 /var/lib/pgsql/18/data
# 执行初始化
initdb -D /var/lib/pgsql/18/data \
-k \
-E UTF8 \
-U postgres \
-A scram-sha-256
服务启动与连接验证
使用 pg_ctl 工具启动数据库服务:
pg_ctl -D /var/lib/pgsql/18/data -l logfile start
使用 psql 客户端连接验证:
psql -U postgres -d postgres -h localhost -p 5432
连接成功后,可执行简单查询:
SELECT version();
-- PostgreSQL 18.0 on x86_64-pc-linux-gnu, compiled by gcc ...
使用 GDB 调试 PostgreSQL 源码(进阶)
源码编译安装的一大优势是支持使用 GDB 进行运行时调试。这对于内核开发、问题定位和性能分析尤为重要。
调试步骤
-
获取目标进程 PID
ps aux | grep postgres -
附加 GDB 调试
gdb -p <PID> -
设置断点与继续执行
在 GDB 中可设置断点、单步执行、查看调用栈等:
(gdb) b exec_simple_query (gdb) c -
触发调试场景
在另一个会话中执行 SQL,GDB 会在断点处暂停:
CREATE TABLE test (id INT PRIMARY KEY); INSERT INTO test VALUES (1); -- 再次插入相同值,触发唯一约束冲突 INSERT INTO test VALUES (1); -
查看调用栈
(gdb) bt # 显示完整的函数调用栈,定位错误发生位置\errverbose是psql的一个元命令,执行后可以显示最近错误的详细信息,包括错误发生所在的源代码文件和行号,配合 GDB 可快速定位问题代码。
API 速览
initdb
所属库:PostgreSQL 服务端工具(bin/initdb)
方法签名:
initdb [OPTION]... [--pgdata | -D] DATADIR
核心参数:
| 参数 | 类型 | 说明 |
|---|---|---|
-D DIRECTORY | string | 数据目录路径 |
-k | flag | 启用数据页校验和 |
-E ENCODING | string | 默认编码(如 UTF8) |
-U NAME | string | 超级用户名 |
-A METHOD | string | 认证方式(trust、scram-sha-256、md5 等) |
-g | flag | 允许同组用户访问数据目录(权限 0750) |
返回值:无(成功时创建数据目录并初始化系统表,失败时返回非零退出码)
示例:
initdb -D /var/lib/pgsql/data -k -E UTF8 -U postgres -A scram-sha-256
pg_ctl
所属库:PostgreSQL 服务端工具(bin/pg_ctl)
方法签名:
pg_ctl -D DATADIR [start | stop | restart | reload | status] [OPTION]...
核心参数:
| 参数 | 类型 | 说明 |
|---|---|---|
-D DIRECTORY | string | 数据目录路径 |
-l FILENAME | string | 日志输出文件 |
-w | flag | 等待操作完成 |
-t SECONDS | integer | 等待超时时间(秒) |
示例:
pg_ctl -D /var/lib/pgsql/data start -l /var/log/postgresql.log
pg_ctl -D /var/lib/pgsql/data stop -m fast
psql
所属库:PostgreSQL 客户端工具(bin/psql)
方法签名:
psql [OPTION]... [DBNAME [USERNAME]]
核心参数:
| 参数 | 类型 | 说明 |
|---|---|---|
-h HOST | string | 数据库主机地址 |
-p PORT | integer | 数据库端口(默认 5432) |
-U USERNAME | string | 连接用户名 |
-d DBNAME | string | 数据库名 |
-c COMMAND | string | 执行单条 SQL 命令后退出 |
示例:
psql -h localhost -p 5432 -U postgres -d postgres -c "SELECT version();"
GDB(GNU Debugger)
所属库:GNU 调试工具(系统级工具)
常用命令:
| 命令 | 说明 |
|---|---|
gdb -p PID | 附加到指定进程 |
b FUNCTION | 在函数入口设置断点 |
c | 继续执行 |
n | 单步执行(不进入函数内部) |
s | 单步执行(进入函数内部) |
bt | 打印调用栈 |
p VARIABLE | 打印变量值 |
q | 退出 GDB |
示例:
gdb -p 12345
(gdb) b exec_simple_query
(gdb) c
Demo 简单示例
以下 Demo 演示了在 Rocky Linux 8 环境下,通过 RPM 方式安装 PostgreSQL 18、初始化数据库集群并启动服务的完整流程。
运行说明
- 环境准备:Rocky Linux 8 最小化安装,具备
sudo权限。 - RPM 包准备:从 PostgreSQL 官方 YUM 仓库下载所需的 RPM 包,或通过联网环境预先下载。
- 执行脚本:按顺序执行以下命令。
完整代码
#!/bin/bash
# PostgreSQL 18 RPM 安装与初始化 Demo
# 适用版本:PostgreSQL 18
# 操作系统:Rocky Linux 8 / RHEL 8
set -e
echo "=== 1. 安装基础工具 ==="
sudo dnf install -y lrzsz wget
echo "=== 2. 下载 PostgreSQL 18 RPM 包(离线场景) ==="
# 若已提前下载好 RPM 包,可跳过此步
# wget https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-8-x86_64/postgresql18-libs-*.rpm
# wget https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-8-x86_64/postgresql18-client-*.rpm
# wget https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-8-x86_64/postgresql18-server-*.rpm
# wget https://download.postgresql.org/pub/repos/yum/18/redhat/rhel-8-x86_64/postgresql18-contrib-*.rpm
echo "=== 3. 安装 RPM 包(按依赖顺序) ==="
sudo rpm -ivh postgresql18-libs-*.rpm
sudo rpm -ivh postgresql18-client-*.rpm
sudo rpm -ivh postgresql18-server-*.rpm
sudo rpm -ivh postgresql18-contrib-*.rpm
echo "=== 4. 配置环境变量 ==="
export PATH=/usr/pgsql-18/bin:$PATH
export LD_LIBRARY_PATH=/usr/pgsql-18/lib:$LD_LIBRARY_PATH
echo 'export PATH=/usr/pgsql-18/bin:$PATH' >> ~/.bashrc
echo 'export LD_LIBRARY_PATH=/usr/pgsql-18/lib:$LD_LIBRARY_PATH' >> ~/.bashrc
source ~/.bashrc
echo "=== 5. 验证安装 ==="
psql --version
echo "=== 6. 初始化数据库集群 ==="
sudo mkdir -p /var/lib/pgsql/18/data
sudo chown postgres:postgres /var/lib/pgsql/18/data
sudo chmod 0700 /var/lib/pgsql/18/data
sudo su - postgres -c "initdb -D /var/lib/pgsql/18/data -k -E UTF8 -U postgres -A scram-sha-256"
echo "=== 7. 启动 PostgreSQL 服务 ==="
sudo su - postgres -c "pg_ctl -D /var/lib/pgsql/18/data -l /var/lib/pgsql/18/logfile start"
echo "=== 8. 连接验证 ==="
sudo su - postgres -c "psql -U postgres -d postgres -c 'SELECT version();'"
echo "=== 9. 创建测试表并插入数据 ==="
sudo su - postgres -c "psql -U postgres -d postgres -c 'CREATE TABLE demo (id SERIAL PRIMARY KEY, name TEXT);'"
sudo su - postgres -c "psql -U postgres -d postgres -c 'INSERT INTO demo (name) VALUES (\"Hello PostgreSQL\");'"
sudo su - postgres -c "psql -U postgres -d postgres -c 'SELECT * FROM demo;'"
echo "=== PostgreSQL 18 安装与初始化完成 ==="
代码说明
- 依赖顺序:
libs→client→server→contrib,严格遵循依赖关系。 - 环境变量:
PATH确保psql、initdb、pg_ctl等命令可直接调用;LD_LIBRARY_PATH确保运行时能正确加载共享库。 - 数据目录权限:手动创建目录并设置为
0700,确保initdb不会因权限问题失败。 - 校验和:
-k参数启用数据页校验和,提升数据安全性。 - 认证方式:
-A scram-sha-256使用 SCRAM-SHA-256 认证,比 MD5 更安全。
技术点总结
| 技术点 | 说明 |
|---|---|
| RPM 包管理 | 掌握 rpm -ivh 安装命令及依赖顺序 |
| 环境变量配置 | PATH 和 LD_LIBRARY_PATH 的作用与配置方法 |
| 数据目录权限 | 0700 权限要求及配置方式 |
| 数据页校验和 | -k 参数的作用与性能影响 |
initdb 初始化 | 核心参数 -D、-k、-E、-U、-A 的使用 |
pg_ctl 服务管理 | 启动、停止、重载等操作 |
psql 客户端连接 | 连接数据库并执行 SQL |
项目难点与解决方案
核心难点
- 离线环境的依赖管理:生产环境通常无法联网,需提前规划并下载所有依赖的 RPM 包,确保版本兼容性。
- 源码编译的依赖链:
configure阶段会检查大量系统依赖,缺少任一依赖都会导致编译失败,需逐一排查并安装。 - 数据目录权限问题:
initdb对数据目录权限有严格要求(0700),权限不当会导致初始化或启动失败。
解决方案
- RPM 离线安装:从官方 YUM 仓库下载完整的 RPM 包集合(含
libs、client、server、contrib、devel、docs),按依赖顺序安装。 - 源码编译依赖:参考 PostgreSQL 官方文档的 Requirements 章节,提前安装
Development Tools及readline-devel、zlib-devel、flex、bison、openssl-devel等包。 - 权限前置处理:在运行
initdb前,以root身份创建数据目录并执行chown postgres:postgres和chmod 0700,再切换至postgres用户执行初始化。
广度
本文覆盖了 PostgreSQL 在 Linux 平台上的三种主流安装方式,涉及 RPM 包管理、YUM 仓库配置、源码编译工具链、环境变量配置、数据库集群初始化、服务管理及源码调试等多个维度,适用于从初级运维到高级内核开发者的广泛读者群体。
深度
本文深入讲解了 initdb 各核心参数的设计意图(如 -k 校验和的原理与性能代价)、数据目录权限的底层要求、源码编译各依赖项的作用(flex/bison 的词法语法分析角色),以及 GDB 调试 PostgreSQL 源码的实操方法,具备较高的技术深度。
复杂度
RPM 安装的复杂度较低,主要在于依赖顺序管理;YUM 安装复杂度最低,几乎为傻瓜式操作;源码编译安装复杂度最高,涉及依赖安装、编译选项调优、编译时间优化(-j 并行编译)及后续的调试环境配置,对操作者的系统管理能力要求较高。
官方文档
- PostgreSQL 官方文档 - 从源码安装
- PostgreSQL 官方文档 - initdb
- PostgreSQL 官方文档 - pg_ctl
- PostgreSQL 官方文档 - psql
- PostgreSQL 官方文档 - 编译要求
- PostgreSQL Wiki - 源码编译安装
参考链接
总结
本文系统介绍了 PostgreSQL 的三种主流安装方式。RPM 离线安装是企业级生产环境的首选,稳定可靠且不依赖网络;YUM 在线安装最为简便快捷,适合开发与测试环境;源码编译安装提供了最大的灵活性,支持调试符号、自定义编译选项及内核级定制,是深度研究与内核开发的必经之路。
无论采用哪种方式,安装完成后的数据库集群初始化(initdb)都是关键步骤,其中数据页校验和(-k)的开启、数据目录权限(0700)的设置以及认证方式的选择,都直接影响数据库的运行安全与性能。掌握这三种安装方式,即可在任何 Linux 环境中快速搭建 PostgreSQL 数据库服务。
480



被折叠的 条评论
为什么被折叠?



