本地DBeaver无法访问GCP远程实例Docker容器内运行的PostgreSQL

1. 修正DBeaver连接配置 #

你当前填写的主机地址172.17.0.1是Docker在GCP实例内部的网关内网地址，仅支持实例本地访问，本地设备连接时需要替换为GCP实例的公网IP：

• 登录GCP控制台进入「VM实例」页面，找到运行Docker服务的对应实例，复制其公网IP
• 将DBeaver连接配置中的主机地址修改为该公网IP，其余端口、账号密码配置保持不变

2. 验证GCP防火墙规则有效性 #

• 确认防火墙规则为**入站（Ingress）**规则
• 确认规则的目标资源包含你运行服务的VM实例
• 确认来源IP范围包含你本地设备的公网IP（测试阶段可临时填写0.0.0.0/0，验证完成后需修改为你的本地IP避免安全风险）
• 确认规则已放行tcp:5432端口，且规则处于启用状态

3. 检查实例操作系统层面的端口放行 #

登录GCP实例执行对应命令，检查系统自带防火墙是否放行5432端口：

• Debian/Ubuntu系统：sudo ufw status
• CentOS/RHEL系统：sudo firewall-cmd --list-all
  如果未放行5432端口，需要添加对应规则后重载防火墙。

4. 确认Postgres端口正常监听 #

在GCP实例上执行命令：
sudo netstat -tunlp | grep 5432
如果返回结果中存在0.0.0.0:5432的监听记录则正常，否则检查Docker容器是否正常启动、compose配置的端口映射是否生效。

5. 本地验证网络连通性 #

在你本地设备的终端/命令行执行以下命令，测试到GCP实例5432端口的连通性：
nc -zv 你的GCP实例公网IP 5432
或
telnet 你的GCP实例公网IP 5432
如果连通失败，优先排查上述防火墙、IP配置问题；如果连通成功但DBeaver仍报错，继续下一步检查。

6. 验证Postgres访问权限配置 #

进入Postgres容器，检查pg_hba.conf配置文件，确认是否允许外部IP访问：
官方Postgres镜像默认允许所有IP访问，如果你手动修改过配置，需要添加如下规则：
host all all 0.0.0.0/0 scram-sha-256
修改完成后重启Postgres容器即可。

内容的提问来源于stack exchange，提问作者user9355500