Ubuntu 上使用 pgAdmin 管理 PostgreSQL 实操指南
一 安装与启动
-
方式一 APT 官方仓库安装（推荐）
- 导入 PostgreSQL 官方 APT 源并安装：
- sudo sh -c ‘echo “deb https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main” > /etc/apt/sources.list.d/pgdg.list’
- wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
- sudo apt update
- sudo apt install pgadmin4
- 首次配置与启动：
- 运行 sudo pgadmin4-setup，按提示设置 pgAdmin 的主密码。
- 访问地址：http://localhost/pgadmin4（桌面环境可直接运行命令：pgadmin4）。
-
方式二 pip 安装（灵活但需手动维护）
- 安装依赖与 pgAdmin4：
- sudo apt update
- sudo apt install python3-pip libpq-dev python3-dev libxml2-dev libxslt1-dev libldap2-dev libsasl2-dev libffi-dev
- pip3 install --upgrade pip
- pip3 install pgadmin4
- 初始化与启动：
- 方式 A（常见）：python3 ~/.local/lib/python3.*/site-packages/pgadmin4/setup.py
- 方式 B（虚拟环境）：
- python3 -m venv ~/pgadmin4 && source ~/pgadmin4/bin/activate
- pip install --upgrade pip wheel pgadmin4
- 启动服务：
- 桌面模式：python3 ~/.local/lib/python3.*/site-packages/pgadmin4/pgAdmin4.py
- 或作为 WSGI 服务运行（配合 uWSGI/Nginx，见下文“进阶部署”）。
二 连接 PostgreSQL
- 准备数据库侧
- 启动 PostgreSQL：sudo systemctl start postgresql
- 设置 postgres 用户密码：sudo -u postgres psql -c “ALTER USER postgres WITH PASSWORD ‘your_password’;”
- 如需远程连接，编辑配置文件（版本号以实际为准，如 12/main）：
- /etc/postgresql/12/main/postgresql.conf：将 listen_addresses 改为 ‘*’
- /etc/postgresql/12/main/pg_hba.conf：在末尾添加 host all all 0.0.0.0/0 md5
- 重启数据库：sudo systemctl restart postgresql
- 在 pgAdmin 中添加服务器
- 左侧 Servers 右键 → Create → Server
- General：输入名称（如：Local PostgreSQL）
- Connection：
- Host name/address：localhost 或服务器 IP
- Port：5432
- Maintenance database：postgres
- Username/Password：如 postgres/your_password
- Save 后即可查看库、表、执行 SQL。
三 常用管理操作
- 创建数据库：在左侧目标实例下右键 Databases → Create → Database，填写名称保存。
- 创建表：进入库 → Schemas → public → Tables → Create → Table，在 Columns 页签添加列并保存。
- 查询与编辑：顶部菜单 Tools → Query Tool，执行 INSERT/SELECT/UPDATE/DELETE 等语句。
- 备份与恢复：使用 pgAdmin 提供的备份/还原工具执行对象级或库级备份与恢复（适合日常运维）。
四 进阶部署与安全加固
- 远程访问 pgAdmin（桌面/服务器模式）
- 防火墙放行：sudo ufw allow 5050/tcp（若 pgAdmin 运行在 5050 端口）
- 访问地址：http://服务器IP:5050（桌面模式直接运行 pgadmin4 也会启动本地服务）
- 使用 Nginx + uWSGI 部署（生产推荐）
- 生成自签证书：
- sudo mkdir -p /etc/ssl/private
- sudo openssl req -x509 -nodes -days 365 -newkey rsa:2048
-keyout /etc/ssl/private/server-key.pem -out /etc/ssl/private/server-cert.pem -subj “/CN=localhost”
- Nginx 反向代理示例（/etc/nginx/sites-available/default 的 server 块内）：
- location / {
include uwsgi_params;
uwsgi_pass unix:/var/run/pgadmin4/pgadmin4.sock;
}
- 重启服务：sudo systemctl restart nginx 与 pgadmin4-web（或相应服务名）。
五 常见问题排查
- 无法远程连接数据库
- 核对 postgresql.conf 的 listen_addresses=‘*’、pg_hba.conf 的 host … 0.0.0.0/0 md5、以及云服务器安全组/本机防火墙是否放行 5432/tcp。
- 浏览器访问 pgAdmin 失败
- 确认服务已启动（桌面模式运行 pgadmin4；Web 模式检查端口 5050 或 /pgadmin4 路径与防火墙）。
- 认证失败
- 核对 pg_hba.conf 的认证方式（如 md5/peer/scram-sha-256）、数据库用户密码是否正确；必要时在 psql 中 ALTER USER 重置密码。
- 版本与路径差异
- 配置文件路径、Python 版本（如 python3.10）、site-packages 路径会随系统与版本变化，优先使用系统包管理器（APT）获取匹配版本。
