Windows下VS2022微服务架构中Portainer无法连接本地Docker服务器

问题现状 #

在Windows环境VS2022微服务架构中，通过以下docker-compose.yml和docker-compose.override.yml部署Portainer后，容器已在9000端口启动，但无法连接本地Docker服务器。

原配置文件 #

docker-compose.yml

services:
  portainer:
    image: portainer/portainer-ce

volumes:
  portainer_data:

docker-compose.override.yml

portainer: 
  container_name: portainer
  restart: always
  ports:
   - "8080:8000"
   - "9000:9000"
  volumes:
   - /var/run/docker.sock:/var/run/docker.sock
   - /mnt/Docker-Data/portainer:/data

核心问题分析 #

Windows环境下Docker的运行机制与Linux不同，原配置存在两处路径错误：

1. Docker套接字路径错误：Linux下的/var/run/docker.sock在Windows Docker Desktop中对应//./pipe/docker_engine，直接挂载Linux路径会导致Portainer无法访问本地Docker引擎。
2. 本地数据卷路径错误：/mnt/Docker-Data/portainer是Linux风格路径，Windows下需改为原生路径格式（如D:\Docker-Data\portainer）。

修复步骤 #

1. 修改docker-compose.override.yml配置
   将挂载路径修正为Windows兼容格式：

portainer: 
  container_name: portainer
  restart: always
  ports:
   - "8080:8000"
   - "9000:9000"
  volumes:
   - //./pipe/docker_engine:/var/run/docker.sock
   - D:\Docker-Data\portainer:/data

注意：确保D:\Docker-Data\portainer目录已提前创建，否则Docker会自动生成匿名卷而非指定目录。

2. 重新部署Portainer容器
   在开发者PowerShell中执行以下命令：

# 停止并移除现有容器
docker-compose -f .\docker-compose.yml -f docker-compose.override.yml down
# 重新启动容器
docker-compose -f .\docker-compose.yml -f docker-compose.override.yml up -d

3. 验证Docker Desktop设置
   打开Docker Desktop，进入Settings -> General，若仍无法连接，可勾选以下选项：

• Expose daemon on tcp://localhost:2375 without TLS

完成以上步骤后，重新访问http://localhost:9000，Portainer即可正常连接本地Docker服务器。

内容的提问来源于stack exchange，提问作者A.nikfar