本文基于一次真实的主机资产管理系统落地过程整理,覆盖部署、初始化、密码与权限、数据录入、日常运维与备份恢复 的完整闭环。核心结论先行:生产环境首选 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 就能以最低的运维心智负担长期稳定运行。