如何安装Ubuntu下PgAdmin

在 Ubuntu 下安装 pgAdmin（PostgreSQL 的图形化管理工具）常见有三种方式，最推荐的是 APT 安装 pgAdmin 4（Web 模式）。下面按常用程度给你详细说明。

一、通过 APT 安装 pgAdmin 4（推荐 ✅）

适用于 Ubuntu 20.04 / 22.04 / 24.04。

1️⃣ 安装 PostgreSQL 官方仓库（推荐）

pgAdmin 通常与 PostgreSQL 官方源一起使用，版本更新。

sudo apt update
sudo apt install curl ca-certificates gnupg -y

导入 PostgreSQL 官方 GPG 密钥：

curl https://www.postgresql.org/media/keys/ACCC4CF8.asc | gpg --dearmor | sudo tee /usr/share/keyrings/postgresql-keyring.gpg > /dev/null

添加仓库（以 Ubuntu 22.04 为例）：

echo "deb [signed-by=/usr/share/keyrings/postgresql-keyring.gpg] http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" | sudo tee /etc/apt/sources.list.d/pgdg.list

更新软件源：

sudo apt update

2️⃣ 安装 pgAdmin 4

sudo apt install pgadmin4 -y

安装完成后，系统会提供 Web 模式 的 pgAdmin。

3️⃣ 配置 pgAdmin 4（首次使用）

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

按提示操作：

设置 pgAdmin 登录邮箱
设置密码

4️⃣ 启动并使用 pgAdmin 4

在浏览器中访问：

http://localhost/pgadmin4

或：

http://127.0.0.1/pgadmin4

✅ 输入刚才设置的邮箱和密码即可登录。

二、通过 Python（pip）安装 pgAdmin 4（不推荐新手）

适合开发环境，但配置复杂。

sudo apt install python3 python3-pip python3-venv -y
python3 -m venv pgadmin4
source pgadmin4/bin/activate
pip install pgadmin4

然后手动运行：

pgadmin4

⚠️ 不推荐生产环境使用。

三、通过 Docker 安装 pgAdmin 4（服务器常用 ✅）

如果你已安装 Docker：

docker run -d \
  --name pgadmin \
  -p 5050:80 \
  -e PGADMIN_DEFAULT_EMAIL=admin@admin.com \
  -e PGADMIN_DEFAULT_PASSWORD=admin \
  dpage/pgadmin4

访问：

http://localhost:5050

四、连接 PostgreSQL 数据库

在 pgAdmin 中：

点击 Add New Server
填写：
- Host：localhost
- Port：5432
- Username：postgres
- Password：安装 PostgreSQL 时设置的密码

五、常见问题

❓ pgAdmin 打不开？

sudo systemctl restart apache2

❓ 忘记 pgAdmin 密码？

重新运行：

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

六、总结推荐方案

场景	推荐方式
本地 / 桌面	APT 安装
服务器	Docker
开发测试	Docker / pip

如果你愿意，可以告诉我：

Ubuntu 版本
是否已安装 PostgreSQL
本机还是服务器

我可以给你 最合适的一套安装命令 ✅