Ubuntu 中 pgAdmin 网络设置调整指南
一、先明确网络边界
- pgAdmin 4 在 Ubuntu 上常见有两种运行形态，网络调整的位置不同：
- 桌面应用（通过 apt 安装的 Python 包）：网络访问由桌面会话与系统代理决定，通常无需修改 pgAdmin 配置文件。
- Web 模式（通过安装包脚本部署，常见端口为 5050）：需要调整其 Web 服务的监听地址与端口，以及系统的防火墙放行策略。可通过浏览器访问 http://服务器IP:5050 打开界面。
二、Web 模式调整步骤（最常见）
- 修改 pgAdmin 配置以允许远程访问
- 配置文件路径可能为：/etc/pgadmin4/pgadmin4.conf 或 /etc/pgadmin/pgadmin4.conf。
- 确保存在或调整为：
- ServerMode = True
- 将 listen_addresses 设为 ‘0.0.0.0’（允许来自任意 IP 的连接）
- 如需自定义端口，设置 port = 5050（或你期望的端口）
- 示例（编辑后保存）：
- listen_addresses=‘0.0.0.0’
- port=5050
- 应用配置并重启服务
- 重启 pgAdmin 服务：
- sudo systemctl restart pgadmin4
- 如以 Web 模式首次部署，可运行安装脚本并按提示设置管理员账号：
- sudo /usr/pgadmin4/bin/setup-web.sh
- 防火墙放行
- 放行 pgAdmin Web 端口（示例为 5050/tcp）：
- sudo ufw allow 5050/tcp
- sudo ufw reload
- 访问测试
- 从浏览器访问：http://服务器IP:5050，确认可登录管理界面。
三、若你要调整的是 PostgreSQL 的网络访问（被 pgAdmin 连接的目标库）
- 修改数据库端以允许远程连接
- postgresql.conf（路径如：/etc/postgresql//main/postgresql.conf）
- 设置：listen_addresses = ‘*’
- pg_hba.conf（同目录）
- 按需添加规则，例如允许指定网段或所有来源（示例为所有来源使用口令 md5）：
- host all all 0.0.0.0/0 md5
- 重启数据库服务：
- sudo systemctl restart postgresql
- 防火墙放行数据库端口
- 放行 PostgreSQL 默认端口 5432/tcp：
- sudo ufw allow 5432/tcp
- sudo ufw reload
- 在 pgAdmin 中新建服务器连接
- 主机名/IP：填入数据库服务器地址
- 端口：5432
- 维护数据库/用户名/密码：按实际填写并保存。
四、常见问题快速排查
- 服务状态与日志
- 查看 pgAdmin 是否运行：sudo systemctl status pgadmin4
- 查看日志定位问题：cat /var/log/pgadmin/pgadmin4.log
- 端口连通性
- 本机测试：ss -ltnp | grep :5050（或 :5432）
- 远程测试：nc -vz 服务器IP 5050（或 5432）
- 配置核对
- 再次确认 listen_addresses 与 port 已正确设置并重启服务
- 虚拟机/云主机
- 确认网络模式（NAT/桥接）与云安全组/本机防火墙已放行对应端口。
五、安全建议
- 避免将 listen_addresses 长期设为 0.0.0.0 并暴露到公网；建议结合 UFW/安全组 限制来源 IP，或使用 反向代理 + TLS 提供加密与访问控制。
- 数据库侧不要使用过于宽松的 pg_hba.conf 规则（如 0.0.0.0/0），生产环境应限定为受控网段并使用强认证方式。