ubuntu下pgadmin如何配置

在 Ubuntu 下配置 pgAdmin（通常是 pgAdmin 4）一般分为安装和 连接 PostgreSQL 两部分。下面以 Ubuntu 20.04 / 22.04 为例说明。

一、安装 pgAdmin 4

方法一：通过官方 APT 仓库安装（推荐）

# 1. 安装依赖
sudo apt update
sudo apt install -y curl ca-certificates gnupg

# 2. 添加 pgAdmin 官方仓库
curl -fsSL https://www.pgadmin.org/static/packages_pgadmin_org.pub | \
  sudo gpg --dearmor -o /usr/share/keyrings/packages-pgadmin-org.gpg

echo "deb [signed-by=/usr/share/keyrings/packages-pgadmin-org.gpg] \
https://ftp.postgresql.org/pub/pgadmin/pgadmin4/apt/$(lsb_release -cs) pgadmin4 main" | \
  sudo tee /etc/apt/sources.list.d/pgadmin4.list

# 3. 安装
sudo apt update
sudo apt install -y pgadmin4

上面的 pgadmin4 会安装 桌面版 + Web 版

方法二：仅安装 Web 版（服务器常用）

sudo apt install -y pgadmin4-web

二、初始化 pgAdmin（Web 版必须）

如果你是 Web 版，需要初始化：

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

按提示设置：

管理员邮箱
管理员密码

然后访问：

http://localhost/pgadmin4

三、安装 PostgreSQL（如果还没装）

sudo apt install -y postgresql postgresql-contrib

启动服务：

sudo systemctl start postgresql
sudo systemctl enable postgresql

四、配置 PostgreSQL 允许连接

1. 修改监听地址

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

修改：

listen_addresses = 'localhost'
# 或
listen_addresses = '*'

2. 配置客户端认证

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

本地连接示例：

host    all    all    127.0.0.1/32    md5
host    all    all    ::1/128         md5

修改后重启：

sudo systemctl restart postgresql

五、在 pgAdmin 中连接数据库

1. 打开 pgAdmin

桌面版：菜单搜索 pgAdmin 4
Web 版：浏览器打开 http://localhost/pgadmin4

2. 添加服务器

右侧 Servers → 右键 → Register → Server
General：
- Name：自定义（如 LocalPG）
Connection：
- Host：127.0.0.1
- Port：5432
- Maintenance database：postgres
- Username：postgres
- Password：安装 PG 时设置的密码

✅ 点击 Save

六、常见问题

❌ 登录 PostgreSQL 被拒绝

sudo -u postgres psql

修改密码：

ALTER USER postgres PASSWORD 'newpassword';

❌ Web 页面打不开

检查 Apache：

sudo systemctl status apache2

❌ pgAdmin 很慢

使用桌面版
或增加服务器内存

如果你告诉我：

Ubuntu 版本
pgAdmin 桌面版 or Web 版
是否远程连接 PostgreSQL

我可以给你 更精确的配置方案。