为何在Dev Container中无法连接Docker内的PostgreSQL？

问题背景 #

在VS Code中使用Dev Container，通过Docker-outside-of-Docker（DOOD）特性映射宿主Docker套接字，在Dev Container内用docker-compose.yml启动应用和PostgreSQL容器开展测试。宿主环境中能正常通过psql连接PostgreSQL，但Dev Container内执行同样的psql -U postgres -h localhost -d demo命令却失败。切换到Docker-in-Docker（DID）模式后连接正常，但希望保留DOOD模式。

环境配置 #

devcontainer.json（DOOD模式） #

{
    "name": "devcontainer-dood",
    "build": {
      "dockerfile": "./Dockerfile"
    },
    "mounts": [
      "source=/var/run/docker.sock,target=/var/run/docker.sock,type=bind"
    ],
    "features": {
      "ghcr.io/devcontainers/features/docker-outside-of-docker:1": {}
    }
  }

Dev Container Dockerfile #

FROM mcr.microsoft.com/devcontainers/base:bullseye

RUN apt-get update && \
    apt-get install -y \
        postgresql-client \
        && apt-get clean

原因分析 #

DOOD模式下，Dev Container和通过docker-compose启动的PostgreSQL容器都是宿主Docker daemon管理的同级容器：

• 宿主环境中的localhost指向宿主自身，而PostgreSQL容器的端口已映射到宿主，因此能正常连接。
• Dev Container中的localhost指向容器自身，而非宿主或PostgreSQL容器，直接用localhost无法访问到目标实例。

解决方案 #

方案1：通过Docker Compose服务名/容器IP连接 #

Docker Compose会为启动的容器创建专属网络，同级容器之间可通过服务名直接通信：

1. 确认docker-compose.yml中PostgreSQL的服务名（例如假设服务名为db）
2. 在Dev Container内执行连接命令：

psql -U postgres -h db -d demo

若不确定服务名，可先执行docker compose ps查看服务列表。

也可以通过容器IP连接：

1. 获取PostgreSQL容器ID：docker ps
2. 查询容器IP：docker inspect <容器ID> | grep -oP '"IPAddress": "\K[^"]+'
3. 执行连接命令：

psql -U postgres -h <容器IP> -d demo

方案2：通过宿主别名host.docker.internal连接 #

Mac环境的Docker内置host.docker.internal作为宿主系统的别名，Dev Container内可通过该别名访问宿主已映射的端口：

psql -U postgres -h host.docker.internal -d demo

此方法需确保docker-compose.yml中配置了PostgreSQL端口映射，例如：

ports:
  - "5432:5432"

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