推荐使用系统包管理器安装:CentOS/RHEL通过PGDG YUM仓库安装(如sudo yum install postgresql12-server),Ubuntu/Debian用apt install postgresql,自动创建用户、服务及配置,省事且稳定;手动编译适用于定制或离线场景,但需自行处理用户、权限、服务等细节。

直接用系统包管理器装,最省事也最不容易出错;手动编译或解压二进制包适合有定制需求或离线环境,但得自己管用户、权限、服务、路径,一环漏了就起不来。
用 YUM 安装 PostgreSQL(CentOS/RHEL)
这是生产环境首选方式:自动建 postgres 用户、配好 systemd 服务、数据目录和日志路径都按规范设好,后续维护成本低。
- 先装官方 YUM 源(注意 EL 版本号要匹配你的系统,比如 CentOS 7 对应
EL-7-x86_64):sudo yum install -y https://download.postgresql.org/pub/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm - 再装服务端和常用扩展:
sudo yum install -y postgresql12-server postgresql12-contrib(版本号可换成15或16) - 初始化数据库集群:
sudo /usr/pgsql-12/bin/postgresql-12-setup initdb—— 这步会创建/var/lib/pgsql/12/data目录并生成默认配置 - 启用并启动服务:
sudo systemctl enable postgresql-12 && sudo systemctl start postgresql-12
常见错误:Failed to initialize database 多因磁盘空间不足或 /var/lib/pgsql 权限不对;Unit postgresql-12.service not found 是包名写错(比如漏了版本号)或源没装成功。
用 APT 安装 PostgreSQL(Ubuntu/Debian)
比 YUM 更“无感”:装完服务就跑着,postgres 用户和 /etc/postgresql/*/main/ 配置结构全自动生成,适合快速验证或开发机。
- 加官方源(注意
$(lsb_release -cs)要能正确输出如focal或jammy):echo "deb https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list - 导入密钥:
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add - - 更新并安装:
sudo apt-get update && sudo apt-get install -y postgresql postgresql-contrib
装完直接切用户验证:sudo -u postgres psql -c "SELECT version();"。如果卡住不动,大概率是 postgresql.service 没起来,查 sudo systemctl status postgresql 看报错。
改配置前必须动的两个文件
无论哪种安装方式,远程访问、监听地址、认证规则都得靠改这俩文件生效,且改完必须 reload 或 restart 服务。
-
postgresql.conf:控制监听行为。关键项是listen_addresses = 'localhost'(默认只本机),要远程就得改成'*'或具体 IP;port = 5432别被其他进程占了 -
pg_hba.conf:决定谁、从哪、用什么方式连哪个库。加一行允许远程密码登录:host all all 0.0.0.0/0 md5(生产环境别用0.0.0.0/0,应限定 IP 段)
改完执行 sudo systemctl reload postgresql(或 restart)才生效。别忘了防火墙放行端口:sudo firewall-cmd --add-port=5432/tcp --permanent && sudo firewall-cmd --reload(CentOS)或 sudo ufw allow 5432(Ubuntu)。
手动安装二进制包或源码的坑点
这类方式自由度高,但所有细节都得自己扛:用户权限、环境变量、动态库路径、服务脚本、开机自启……稍不注意就变成“能 initdb,但 pg_ctl start 不起来”。
- 二进制包(如
postgresql-10.23-1-linux-x64-binaries.tar.gz)解压后,initdb必须用对应目录下的二进制执行,不能用系统 PATH 里旧版的 - 源码编译时,
--prefix和--with-pgport一旦定死就不能改端口,得重编;make world很耗时,make install-world才装 contrib 扩展 - 手动启停务必用
pg_ctl并指定-D数据目录,否则它可能去读默认路径,报no data directory
最容易被忽略的是:postgres 用户的 $HOME 下没设 PGDATA 和 PATH,导致切过去后 psql 找不到,initdb 写错位置——这些细节在包管理器安装里全帮你兜底了。











