Linux版pgAdmin如何连接数据库

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 等）。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！