结论：装对版本、初始化数据目录、改postgresql.conf和pg_hba.conf、设密码并开放5432端口——四步缺一不可；少一步远程连接必然失败，常见原因包括用系统旧源、漏initdb、listen_addresses与pg_hba.conf不匹配、密码未设或认证方式错误、防火墙或云安全组未放行。
postgresql.conf 和 pg_hba.conf 两处配置、设密码并开防火墙 5432 端口——四步缺一不可，少一步远程就连不上。
怎么装 PostgreSQL 才不踩坑
系统自带仓库的 PostgreSQL 版本通常太旧（比如 CentOS 7 自带 9.2），不支持现代认证方式或扩展，必须用官方源：
- CentOS/RHEL 8+：运行
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 - CentOS 7：换用阿里镜像源更稳，
sudo rpm -Uvh https://mirrors.aliyun.com/postgresql/repos/yum/reporpms/EL-7-x86_64/pgdg-redhat-repo-latest.noarch.rpm，再替换 repo 文件里的 URL - Ubuntu/Debian：加官方源比
apt install postgresql更可控，避免默认装错主版本
装完别急着启动——postgresql16-server 包只提供二进制，不自动初始化数据目录，跳过这步服务起得起来但根本没数据库。
为什么改了 listen_addresses 还连不上
因为 postgresql.conf 只管“听不听”，真正拦住连接的是 pg_hba.conf。常见错误：
-
listen_addresses = '*'写了，但pg_hba.conf里只有host all all 127.0.0.1/32 md5→ 只放行本地 - 追加规则写成
host all all 192.168.1.100 md5（漏了 CIDR 掩码）→ PostgreSQL 启动失败，日志报语法错误 - 新规则加在已有
local all all peer规则前面 → 永远匹配不到，白改
正确做法：用 sudo tee -a /var/lib/pgsql/16/data/pg_hba.conf 追加一行，确保在所有 host 规则末尾，例如：host all all 192.168.1.0/24 md5；改完必须 sudo systemctl reload postgresql-16，不是 restart。
postgres 用户远程登录为什么总提示密码错误
因为安装后 postgres 数据库角色默认无密码，本地靠系统级 peer 认证免密，远程必须走密码认证，且 pg_hba.conf 对应规则必须用 md5 或 scram-sha-256（PostgreSQL ≥ 10）。
- 切到
postgres系统用户：sudo -u postgres psql -U postgres - 在 psql 里执行：
ALTER USER postgres PASSWORD 'YourStrongPass123'; - 如果报
ERROR: role "postgres" does not exist，先查\du确认角色名；有些环境初始化后默认角色是postgres，但个别打包版本可能不同
密码设完，pg_hba.conf 里对应那行认证方式不能是 trust，否则密码被忽略；也不能是 ident，它依赖系统用户名映射，远程不生效。
验证监听和防火墙是否真通了
别只信 systemctl status 显示 active，要确认端口实际在监听：
- 查监听状态：
sudo ss -tlnp | grep :5432，看到*:5432或具体 IP:5432 才算生效 - 防火墙必须放行 TCP 5432：
sudo firewall-cmd --add-port=5432/tcp --permanent && sudo firewall-cmd --reload（CentOS/RHEL）；Ubuntu 用sudo ufw allow 5432 - 云服务器额外检查安全组——很多连不上是因为云平台层面没放行，和本地防火墙无关
- SELinux 默认会拦 PostgreSQL 网络访问，临时关掉测试：
sudo setenforce 0；生产环境需配策略，不是直接禁用
最常被忽略的是：改完配置不 reload、设了密码但认证方式没同步改、开了防火墙却忘了云安全组。三者任缺其一，客户端看到的都是“Connection refused”或“password authentication failed”。
