Windows环境下Docker无法运行问题求助

问题复现 #

执行docker run hello-world或docker version时出现如下错误：

docker: error during connect: this error may indicate that the docker daemon is not running: Head "http:////./pipe/docker_engine/_ping": open //./pipe/docker_engine: The system cannot find the file specified.

执行& 'C:\Program Files\Docker\Docker\DockerCli.exe' -SwitchDaemon时报错：

switching to windows engine: request failed and retry attempts exhausted: Post "http://ipc/engine/switch": open .\pipe\dockerBackendApiServer: The system cannot find the file specified.

解决步骤 #

• 确认Docker Desktop进程状态
  打开任务管理器，检查是否有Docker Desktop.exe、Docker Engine.exe进程在运行；或用命令行查询：

  tasklist | findstr Docker
  

  如果进程未启动，尝试手动启动Docker Desktop（非管理员账号通常可正常启动，若启动失败需联系管理员确认安装权限）。

• 检查WSL集成（优先推荐WSL2后端）
  若使用WSL2作为Docker后端：

  1. 验证WSL版本：

     wsl --list --verbose
     

     确保目标发行版的版本为2，若为1则执行wsl --set-version <发行版名称> 2升级。
  2. 切换Docker上下文到WSL：

     docker context use wsl
     

  3. 重新执行docker run hello-world测试。

• 修复Docker管道权限
  非管理员账号虽加入docker组，但可能缺少管道文件权限，执行以下命令授权：

  icacls "//./pipe/docker_engine" /grant "Users:F"
  

  授权完成后重启Docker Desktop。

• 重置Docker Desktop配置
  若以上步骤无效，尝试重置配置：

  • 若能打开Docker Desktop，进入「设置」→「Reset」，选择「Reset to factory defaults」。
  • 若无法打开GUI，执行命令行重置（需管理员权限，若自身无权限请联系管理员）：

    & 'C:\Program Files\Docker\Docker\DockerCli.exe' -Reset
    

• 排查第三方软件干扰
  临时关闭杀毒软件、防火墙等安全工具，验证是否被拦截，确认后可添加Docker相关进程/管道到白名单。

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