在 Ubuntu 上搭建 pgAdmin 服务器的推荐做法
一 安装与部署方式选择
- 推荐使用官方 APT 仓库安装 pgAdmin 4，并通过 setup-web.sh 配置为 Web 服务，默认监听 TCP 5050 端口，便于服务器环境与多用户访问。也可选择 pip/虚拟环境部署，或下载 .deb 包安装，步骤与 APT 基本一致。上述方式均为官方常见安装路径，适合长期使用与维护。
二 快速搭建步骤 APT 仓库方式
- 1）导入 GPG 密钥并添加官方仓库（支持 Debian/Ubuntu 发行版代号）：
- 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.postgresql.org/pub/pgadmin/pgadmin4/apt/$(lsb_release -cs) pgadmin4 main” | sudo tee /etc/apt/sources.list.d/pgadmin4.list’
- 2）安装 pgAdmin 4：sudo apt update && sudo apt install pgadmin4
- 3）运行 Web 配置向导，设置 管理员邮箱与密码：sudo /usr/pgadmin4/bin/setup-web.sh
- 4）启动服务：sudo systemctl start pgadmin4；如需开机自启：sudo systemctl enable pgadmin4
- 5）访问：在浏览器打开 http://服务器IP:5050，使用上一步设置的管理员账号登录。
三 其它安装方式
- pip 虚拟环境方式（适合无 root 或自定义隔离环境）
- 安装依赖：sudo apt update && sudo apt install python3-pip python3-venv libpq-dev libffi-dev libssl-dev
- 创建并激活虚拟环境：python3 -m venv ~/pgadmin4-venv && source ~/pgadmin4-venv/bin/activate
- 安装 pgAdmin 4：pip install --upgrade pip wheel && pip install pgadmin4
- 初始化数据目录（首次）：python -m pgadmin4.setup
- 启动开发服务器：python -m pgadmin4
- 访问：浏览器打开 http://127.0.0.1:5050（如需远程访问，请使用反向代理或配置 ALLOWED_HOSTS 等安全项）
- .deb 包方式（适合离线或指定版本）
- 下载对应版本 .deb 包后安装：sudo dpkg -i pgadmin4.deb
- 运行：sudo /usr/pgadmin4/bin/setup-web.sh 完成 Web 配置
- 启动：sudo systemctl start pgadmin4；访问 http://服务器IP:5050。
四 连接 PostgreSQL 与远程访问配置
- 在 pgAdmin 中添加服务器：General 填写名称；Connection 填写目标数据库的 Host（如服务器 IP 或域名）、Port 5432、Username/Password，保存即可连接。
- 若目标 PostgreSQL 在另一台主机，需确保：
- PostgreSQL 监听外部地址：编辑 postgresql.conf 的 listen_addresses（如设置为 ‘*’），并重启数据库服务。
- 客户端认证：编辑 pg_hba.conf，为需要来源网段添加规则（例如 host all all 0.0.0.0/0 md5），然后重启数据库服务。
- 云服务器安全组/防火墙放行 TCP 5432（数据库）与 TCP 5050（pgAdmin）。
五 常见问题与运维建议
- 无法访问 5050：检查服务状态（systemctl status pgadmin4）、防火墙/云安全组、以及是否配置了反向代理或应用层限制。
- 登录失败：确认 setup-web.sh 已成功执行并设置了管理员账号；如多次失败，可检查日志（/var/log/pgadmin4/ 或 systemd 日志）定位问题。
- 版本与仓库：不同 Ubuntu 版本的仓库路径可能不同，优先使用带有签名校验的 官方 APT 仓库与对应发行代号，避免依赖冲突。