Mac Docker跨容器访问另一容器Postgres失败解决

Mac版Docker Desktop的端口映射默认行为和Linux原生Docker有差异，是连接失败的核心原因：

• 启动container1时配置的5432端口映射，默认只会绑定宿主机的127.0.0.1回环地址，这个监听规则仅接受宿主机本机发起的访问请求，不会放行来自Docker虚拟网络内部的流量。
• host.docker.internal解析出的地址是Docker Desktop内置虚拟机的网关地址，不属于宿主机回环地址范畴，映射到127.0.0.1的5432端口根本没在这个网关地址上监听，自然无法通过这个地址转发到container1的Postgres服务。
• 认知偏差点：不要默认认为-p参数映射的端口会对所有来源IP生效，Mac版Docker默认绑定回环地址的规则，本身就不会放行来自Docker虚拟网络内部的跨容器流量。

可根据实际场景选择以下两种方案：

方案1：调整端口映射监听范围，走宿主机转发 #

• 重新创建/启动container1时，将端口映射的绑定地址改为0.0.0.0，让宿主机所有网卡（包括Docker虚拟网关对应的网卡）都监听5432端口，启动参数示例：
  docker run -d --name container1 -p 0.0.0.0:5432:5432 -e POSTGRES_PASSWORD=你的数据库密码 postgres:对应版本
• 在container2中连接数据库时，不要用localhost作为主机地址，替换为host.docker.internal即可，连接命令：
  psql -h host.docker.internal -d postgres -U postgres -W

方案2：自定义Docker网络实现容器直连（推荐） #

不需要走宿主机端口转发，延迟更低，也不需要额外把数据库端口暴露到宿主机公网，安全性更高：

• 先创建一个自定义的Docker桥接网络：
  docker network create app-net
• 启动container1时将其接入该网络，如果不需要宿主机外部访问数据库，甚至可以不配置端口映射：
  docker run -d --name container1 --network app-net -e POSTGRES_PASSWORD=你的数据库密码 postgres:对应版本
• 启动container2时同样接入这个自定义网络：
  docker run -it --name container2 --network app-net 你使用的业务镜像
• 在container2中直接用container1的容器名作为数据库主机地址即可连通，连接命令：
  psql -h container1 -d postgres -U postgres -W

补充说明：如果是临时测试不想重建container1，也可以直接在Mac宿主机执行端口转发规则，把虚拟网关的5432端口流量转到本地127.0.0.1的5432端口，但生产环境更推荐用自定义网络互联的方式。

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