Docker容器内.NET Core应用连接同Droplet宿主机PostgreSQL的连接串配置及连通问题

连通失败的前置原因排查 #

你当前配置的连接串host字段为空白，本身就是无效配置，自然无法发起数据库连接。此前你尝试填宿主机公网IP、私网IP都连不通，核心原因通常是两个：

• 公网IP连通失败：要么是DigitalOcean Droplet的系统防火墙、云平台自带的云防火墙没有放通5432端口的入站规则，要么是PostgreSQL的访问控制规则pg_hba.conf拒绝了来自Docker虚拟网段的连接请求
• 私网IP连通失败：PostgreSQL默认的监听地址（对应配置项postgresql.conf里的listen_addresses）只绑定了127.0.0.1，根本没有监听宿主机的私网IP网卡，外部网络的请求根本触达不到数据库服务

不同部署模式下host字段的正确取值 #

根据你给.NET Core容器配置的网络模式，对应填写以下值即可：

• 如果用的是Docker默认桥接网络（绝大多数常规部署的默认模式，没特意自定义网络的话就是这个）
  你的Droplet是Linux系统，不能直接用Windows/Mac Docker Desktop里默认可用的host.docker.internal。容器视角下，能直接访问宿主机服务的网关地址默认是172.17.0.1，直接填这个值就能连通。如果不想硬写IP，可以在启动容器时追加--add-host=host.docker.internal:host-gateway启动参数，之后连接串里就可以统一用host.docker.internal作为host值，后续换部署环境也不用改连接串配置
• 如果给容器配置了Host网络模式（启动时加了--network host参数，容器和宿主机完全共享网络栈）
  此时容器和宿主机没有网络隔离，host字段直接填127.0.0.1即可，容器视角下的localhost和宿主机的localhost完全等价
• 如果用的是自定义Docker桥接网络
  逻辑和默认桥接一致，要么填宿主机在该自定义网络下的网关IP，要么加--add-host=host.docker.internal:host-gateway参数做别名映射，不用硬记复杂的网段IP

改完host还是连不上的必查项 #

• 把postgresql.conf里的listen_addresses从默认的localhost改成*，让PostgreSQL监听所有网卡的连接请求
• 修改pg_hba.conf，添加Docker网段的访问规则，允许对应网段用账号密码方式登录，改完必须重启PostgreSQL服务才能生效
• 放通本机防火墙对Docker虚拟网段访问5432端口的拦截，绝对不要为了省事把5432端口直接暴露到公网，很容易被暴力破解拖库
• 你遇到的接口返回400错误，本质是.NET Core应用因为数据库连接失败，在接口处理流程中抛出未捕获异常，导致前端拿到了400响应，不是PostgreSQL服务本身返回的400状态码

补充：如果你不想折腾Docker网络的连接配置，也可以把.NET Core应用和PostgreSQL用同一个自定义Docker网络连接，把PostgreSQL也容器化，直接用容器名当host值，会比直连本地宿主机的PostgreSQL更稳定。

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