Ubuntu上pgAdmin网络配置说明

Ubuntu 上 pgAdmin 网络配置说明

一 架构与端口

• pgAdmin 4 在 Ubuntu 常见以两种方式部署：
  1. 桌面应用（本机使用）；
  2. 服务器模式 + Web 前端（通过浏览器访问）。
• 服务器模式通常使用 Apache 反向代理，默认站点路径为 /pgadmin4，常见访问端口为 80/443（HTTP/HTTPS）；若采用独立端口运行，常见为 5050。下表概览两种模式的网络要点：

上述端口与访问路径为 Ubuntu 22.04 上 pgAdmin4 服务器模式的常见实践；若使用独立端口，常见为 5050。

二 服务器模式网络配置步骤

• 安装与初始化
  • 添加官方仓库并安装：sudo apt install pgadmin4-web；随后执行：sudo /usr/pgadmin4/bin/setup-web.sh，按向导创建管理员邮箱与密码，并选择是否配置 Apache 反向代理。完成后即可通过浏览器访问。
• 访问与端口
  • 若由 Apache 托管：访问 http://<服务器IP>/pgadmin4（端口 80/443）；
  • 若使用独立端口：访问 http://<服务器IP>:5050。
• 防火墙放行
  • UFW：sudo ufw allow “Apache Full”（放行 80/443）；或 sudo ufw allow 5050/tcp（放行 5050）。
• 可选启用 HTTPS
  • 在 pgAdmin 配置或反向代理中启用 SSL/TLS，对外提供加密访问。

三 连接远程 PostgreSQL 的网络要点

• 数据库端配置
  • postgresql.conf：将 listen_addresses = ‘*’，允许监听所有接口；
  • pg_hba.conf：添加授权规则，例如 host all all 0.0.0.0/0 md5（按实际网段收紧为 /24、/32 更安全）；
  • 重启数据库：sudo systemctl restart postgresql。
• pgAdmin 端创建服务器连接
  • General：自定义名称；
  • Connection：Host 填数据库服务器 IP 或 FQDN，Port 5432，填写具备远程权限的数据库用户与密码，保存连接。

四 常见问题排查

• 无法打开 pgAdmin 页面
  • 确认服务运行：sudo systemctl status pgadmin4；
  • 核对访问地址与端口（/pgadmin4 或 :5050）；
  • 检查防火墙与云安全组是否放行 80/443/5050。
• 能打开页面但连不上数据库
  • 在数据库服务器上验证监听：ss -lntp | grep 5432；
  • 复核 listen_addresses 与 pg_hba.conf 规则是否允许客户端网段；
  • 从 pgAdmin 所在机器测试连通：nc -vz 数据库IP 5432；
  • 若走 SSH 隧道或跳板机，确认端口转发正确。

五 安全建议

• 限制来源网段：pg_hba.conf 中使用 /24、/32 等精确网段替代 0.0.0.0/0；
• 强制加密：为 pgAdmin 与数据库连接启用 SSL/TLS；
• 最小权限：为应用创建专用数据库用户并授予所需权限；
• 访问控制：仅开放必要端口（优先 443），禁用不必要服务与端口；
• 持续维护：定期更新 PostgreSQL 与 pgAdmin 至稳定版本。