Windows下docker-compose与docker run绑定挂载卷差异致启动失败

这个问题我之前帮不少人解决过——本质上是Windows下Docker Compose和docker run在路径解析逻辑上的差异导致的。docker run会自动适配Hyper-V/WSL2的虚拟机路径转换，但Docker Compose需要你明确给出符合当前后端的正确路径格式。下面分场景给你具体的解决办法：

解决办法 #

1. 当使用WSL2后端时 #

这是目前Docker Desktop推荐的后端，路径处理更灵活：

场景A：在WSL2终端内运行docker-compose

直接使用标准的Linux挂载路径即可，Docker Compose会和WSL2的Docker daemon直接通信，路径会被正确解析：

services:
  registrator:
    image: gliderlabs/registrator:latest
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock
    # 其他容器配置...

场景B：在Windows CMD/PowerShell内运行docker-compose

需要告诉Docker Compose这是一个Linux风格的路径，避免被当成Windows本地路径解析，有两种方式：

• 方式一：用双斜杠开头的路径格式

services:
  registrator:
    image: gliderlabs/registrator:latest
    volumes:
      - //var/run/docker.sock:/tmp/docker.sock
    # 其他容器配置...

• 方式二：使用WSL共享路径（替换<你的WSL发行版名称>为实际名称，比如Ubuntu）

services:
  registrator:
    image: gliderlabs/registrator:latest
    volumes:
      - \\wsl$\<你的WSL发行版名称>\var\run\docker.sock:/tmp/docker.sock
    # 其他容器配置...

2. 当使用Hyper-V后端时 #

如果你的Docker还是用Hyper-V后端，需要映射到Windows宿主机上的等效路径：

• 方式一：使用Docker Desktop提供的内置路径别名（部分环境下可用）

services:
  registrator:
    image: gliderlabs/registrator:latest
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock
    # 其他容器配置...

• 方式二：直接使用Windows本地的实际路径
  Hyper-V模式下，docker.sock会映射到Windows的C:\ProgramData\Docker\run\docker.sock，把路径改成正斜杠格式即可：

services:
  registrator:
    image: gliderlabs/registrator:latest
    volumes:
      - C:/ProgramData/Docker/run/docker.sock:/tmp/docker.sock
    # 其他容器配置...

快速排查小技巧 #

• 先确认你的Docker后端类型：打开Docker Desktop设置，在「General」或「Resources > WSL Integration」里可以查看是WSL2还是Hyper-V。
• 可以先用docker run测试挂载有效性：比如在Windows终端执行docker run -v //var/run/docker.sock:/tmp/docker.sock gliderlabs/registrator:latest，如果能正常启动，就把这个路径格式直接复制到docker-compose.yml里。

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