Linux 版 pgAdmin 连接数据库实操指南
一 准备与安装
- 在目标数据库服务器上安装并启动 PostgreSQL，确认监听端口为 5432，并确保服务处于运行状态（如 systemctl start/status postgresql）。
- 在客户端 Linux 上安装 pgAdmin 4（桌面版或 Web 模式均可）。桌面版可直接运行启动程序；Web 模式常见做法是通过 pip3/pip 安装后执行初始化，再用 Nginx + uWSGI 提供服务。
- 启动 pgAdmin 后，使用浏览器访问其登录页（桌面版会自动打开；Web 模式如配置为 https://localhost），完成管理员账户设置。
二 在 pgAdmin 中新建服务器连接
- 在左侧对象浏览器中右键 Servers → Create → Server…。
- General 页：填写 Name（自定义名称）。
- Connection 页：填写
- Host name/address：数据库服务器 IP 或域名
- Port：5432（若自定义请保持一致）
- Maintenance database：如 postgres
- Username / Password：具有登录权限的数据库用户
- 点击 Save 保存并尝试连接。
三 服务器端必须配置
- 修改 postgresql.conf：将
- listen_addresses = ‘*’（或指定服务器 IP），允许监听来自外部的连接。
- 修改 pg_hba.conf：添加允许来源网段的规则，例如
- host all all 0.0.0.0/0 md5（放行所有 IPv4，生产环境建议改为具体网段）
- 重启数据库使配置生效：
- sudo systemctl restart postgresql
- 创建可远程登录的数据库用户（示例）：
- sudo -u postgres createuser --interactive（按提示设置用户名与密码，并可选择是否允许从任意主机连接）
四 防火墙与网络放行
- 放行数据库端口 5432/tcp：
- firewalld：sudo firewall-cmd --zone=public --add-port=5432/tcp --permanent && sudo firewall-cmd --reload
- ufw：sudo ufw allow 5432/tcp
- iptables：sudo iptables -A INPUT -p tcp --dport 5432 -j ACCEPT
- 云服务器需同时检查 安全组/NACL 是否允许入站 5432/tcp。
五 常见错误与快速排查
- 连接超时/被拒绝：检查服务器防火墙、云安全组、以及 pg_hba.conf / postgresql.conf 是否已正确修改并重启数据库。
- 认证失败：核对 用户名/密码 与 pg_hba.conf 的认证方式（如 md5/peer/scram-sha-256）；必要时重置密码。
- 服务未启动：执行 sudo systemctl status postgresql 查看状态并启动。
- 网络问题：确认 IP/端口 可达，排查路由、子网掩码、以及服务器监听地址。
- SSL/TLS 错误：若服务器启用 SSL，在 pgAdmin 连接参数中按实际配置 SSL 模式（require/prefer 等）。