宝塔面板中PostgreSQL连不上，八成因pg_hba.conf配置错误或未生效：需通过宝塔数据库页面定位文件路径，用VSCode等工具编辑，在IPv4区块后添加如“host all all 192.168.1.0/24 md5”规则，改后必须重启服务并同步检查postgresql.conf的listen_addresses、防火墙及云安全组是否放行5432端口。
宝塔面板里 PostgreSQL 连不上，八成是 pg_hba.conf 没配对——不是没改，就是改了没生效，或者改得不安全、不匹配你的连接方式。
怎么找到并安全编辑 pg_hba.conf
宝塔安装的 PostgreSQL 数据目录通常在 /www/server/pgsql/data（Linux）或 C:Program FilesPostgreSQL\data（Windows）。别靠猜路径，直接在宝塔「数据库」页面点开 PostgreSQL 对应条目，看「配置文件」链接，它会跳转到正确的 pg_hba.conf 文件位置。
用宝塔自带的文件编辑器打开它，或下载到本地用 VSCode 编辑（千万别用 Windows 记事本，容易存成 GBK 编码导致乱码）。
- 必须加在 IPv4 local connections 区块之后，不能插在注释中间
- 每行末尾不能有多余空格，
md5前后各一个空格 - 如果客户端是局域网 IP（比如
192.168.1.100），就写192.168.1.0/24；如果是固定公网 IP，用X.X.X.X/32 - 临时调试可加一行：
host all all 0.0.0.0/0 md5，但上线前务必删掉或收紧范围
pg_hba.conf 改完连不上？检查这三件事
改完文件 ≠ 生效。PostgreSQL 不会热加载认证规则，必须重启服务或 reload 配置。
- 在宝塔「数据库」页点击 PostgreSQL 的「重启」按钮（最稳妥）
- 或者 SSH 进去执行：
sudo systemctl restart postgresql（Linux）或在 Windows 服务管理器里重启postgresql-x64-16类似名称的服务 - 验证是否生效：连上
psql -U postgres后执行SELECT * FROM pg_hba_file_rules();，看新规则是否出现在结果里 - 常见错误：改了
pg_hba.conf却忘了同步改postgresql.conf中的listen_addresses，导致压根没监听外网请求
为什么用 md5 而不用 trust 或 password
trust 表示“来者不拒”，只要 IP 匹配就放行，毫无密码校验，生产环境禁用；password 会以明文传密码，中间任何网络节点都可能截获；md5 是唯一兼顾安全与兼容的选项——客户端发的是密码的 MD5 哈希值，服务端比对哈希，传输过程不暴露原始密码。
- Prisma 连接时若提示
shadow database错误，大概率是因为你用的账号没 superuser 权限，而 Prisma migrate 需要建 shadow db，此时必须确保pg_hba.conf允许该用户以md5方式连postgres库 - Navicat、DBeaver 等工具默认走
md5，如果配成scram-sha-256（PostgreSQL 10+ 默认），旧客户端可能握手失败 - 宝塔面板本身不干预认证方式，它只管启停服务，所有策略都在配置文件里
防火墙和宝塔双重放行缺一不可
即使 pg_hba.conf 和 postgresql.conf 都对了，Linux 服务器的 firewalld/ufw、云厂商的安全组、Windows 防火墙，三者中任一关卡都会让连接卡在 Connection refused。
- 宝塔「安全」页面 → 「放行端口」→ 添加
5432（不是 5422，那是错的） - SSH 执行
sudo ufw status（Ubuntu）或sudo firewall-cmd --list-ports（CentOS），确认 5432 在列表中 - 阿里云/腾讯云控制台 → 安全组 → 入方向规则 → 添加 TCP:5432，源 IP 设为你的办公 IP 或
0.0.0.0/0（仅测试） - Windows 用户注意：宝塔 Windows 版自带防火墙模块，也要手动放行 5432
真正容易被忽略的是 reload 和防火墙的组合动作——改完 pg_hba.conf 后只重启 PostgreSQL 服务，却忘了宝塔安全页没放行端口，或者放行了但云安全组还锁着。连不通时，先 telnet your-server-ip 5432 看通不通，再查日志（/www/server/pgsql/data/log/ 下最新 postgresql-*.log），错误信息基本都指向具体哪一步漏了。
