Ubuntu 上用 pgAdmin 连接 PostgreSQL 的步骤
一 安装与启动
- 更新软件包索引并安装数据库与工具：sudo apt update && sudo apt install postgresql postgresql-contrib。
- 启动 PostgreSQL 服务：sudo systemctl start postgresql；如需开机自启：sudo systemctl enable postgresql。
- 为默认超级用户设置密码（如尚未设置）：sudo -u postgres psql -c “ALTER USER postgres WITH PASSWORD ‘your_password’;”。
二 启动 pgAdmin 并登录
- 桌面方式：在应用菜单中打开 pgAdmin 4。
- 命令行方式：在终端执行 pgadmin4 启动服务。
- 访问 Web 界面：若以服务器模式运行，浏览器访问 http://127.0.0.1:5050（部分安装为 http://localhost 或 https://localhost），使用创建 pgAdmin 时设置的管理员邮箱与密码登录。
三 在 pgAdmin 中新建服务器连接
- 左侧面板右键 Servers → Create → Server…。
- General 页：输入名称（如：My PostgreSQL Server）。
- Connection 页：填写连接参数
- Host name/address：localhost（本机）或目标服务器 IP/域名
- Port：5432（PostgreSQL 默认端口）
- Maintenance database：postgres（常用默认库）
- Username：postgres（或具备权限的其他用户）
- Password：对应用户密码
- 点击 Save 保存并尝试连接。
四 远程连接与防火墙设置
- 修改 PostgreSQL 客户端认证：编辑 /etc/postgresql/12/main/pg_hba.conf，在末尾添加（示例允许所有来源使用口令认证）：host all all 0.0.0.0/0 md5；保存后重启数据库：sudo systemctl restart postgresql。
- 调整监听地址：编辑 /etc/postgresql/12/main/postgresql.conf，确保有 listen_addresses = ‘*’（或包含服务器 IP），然后重启数据库。
- 系统防火墙放行端口：sudo ufw allow 5432/tcp；云服务器还需在安全组放行 5432。
- 在 pgAdmin 的 Connection 页将 Host 改为服务器 公网/内网 IP，使用具备远程权限的数据库用户连接。
五 常见故障排查
- 无法连接服务器：核对 Host/IP、端口 5432、用户名/密码；确保 PostgreSQL 正在运行（sudo systemctl status postgresql）。
- 认证失败：检查 pg_hba.conf 的认证方式（如 md5）与对应用户密码是否正确；必要时重置密码并重启数据库。
- 端口不通：确认防火墙/安全组已放行 5432/tcp，且云实例的安全组规则允许来源 IP。
- 页面无法打开：确认 pgAdmin 服务已启动（pgadmin4），并使用正确的访问地址（如 http://127.0.0.1:5050 或 http://localhost）。