Windows下Docker Compose无法通过主机名访问容器问题

问题描述 #

我使用Docker Compose部署两个基于Windows的镜像，对应的docker-compose.yaml配置如下：

services:
  application:
    image: myapp-win:latest
    container_name: "my-app"
    # 用于诊断
    entrypoint: ["cmd"]
    stdin_open: true
    tty: true
    env_file: .myapp/.env
    environment:
        - POSTGRES_URI=jdbc:postgresql://db0:5432/mydatabase
    depends_on:
        db0:
            condition: service_healthy

  db0:
    image: stellirin/postgres-windows:10.10
    container_name: "my-db"
    ports:
        - 10000:5432 # 在Windows中似乎不生效
    env_file:
        - .postgres/.env
    volumes:
        - .postgres\initdb\:c:\docker-entrypoint-initdb.d\
    healthcheck:
        test: [ "CMD", "pg_isready", "-q", "-d", "${POSTGRES_DATABASE}", "-U", "${POSTGRES_USER}" ]
        timeout: 45s
        interval: 10s
        retries: 10
    restart: unless-stopped

启动容器后，我进入my-db容器终端获取了它的IP地址，在my-app容器终端中能够通过该IP ping通my-db，但无法通过服务主机名db0访问：

c:\app> ping db0
Ping request could not find host db0.

这直接导致应用无法通过POSTGRES_URI变量连接数据库。请问Windows容器的主机名使用是否有特殊语法？

补充说明：两个容器均无法ping通外部网络，例如：

c:\app> ping 8.8.8.8
Request timed out.

不确定这是否与主机名解析问题相关。

解决方案及排查思路 #

1. 主机名解析问题修复 #

Windows容器的DNS解析机制与Linux容器存在差异，Docker Compose默认网络在Windows环境下可能出现DNS配置异常，可按以下步骤处理：

• 检查DNS配置：进入my-app容器执行ipconfig /all，确认DNS服务器地址指向Docker内置DNS（通常为容器网关地址）。若DNS配置为空或错误，会导致服务名无法解析。
• 显式定义自定义网络：在docker-compose.yaml最外层添加自定义网络配置，强制使用Windows容器默认的nat驱动：

  networks:
    default:
      driver: nat
  

  确保两个容器都加入该网络，Docker会自动为网络内的容器配置DNS解析。
• 刷新DNS缓存：在my-app容器内执行ipconfig /flushdns，之后再次尝试ping db0。

2. 外部网络不通的关联排查 #

容器无法访问外部网络通常与网络驱动、宿主机环境有关，也会间接影响DNS解析：

• 验证宿主机网络：确认宿主机可正常访问外部网络，且Docker Desktop的网络未被防火墙或代理拦截。
• 检查容器路由：在容器内执行route print，查看是否存在指向宿主机网关的默认路由。若路由缺失，可尝试重启Docker服务或重新创建容器。
• 替代网络验证方式：部分Windows容器镜像默认禁用ICMP请求，即使网络正常也无法ping通外部地址，可使用telnet 8.8.8.8 53测试DNS端口连通性，替代ping验证网络状态。

3. 额外注意事项 #

• depends_on的service_healthy条件仅保证服务健康状态，DNS解析可能存在延迟，建议在应用启动脚本中加入数据库连接重试逻辑。
• 无需刻意设置container_name，Docker Compose默认的服务名（如db0）是DNS解析的核心依据，保持默认配置更利于解析。

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