温馨提示×

ubuntu中pgadmin如何连接数据库

小樊
44
2025-09-22 17:54:56
栏目: 智能运维

1. 安装pgAdmin
在Ubuntu上,通过包管理器快速安装pgAdmin4:更新包列表后,执行sudo apt install pgadmin4命令即可完成安装。

2. 启动pgAdmin
安装完成后,可通过以下两种方式启动:

  • 图形界面:在Ubuntu应用菜单中搜索“pgAdmin4”并点击启动;
  • 终端命令:直接输入pgadmin4,启动后会自动打开默认浏览器并进入web管理界面(部分版本可能需要手动访问http://localhost:5050)。

3. 添加服务器连接
启动pgAdmin后,按照以下步骤配置数据库连接:

  • 定位节点:在左侧“Browser”面板的“Servers”节点上右键点击;
  • 创建服务器:选择“Create”→“Server…”,弹出配置对话框;
  • 填写基本信息:在“General”标签页,输入服务器名称(如“MyPostgresServer”,仅本地标识,不影响连接);
  • 配置连接参数:切换至“Connection”标签页,填写以下关键信息:
    • Host name/address:数据库服务器地址(本地数据库填localhost,远程数据库填IP或域名);
    • Port:PostgreSQL默认端口为5432(若修改过端口,需填写实际端口);
    • Maintenance database:维护数据库(通常为postgres,用于初始连接);
    • Username:具有连接权限的数据库用户名(如postgres超级用户或其他授权用户);
    • Password:对应用户的密码(若需保存密码,可勾选“Save password”选项);
  • 保存配置:点击“Save”按钮,完成服务器添加。

4. 测试与使用连接

  • 测试连接:添加完成后,在“Servers”面板中展开新创建的服务器节点,右键点击服务器名称,选择“Test connection”(测试连接),若弹出绿色提示“Connection successful”,则表示配置正确;
  • 访问数据库:双击服务器节点下的“Databases”文件夹,可查看该服务器下的所有数据库;双击目标数据库(如postgres),进入数据库管理界面,即可执行SQL查询、创建表等操作。

5. 常见问题排查

  • PostgreSQL服务未运行:通过sudo systemctl status postgresql命令检查服务状态,若未运行,执行sudo systemctl start postgresql启动;
  • 防火墙拦截:若连接远程数据库,需确保防火墙允许PostgreSQL端口(默认5432)的通信。Ubuntu系统可使用sudo ufw allow 5432/tcp命令开放端口;
  • PostgreSQL配置问题:若仍无法连接,需检查PostgreSQL的pg_hba.conf(控制客户端认证)和postgresql.conf(控制监听地址)配置文件:
    • pg_hba.conf:添加host all all 0.0.0.0/0 md5(允许所有IP通过md5加密连接,生产环境建议限制IP范围);
    • postgresql.conf:修改listen_addresses = '*'(允许PostgreSQL监听所有网络接口);
      修改后,重启PostgreSQL服务:sudo systemctl restart postgresql

0