PostgreSQL 部署运维实战总结:从安装踩坑到生产可用

本文基于一次真实的主机资产管理系统落地过程整理,覆盖部署、初始化、密码与权限、数据录入、日常运维与备份恢复 的完整闭环。核心结论先行:生产环境首选 PGDG 仓库 RPM 安装;离线环境用 yumdownloader --resolve 打包;务必先确认你装的是"发行版模块包"还是"PGDG 版本化包",两者的初始化命令和服务名完全不同;数据录入优先走 COPY 而不是逐行 INSERT;备份不是"有就行",而要可恢复、可验证。

一、部署方式选型:为什么是 RPM

在 Anolis OS 8.6 上部署 PostgreSQL,主流有三条路:

维度 PGDG 仓库 RPM(推荐) 源码编译 Docker 容器
版本获取 官方维护,版本新 完全自主 镜像版本可控
运维复杂度 低 ,dnf 统一管理 中,升级需重编译 中高,数据卷需独立管理
升级路径 dnf 管次版本,pg_upgrade 管大版本 手动重编译或替换二进制 必须 pg_dump/pg_upgrade
适用场景 生产长期维护 深度定制 开发验证

结论:长期生产服务选 RPM。 容器在单机数据库场景下不提供弹性收益,反而让"数据持久化"和"备份路径"变成需要额外操心的两件事;源码编译的代价是次版本升级脱离包管理器,运维负担陡增。

二、在线安装(PGDG 仓库)

bash 复制代码
# 1. 安装 PGDG 仓库
sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm

# 2. 禁用发行版内置模块,避免冲突
sudo dnf -qy module disable postgresql

# 3. 安装服务端与 contrib
sudo dnf install -y postgresql15-server postgresql15-contrib

第 2 步不能省。 Anolis 8.6 默认仓库里有一个模块化的 postgresql 流,与 PGDG 的版本化包存在包名和路径冲突,不先禁用模块,后续会装出"两套并存"的混乱状态。

三、离线安装(无法连接外网)

离线部署的核心思路是**"联网准备、离线安装",且准备机与目标机的OS 版本和 CPU 架构必须完全一致**。

3.1 联网机准备 RPM 与全部依赖

bash 复制代码
sudo dnf install -y yum-utils
sudo dnf install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-8-x86_64/pgdg-redhat-repo-latest.noarch.rpm
sudo dnf -qy module disable postgresql

mkdir -p ~/pg-offline-rpms
# --resolve 自动下载依赖;--installroot 用空根目录强制从零解析,避免漏包
yumdownloader --resolve --installroot=/tmp/emptyroot \
    --destdir=~/pg-offline-rpms \
    postgresql15-server postgresql15-contrib postgresql15

tar czf pg-offline-rpms.tar.gz -C ~/pg-offline-rpms .

易漏点: 如果联网机上已装过某些依赖,--resolve 不会重复下载它们。用 --installroot 指向空目录,强制工具重新解析完整依赖树,是离线打包最稳妥的做法。

3.2 离线机安装

bash 复制代码
mkdir -p /opt/pg-offline-rpms
tar xzf pg-offline-rpms.tar.gz -C /opt/pg-offline-rpms
cd /opt/pg-offline-rpms
sudo dnf localinstall ./*.rpm   # 自动处理本地 RPM 依赖顺序

若提示缺少 Anolis 系统自带依赖,挂载系统 ISO 作为临时本地源补装:

bash 复制代码
sudo mount -o loop /path/to/AnolisOS-8.6-x86_64.iso /mnt/iso
sudo dnf --repofrompath=iso-baseos,file:///mnt/iso/BaseOS \
         --repofrompath=iso-appstream,file:///mnt/iso/AppStream \
         install -y <缺失包名>

3.3 进阶:把 RPM 目录做成永久本地 YUM 仓库

bash 复制代码
sudo dnf install -y createrepo_c
sudo createrepo_c /opt/pg-offline-rpms

sudo tee /etc/yum.repos.d/pg-offline.repo <<'EOF'
[pg-offline]
name=PostgreSQL Offline Repository
baseurl=file:///opt/pg-offline-rpms
enabled=1
gpgcheck=0
EOF

此后 dnf install 即可像在线一样自动解析依赖。

四、最容易踩的坑:发行版模块包 vs. PGDG 包

这是本次实战中最值得记录的一段。同样是 PostgreSQL 15,包来源不同,命令和服务名完全不同。

对比项 Anolis 发行版模块包 postgresql-server PGDG 版本化包 postgresql15-server
初始化命令 postgresql-setup --initdb postgresql-15-setup initdb
服务名 postgresql postgresql-15
数据目录 /var/lib/pgsql/data /var/lib/pgsql/15/data
升级工具 postgresql-setup --upgrade pg_upgrade + dnf

如何判断? 执行 rpm -qi postgresql-server 或 rpm -qa | grep postgresql:

  • 只有 postgresql-server(无版本号),且存在 postgresql-setup → 发行版模块包。
  • 有 postgresql15-server、postgresql-15-setup → PGDG 版本化包。

典型报错与解法:

复制代码
psql: error: connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: 
No such file or directory

根因通常是数据目录未初始化 或服务未启动。排查顺序:

bash 复制代码
sudo systemctl status postgresql        # 或 postgresql-15
sudo journalctl -xe -u postgresql --no-pager
ls /var/lib/pgsql/data/                 # 或 /var/lib/pgsql/15/data/

# 补做初始化(用与你包来源匹配的命令)
sudo postgresql-setup --initdb          # 发行版模块包
# 或
sudo /usr/pgsql-15/bin/postgresql-15-setup initdb   # PGDG 包

sudo systemctl enable --now postgresql  # 或 postgresql-15
sudo -u postgres psql -c "SELECT version();"

五、初始化后的第一件事:密码与连接认证

5.1 理解 peer 认证:为什么需要 sudo -u postgres

安装完成后,默认 pg_hba.conf 中本地 Unix 套接字连接使用 peer 认证 ,要求操作系统用户名与数据库用户名一致 。当前 Linux 用户不是 postgres 时,直接敲 psql 会因身份不匹配被拒绝。所以本机操作的入口是:

bash 复制代码
sudo -u postgres psql

5.2 设置 postgres 密码(三种等效方式)

ALTER USER postgres WITH PASSWORD ... 是一条 SQL 语句,必须由 psql(或其他客户端)提交给服务端执行,不能直接在 shell 中敲。

方式一:进入 psql 交互式命令行

bash 复制代码
sudo -u postgres psql
sql 复制代码
ALTER USER postgres WITH PASSWORD 'YourStrongPassword';
\q

方式二:用 -c 直接执行(推荐,适合文档和脚本)

bash 复制代码
sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD 'YourStrongPassword';"

方式三:通过标准输入管道

bash 复制代码
echo "ALTER USER postgres WITH PASSWORD 'YourStrongPassword';" | sudo -u postgres psql

三种方式的本质相同,都是让 psql 把 SQL 发给服务端。-c 方式最适合写进部署文档和自动化脚本,不进入交互界面,执行完即退出。

注意: ALTER USER 修改的是 PostgreSQL 数据库角色的密码 ,不是 Linux 系统用户 postgres 的密码(后者用 passwd postgres)。只有数据库超级用户可以修改其他角色的密码,普通用户只能改自己的密码。

5.3 密码设置后的认证方式调整

设置密码后,如果希望远程连接 或密码登录 ,需要调整 pg_hba.conf。安全基线建议:

复制代码
# 本地 Unix 套接字:保持 peer 更安全
local   all   all                     peer

# 本机回环:使用 scram-sha-256
host    all   all   127.0.0.1/32      scram-sha-256

# 内网应用网段:仅允许特定网段密码登录
host    mydb  app_rw 192.168.10.0/24  scram-sha-256

优先使用 scram-sha-256 ,不要使用明文 password 或 trust。scram-sha-256 是 PostgreSQL 10+ 的默认强认证方式,避免在网络上传输可重放的明文凭据。

同时,postgresql.conf 中的监听地址按需调整:

复制代码
listen_addresses = 'localhost'   # 仅本机
# 或
listen_addresses = '192.168.10.5'  # 仅特定内网 IP

不要轻易使用 '*' 对外暴露,生产环境应配合防火墙和反向代理限制来源。

六、用户与权限:不要长期用超级用户跑应用

6.1 创建应用专用用户

sql 复制代码
-- 创建可登录的普通用户(CREATE USER 是 CREATE ROLE ... WITH LOGIN 的简写)
CREATE USER app_user WITH LOGIN PASSWORD 'AppStrongPass!';

-- 查看所有角色
\du

如果需要限制账号有效期(例如临时账号),可以附加 VALID UNTIL:

sql 复制代码
CREATE USER temp_user WITH LOGIN PASSWORD 'TempPass!' VALID UNTIL '2026-12-31';

6.2 最小权限授权范式

不要直接把超级用户交给应用。按"库级连接 → 模式使用 → 表级操作 → 序列使用"的层级逐步授权:

sql 复制代码
-- 1. 允许连接数据库
GRANT CONNECT ON DATABASE assetdb TO app_user;

-- 2. 允许使用 public 模式
GRANT USAGE ON SCHEMA public TO app_user;

-- 3. 对现有表授予增删改查(按需裁剪)
GRANT SELECT, INSERT, UPDATE, DELETE ON TABLE public.host_assets TO app_user;

-- 4. 如果表有自增主键,授予序列使用权限
GRANT USAGE, SELECT ON SEQUENCE public.host_assets_id_seq TO app_user;

关键一步:为"未来新建的表"设置默认权限。 PostgreSQL 默认不会自动把新建对象的权限授予已有角色,必须用 ALTER DEFAULT PRIVILEGES 显式声明,否则后续新建的表应用会突然"权限不足":

sql 复制代码
ALTER DEFAULT PRIVILEGES IN SCHEMA public
GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO app_user;

ALTER DEFAULT PRIVILEGES IN SCHEMA public
GRANT USAGE, SELECT ON SEQUENCES TO app_user;

只读角色的最小权限示例:

sql 复制代码
CREATE USER read_only WITH LOGIN PASSWORD 'ReadOnlyPass!';
GRANT CONNECT ON DATABASE assetdb TO read_only;
GRANT USAGE ON SCHEMA public TO read_only;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO read_only;
ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON TABLES TO read_only;

撤销权限使用 REVOKE,例如:

sql 复制代码
REVOKE DELETE ON TABLE public.host_assets FROM app_user;

七、psql 常用操作速查

7.1 连接与退出

场景 命令
本地默认连接(peer) sudo -u postgres psql
指定用户、主机、端口、库名 psql -U user -h 192.168.1.10 -p 5432 -d mydb -W
直接执行单条 SQL 后退出 psql -U postgres -d mydb -c "SELECT version();"
执行 SQL 文件 psql -U postgres -d mydb -f /path/to/script.sql
退出 psql \q

7.2 元命令(在 psql 内使用)

命令 作用
\l 列出所有数据库
\c dbname 切换数据库
\dt 列出当前库所有表
\d table_name 查看表结构
\dn 列出所有 schema
\du 列出所有角色/用户
\di 列出所有索引
\dx 列出已安装扩展
\timing 开关 SQL 执行计时
\x 切换扩展显示(竖排,适合宽表)
\? 查看所有元命令帮助

这些元命令是日常运维中使用频率最高的入口,\l、\dt、\d、\du 四条覆盖了"看库、看表、看结构、看用户"的基本盘。

7.3 数据库与表操作(SQL 层)

sql 复制代码
-- 创建数据库
CREATE DATABASE assetdb WITH OWNER = postgres ENCODING = 'UTF8' 
    LC_COLLATE = 'en_US.utf8' LC_CTYPE = 'en_US.utf8' TEMPLATE = template0;

-- 删除数据库(需先断开连接)
SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = 'assetdb';
DROP DATABASE assetdb;

-- 表结构变更
ALTER TABLE host_assets ADD COLUMN rack VARCHAR(32);
ALTER TABLE host_assets RENAME COLUMN purpose TO usage_desc;

八、数据录入:从单行插入到批量导入

8.1 少量数据的 INSERT

插入单行:

sql 复制代码
INSERT INTO host_assets (host_ip, architecture, spec, team, usage_desc, owner, lease_end)
VALUES ('192.168.1.10', 'x86_64', '8C16G', '平台组', '应用服务器', '张三', '2026-06-30');

插入多行(一条语句,减少往返):

sql 复制代码
INSERT INTO host_assets (host_ip, architecture, spec, team, usage_desc, owner, lease_end)
VALUES 
    ('192.168.1.11', 'x86_64', '4C8G', '平台组', '测试机', '李四', '2026-08-15'),
    ('192.168.1.12', 'arm64', '8C32G', '数据组', '数据库备机', '王五', '2026-12-01');

UPSERT(冲突时更新或忽略):

sql 复制代码
INSERT INTO host_assets (host_ip, architecture, team, lease_end)
VALUES ('192.168.1.10', 'x86_64', '新平台组', '2027-01-01')
ON CONFLICT (host_ip) DO UPDATE SET 
    team = EXCLUDED.team,
    lease_end = EXCLUDED.lease_end;

-- 或冲突时忽略
ON CONFLICT (host_ip) DO NOTHING;

插入并返回生成值:

sql 复制代码
INSERT INTO host_assets (host_ip, architecture, team, lease_end)
VALUES ('192.168.1.13', 'x86_64', '平台组', '2026-10-01')
RETURNING id, created_at;

8.2 中等批量:显式事务 + 多行 INSERT

如果数据量在几百到几千行,且来源不是 CSV,可以使用显式事务包裹多行 INSERT,避免自动提交带来的逐行开销:

sql 复制代码
BEGIN;
INSERT INTO host_assets (...) VALUES (...), (...), ...;  -- 每 500--1000 行一个语句
COMMIT;

PostgreSQL 官方建议:在使用多条 INSERT 时关闭自动提交,把所有插入放在一个事务中,既减少每次提交的 WAL 和刷盘开销,也保证部分失败时整体回滚,不会留下半加载状态。

8.3 大量数据:COPY 是唯一推荐的快速路径

PostgreSQL 官方明确:COPY 几乎总是比 INSERT 快,即使 INSERT 使用了 PREPARE 并批量放在单个事务中也是如此 。COPY 是专为批量加载优化的单命令路径,绕过了逐行 SQL 解析和执行的 overhead。

标准导入顺序:建表(不建二级索引)→ COPY → 建索引 → ANALYZE。

sql 复制代码
-- 1. 建表时不建二级索引(主键除外)
CREATE TABLE host_assets (
    id            BIGSERIAL PRIMARY KEY,
    host_ip       INET        NOT NULL UNIQUE,
    architecture  VARCHAR(32) NOT NULL,
    spec          VARCHAR(128),
    team          VARCHAR(64) NOT NULL,
    usage_desc    VARCHAR(128),
    owner         VARCHAR(64),
    lease_end     DATE        NOT NULL,
    created_at    TIMESTAMPTZ DEFAULT now()
);

-- 2. COPY 加载(CSV 为 UTF-8,无合并单元格)
COPY host_assets (host_ip, architecture, spec, team, usage_desc, owner, lease_end)
FROM '/path/to/host_assets.csv'
WITH (FORMAT csv, HEADER true, ENCODING 'UTF8');

-- 3. 导入完成后再建索引
CREATE INDEX idx_host_assets_lease_end ON host_assets (lease_end);

-- 4. 更新统计信息
ANALYZE host_assets;

为什么"先导入后建索引"? 逐行加载时每行都要维护 B-Tree,页分裂和重平衡开销随数据量超线性增长;导入后一次性建索引,本质是一次高效的批量排序合并。如果在已有数据的表上追加大量数据,也可以考虑先 DROP 二级索引、加载完再重建,但需权衡缺失唯一索引期间约束检查的暂时缺失。

CSV 预处理要点:

  • 另存为 "CSV UTF-8",避免 ANSI/GBK 乱码。
  • 删除所有合并单元格,否则 CSV 中仅左上角有值,字段错位。
  • lease_end 统一为 YYYY-MM-DD,Excel 日期序列值 PostgreSQL 不识别。
  • host_ip 提前去空格、去重。

如果 CSV 在数据库服务器本地,优先使用服务端路径的 COPY ,避免客户端中转;如果文件在客户端,使用 \copy(psql 元命令)或 COPY ... FROM STDIN 管道。对于压缩文件,可以配合 zcat 流式输入,减少磁盘 I/O。

九、日常运维:备份、恢复与监控

9.1 逻辑备份:pg_dump

自定义格式(推荐,支持并行恢复和选择性恢复):

bash 复制代码
pg_dump -U postgres -F c -f /backups/assetdb_$(date +%F).dump assetdb

仅备份结构 / 仅备份数据:

bash 复制代码
pg_dump -U postgres -s assetdb > assetdb_schema.sql      # 仅结构
pg_dump -U postgres -a assetdb > assetdb_data.sql        # 仅数据

全局对象(角色、表空间)用 pg_dumpall -g:

bash 复制代码
pg_dumpall -U postgres -g > /backups/globals.sql

全局对象与库级备份应分开管理,便于在新集群快速重建安全边界。

9.2 定时备份与保留策略

使用系统 cron 每日凌晨执行,并自动清理超过保留期的旧备份:

bash 复制代码
# 每天 02:00 备份,保留 30 天
0 2 * * * /usr/bin/pg_dump -U postgres -F c -f /backups/assetdb_$(date +\%F).dump assetdb && find /backups -name "assetdb_*.dump" -mtime +30 -delete

备份文件必须落到与数据库服务器不同的磁盘或网络存储,否则单机磁盘故障会同时带走数据和备份。

9.3 恢复操作

自定义格式的恢复:

bash 复制代码
# 先创建目标库
createdb -U postgres assetdb_restore

# 恢复
pg_restore -U postgres -d assetdb_restore /backups/assetdb_2026-11-18.dump

纯文本 SQL 的恢复:

bash 复制代码
psql -U postgres -d assetdb_restore -f /backups/assetdb_schema.sql

pg_restore 常用选项:-j 4 并行恢复,-c 恢复前先清理目标对象,-1 单事务恢复(一致性优先)。

9.4 备份不是"有就行":必须验证可恢复

未经验证的备份等于没有备份。 至少每季度做一次恢复演练:将最近的备份恢复到临时库,执行 SELECT count(*) 或业务关键查询,确认数据完整。pg_dump 是逻辑备份,使用可重复读快照,单次 dump 内部一致,但不能替代时间点恢复(PITR) ;如果需要"恢复到误删前一秒"的能力,需要配置 WAL 归档和 pg_basebackup 物理备份。

十、定时任务与业务层自动化(以租期提醒为例)

10.1 pg_cron:数据库内调度扫描

sql 复制代码
CREATE EXTENSION pg_cron;

SELECT cron.schedule(
    'lease-expiry-scan',
    '0 9 * * *',
    $$
    INSERT INTO lease_notifications (host_id, owner, lease_end)
    SELECT id, owner, lease_end
    FROM host_assets
    WHERE lease_end BETWEEN CURRENT_DATE AND CURRENT_DATE + INTERVAL '7 days'
      AND owner IS NOT NULL;
    $$
);

pg_cron 的职责边界是按时执行 SQL 并记录意图,不承担邮件发送。

10.2 外部脚本:读取队列并投递

bash 复制代码
psql -d assetdb -c "SELECT id, owner, lease_end FROM lease_notifications WHERE notified_at IS NULL;" \
| while read -r id owner lease_end; do
    echo "主机租期即将到期:${lease_end}" | mail -s "租期提醒" "${owner}@company.com"
    psql -d assetdb -c "UPDATE lease_notifications SET notified_at = now() WHERE id = ${id};"
done

数据库识别、脚本投递的分离设计,让 SMTP 凭据、邮件模板和退信处理都不侵入数据库,排障边界清晰。

十一、关键注意事项清单

1. 先确认包来源,再执行初始化。 发行版模块包用 postgresql-setup --initdb + systemctl start postgresql;PGDG 包用 postgresql-15-setup initdb + systemctl start postgresql-15。路径和服务名都不同。

2. 本机操作先过 peer 认证。 默认 pg_hba.conf 本地套接字使用 peer,必须 sudo -u postgres psql 进入。设置密码后,如需远程连接,再调整 pg_hba.conf 并重启服务。

3. 密码管理用 scram-sha-256,不要用明文 password 或 trust。 ALTER USER ... PASSWORD 修改的是数据库角色密码,不是 Linux 系统用户密码。

4. 不要长期用超级用户跑应用。 为应用创建专用角色,按"库连接 → 模式使用 → 表操作 → 序列使用"逐层授予最小权限,并用 ALTER DEFAULT PRIVILEGES 覆盖未来新建对象。

5. 大量数据录入走 COPY,不要逐行 INSERT。 标准顺序:建表不建索引 → COPY → 建索引 → ANALYZE。COPY 几乎总是比批量 INSERT 快。

6. 备份要可恢复、要验证。 pg_dump -F c 是首选日常备份方式;备份文件放到异机或网络存储;定期做恢复演练。pg_dump 不能替代 PITR,需要时间点恢复能力时补 WAL 归档 + pg_basebackup。

7. 离线环境准备机与目标机版本架构严格一致。 Anolis 8.6 + x86_64/aarch64 不可混用;yumdownloader --resolve --installroot 用空根目录强制解析全量依赖,避免漏包。

8. 改端口必须同步 SELinux 策略。 semanage port -a -t postgresql_port_t -p tcp <新端口>,否则服务可能静默启动失败。

9. 不要用裸 rpm -ivh。 用 dnf localinstall 自动排序依赖。

10. 导入后 ANALYZE 不能忘。 大批量写入后不更新统计信息,查询规划器可能选错执行计划。

十二、总结:一条从部署到运维的完整路径

复制代码
在线:PGDG 仓库 → 禁用发行版模块 → dnf install postgresql15-server
离线:yumdownloader --resolve --installroot → dnf localinstall → createrepo_c 建本地源
初始化:按包来源选对命令(postgresql-setup --initdb 或 postgresql-15-setup initdb)
连接入口:sudo -u postgres psql(peer 认证)
密码:ALTER USER ... PASSWORD(-c 方式写入脚本)
用户:CREATE USER + GRANT 最小权限 + ALTER DEFAULT PRIVILEGES
录入:少量 INSERT / 中等事务批量 / 大量 COPY(建表→COPY→建索引→ANALYZE)
备份:pg_dump -F c + cron 定时 + 异机存储 + 恢复演练
提醒:pg_cron 扫描入队 + 外部脚本发信

整条路径的设计原则可以概括为四句话:依赖复杂性收敛在联网准备这一个受控环节;密码与权限从第一天就按最小权限落地;数据录入永远让数据库走专设的快速路径而不是逐行 SQL;备份的价值不在"跑过",而在"验证过能恢复"。 守住这四点,Anolis 8.6 上的 PostgreSQL 就能以最低的运维心智负担长期稳定运行。

相关推荐
数据工匠老o1 小时前
数据库没死,业务卡住了:行锁等待、元数据锁、长事务的排查路径
数据库·算法·架构
Decay__1 小时前
SQLServer 优化案例集 —— 慢 SQL 优化、索引重构与参数调整收益对比
运维·数据库·sql·mysql·架构
CoderYanger1 小时前
Java EE 进阶:9.MyBatis 操作数据库(进阶)(第二弹)
java·数据库·面试·职场和发展·java-ee·tomcat·mybatis
龙腾AI白云2 小时前
具身智能的空间导航与未知环境探索
大数据·数据库·人工智能·机器学习·知识图谱
优化Henry2 小时前
LTE 站点 S1 链路反复闪断导致小区频闪退服故障排查
运维·网络·学习·信息与通信·tdd
ClouGence2 小时前
DBeaver太重,Navicat付费?试试这4款好用的开源数据库管理工具!
数据库·开源
manageengine3 小时前
服务器 CPU 100% 怎么排查:8 条命令从现象定位到根因
运维·服务器·cpu
字节跳动数据库3 小时前
火山引擎缓存数据库:如何构建超大规模缓存集群的无感弹性能力
数据库·人工智能·后端
分布式存储与RustFS3 小时前
RustFS 分片上传怎么配:大文件断点续传的最小可验证流程
运维·云原生·开源·对象存储·分布式存储·s3·性能基准