CentOS/RHEL 7/8需先配置PostgreSQL官方YUM仓库(推荐阿里云镜像),再安装指定版本服务端(如postgresql15-server),手动执行postgresql-15-setup initdb初始化,最后启动服务并配置监听与访问规则。

CentOS/RHEL 7/8 和 Ubuntu/Debian 的安装路径、命令和默认行为完全不同,不能混用;选错包或跳过初始化步骤会导致 pg_ctl 启动失败或 psql 连不上本地数据库。
CentOS/RHEL 系统用 yum 安装 PostgreSQL(含仓库配置)
PostgreSQL 官方不直接提供 CentOS 默认源里的包,必须先配置第三方仓库。阿里云镜像源最稳定,避免访问 download.postgresql.org 超时或证书错误。
- 执行
rpm -Uvh https://mirrors.aliyun.com/postgresql/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm导入仓库 GPG key(若提示 NOKEY,加--force --nodeps可临时绕过,但不推荐长期忽略签名验证) - 替换仓库 baseurl:
sed -i "s@https://download.postgresql.org/pub@https://mirrors.aliyun.com/postgresql@g" /etc/yum.repos.d/pgdg-redhat-all.repo - 运行
yum makecache刷新缓存后,再安装服务端:yum install -y postgresql15-server(注意:版本号要显式指定,如postgresql14-server或postgresql15-server,不写版本默认可能装旧版或报错) - 初始化数据库目录必须手动执行:
postgresql-15-setup initdb(RHEL/CentOS 7+ 使用该封装脚本;直接跑initdb会因权限/路径问题失败)
Ubuntu/Debian 系统用 apt 安装 PostgreSQL(无需额外源)
Ubuntu 20.04+ 和 Debian 11+ 自带较新版本的 PostgreSQL,但默认只装客户端 postgresql-client;服务端需显式安装,且用户和数据目录由包管理器自动创建,不能跳过 systemctl enable 步骤。
- 更新源并安装服务端:
sudo apt update && sudo apt install -y postgresql postgresql-contrib - 安装后服务已自动启动,验证用:
sudo systemctl is-active postgresql(应返回active) - 默认超级用户是系统用户
postgres,不是空密码——首次登录需切换用户:sudo -u postgres psql,此时无密码提示,直接进psql提示符 - 若改过
postgres系统用户的密码,psql将拒绝连接,因为默认认证方式是peer,不走密码;要改密码得先进入psql再执行:ALTER USER postgres PASSWORD 'xxx';
安装后必须改的两个配置文件(远程访问前提)
即使安装成功,PostgreSQL 默认只监听本地 Unix socket 和 127.0.0.1,外部机器连不上;改错一个字符就导致服务起不来。
- 修改
/var/lib/pgsql/15/data/postgresql.conf(CentOS)或/etc/postgresql/*/main/postgresql.conf(Ubuntu),找到listen_addresses行,改为:listen_addresses = 'localhost,192.168.3.166'(填本机实际 IP,不要用0.0.0.0暴露全网) - 修改
pg_hba.conf:在 IPv4 local rules 下新增一行,例如允许同网段访问:host all all 192.168.3.0/24 md5;注意顺序——规则从上到下匹配,放太下面会被前面的reject或local规则拦截 - 改完必须 reload:
sudo systemctl reload postgresql(不是restart,避免中断现有连接) - 防火墙要放行
5432端口:sudo firewall-cmd --add-port=5432/tcp --permanent && sudo firewall-cmd --reload(CentOS)或sudo ufw allow 5432(Ubuntu)
常见启动失败原因与快速定位方法
systemctl start postgresql 报 “failed” 不代表配置错,大概率是数据目录权限、磁盘满、端口被占或 initdb 没运行过。
- 看日志最准:
sudo tail -n 20 /var/lib/pgsql/15/data/log/postgresql-Tue.log(CentOS)或sudo journalctl -u postgresql -n 30 --no-pager(Ubuntu) - 检查数据目录归属:
ls -ld /var/lib/pgsql/15/data必须属用户postgres:postgres,否则pg_ctl拒绝启动 - 检查端口占用:
sudo ss -tlnp | grep :5432,若有其他进程(比如旧版 PostgreSQL 或 Redis),得先停掉 - 磁盘空间不足时,
initdb会静默失败,df -h /var/lib/pgsql看是否 100%;PostgreSQL 启动时也会因无法写 WAL 日志而卡住
最容易被忽略的是:不同发行版的 postgresql.conf 和 pg_hba.conf 路径不统一,硬编码路径去编辑会找错文件;每次操作前先用 pg_config --sysconfdir 查真实位置,比凭经验猜可靠得多。











