在 Ubuntu 上使用 pgAdmin 统一管理多数据库
一 架构与准备
- 概念要点：一个 PostgreSQL 实例（常被称作一个“cluster”）可承载多个逻辑数据库；这些数据库共享实例级的角色（Login/Group Roles）与表空间（Tablespaces）。pgAdmin 左侧对象浏览器以层级展示：Servers → 实例 → Databases / Login Roles / Tablespaces，便于集中管理多实例与多库。为便于团队协作，可将连接定义导出为 JSON 并在其他机器导入。
- 安装方式（Ubuntu 22.04 推荐）：使用官方 APT 仓库安装，便于获得更新与依赖管理。
- 导入 GPG 密钥并添加仓库：
- wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
- echo “deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main” | sudo tee /etc/apt/sources.list.d/pgdg.list
- 安装与启动：
- sudo apt update && sudo apt install pgadmin4
- sudo systemctl enable --now pgadmin4-web # 常见服务名为 pgadmin4-web（不同发行包可能略有差异）
- 访问与防火墙：
- 默认通过 HTTP 80 提供服务（若部署为服务器模式并配 Nginx/Apache 反向代理，可启用 HTTPS 443）。
- 放行防火墙端口（示例）：sudo ufw allow 80,443/tcp；如需直连数据库，另放行 5432/tcp（仅限受控网络）。
二 连接与多实例多库配置
- 添加服务器连接：在 pgAdmin 左侧 Servers → Create → Server，填写名称、主机（IP/DNS）、端口（默认 5432）、维护数据库（常用 postgres）、用户名与密码，保存即可。
- 管理多实例与多库：
- 同一 pgAdmin 可添加多个“Servers”条目，分别指向不同主机或不同端口的 PostgreSQL 实例，实现跨实例集中管理。
- 在单个实例节点下，展开 Databases 可创建/删除/迁移数据库，并在 Login/Group Roles 与 Tablespaces 中统一进行安全与存储策略配置。
- 批量导入连接（适合团队交付）：将连接定义导出为 servers.json，在新环境导入，避免逐条手工录入。
- 连接失败快速排查要点：
- 目标主机与端口可达（网络/安全组/防火墙）。
- PostgreSQL 服务运行且监听正确地址（常见为 0.0.0.0 或指定内网地址）。
- pg_hba.conf 允许来自 pgAdmin 所在主机的认证方式（如 md5、scram-sha-256）；必要时先用本地 psql 验证凭据。
- 若提示超时或认证失败，优先检查网络连通性与认证配置。
三 日常运维与自动化
- 备份与恢复：
- 在 pgAdmin 中对指定数据库使用 Backup/Restore 向导执行逻辑备份（适合跨版本迁移与快速恢复）。
- 结合操作系统定时任务（如 cron）定期全量备份，并保留多份历史以控制恢复点目标（RPO）。
- 权限与安全：
- 在 Login/Group Roles 中创建角色、设置密码与有效期，遵循最小权限原则授予对象权限；必要时使用组角色聚合权限，再授予给登录角色。
- 性能与监控：
- 使用 Query Tool 执行与优化 SQL，借助执行计划、统计信息识别慢查询与瓶颈；结合实例监控面板观察连接数、缓存命中率、事务与锁等待等关键指标。
- 批量与自动化：
- 通过 pgAdmin 的 服务器定义 JSON 实现连接配置的版本化与批量导入；对重复任务（建库、赋权、迁移）可结合脚本与 CI/CD 流程，减少人工失误。
四 容器化一键部署与多实例编排
- 使用 Docker Compose 同时运行 pgAdmin 与一个或多个 PostgreSQL 实例，并通过自定义网络实现服务发现（容器名即主机名）。
- 示例要点（关键片段）：
- 环境变量：设置管理员邮箱与密码（如 PGADMIN_DEFAULT_EMAIL、PGADMIN_DEFAULT_PASSWORD），以及监听端口（如 PGADMIN_LISTEN_PORT=80）。
- 数据持久化：将 pgAdmin 配置目录 /var/lib/pgadmin 挂载为卷；PostgreSQL 数据目录 /var/lib/postgresql/data 同样挂载。
- 多实例：在同一网络中定义 postgres_dev / postgres_prod 等多个实例，pgAdmin 连接地址可直接使用服务名（如 postgres_dev:5432）。
- 预配置连接：通过 servers.json 预置多个 Server 条目，实现开箱即用。
- 适用场景：开发/测试环境快速搭建、CI 流水线、演示与培训环境的一键交付。
