温馨提示×

Ubuntu怎么配置PgAdmin

小樊
45
2026-08-31 19:43:58
栏目: 智能运维

在 Ubuntu 上配置 PgAdmin(以 PgAdmin 4 为例,目前最常用)通常分为 安装基础配置 两部分。下面给你一套清晰、可直接照做的步骤。


一、安装 PostgreSQL(如果还没装)

PgAdmin 是 PostgreSQL 的管理工具,需要先有 PostgreSQL。

sudo apt update
sudo apt install postgresql postgresql-contrib -y

安装完成后,PostgreSQL 默认会:

  • 创建一个 postgres 系统用户
  • 监听 localhost:5432

二、安装 PgAdmin 4(推荐方式:APT 官方源)

1. 添加 PgAdmin 官方仓库

curl -fsS https://www.pgadmin.org/static/packages_pgadmin_org.pub | \
  sudo gpg --dearmor -o /usr/share/keyrings/packages-pgadmin-org.gpg

sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/packages-pgadmin-org.gpg] https://ftp.pgadmin.org/pub/pgadmin/pgadmin4/apt/ $(lsb_release -cs) pgadmin4" > /etc/apt/sources.list.d/pgadmin4.list'

sudo apt update

2. 安装 PgAdmin 4

sudo apt install pgadmin4 -y

这会安装:

  • 桌面模式pgadmin4-desktop
  • Web 模式pgadmin4-web

如果你只想要 Web 版:

sudo apt install pgadmin4-web -y

三、配置 PgAdmin(Web 模式,最常用)

1. 初始化 Web 模式

sudo /usr/pgadmin4/bin/setup-web.sh

过程中会提示:

  • 设置 登录邮箱(管理员账号)
  • 设置 登录密码

完成后访问:

http://localhost/pgadmin4

四、连接 PostgreSQL 数据库

  1. 打开 PgAdmin
  2. 点击 Add New Server
  3. 配置:
    • General
      • Name: localhost
    • Connection
      • Host: 127.0.0.1
      • Port: 5432
      • Maintenance DB: postgres
      • Username: postgres
      • Password: (你设置的 postgres 密码)

如果不知道 postgres 密码:

sudo -u postgres psql
ALTER USER postgres PASSWORD 'newpassword';

五、允许远程连接(可选)

1. 修改 PostgreSQL 配置

sudo nano /etc/postgresql/*/main/postgresql.conf

修改:

listen_addresses = '*'

2. 修改 pg_hba.conf

sudo nano /etc/postgresql/*/main/pg_hba.conf

添加:

host    all    all    0.0.0.0/0    md5

3. 重启服务

sudo systemctl restart postgresql

六、常见问题

PgAdmin 打不开?

sudo systemctl status apache2
sudo systemctl restart apache2

忘记 PgAdmin 密码?

sudo /usr/pgadmin4/bin/reset-password.sh

如果你是想:

  • 只用桌面版
  • Docker 安装 PgAdmin
  • 服务器无界面环境配置

可以告诉我你的使用场景,我可以给你更精准的方案。

0