Docker CLI内部服务器错误：执行docker ps/version报错且Docker Desktop冻结

问题核心 #

Docker 24.0.7对应的API版本是v1.43，但CLI强制请求了旧版v1.24 API，导致服务端无法响应；卸载后问题未解决是因为残留的配置文件、数据目录没清理干净。

修复步骤 #

• 彻底清理Docker残留（Windows环境）

  1. 管理员身份打开命令提示符，停止所有Docker相关服务：

     net stop docker
     net stop dockerdesktop
     net stop com.docker.service
     

  2. 删除核心数据目录（会清除本地镜像、容器，提前备份需要的内容）：

     rmdir /s /q C:\ProgramData\Docker
     rmdir /s /q C:\Users\<你的用户名>\.docker
     

     替换<你的用户名>为实际系统用户名，也可以手动找到这两个文件夹删除。
  3. 删除冲突的命名管道：

     del \\.\pipe\docker_engine
     

• 重置CLI的API版本配置

  1. 检查是否存在强制指定API版本的环境变量：

     echo %DOCKER_API_VERSION%
     

     如果输出v1.24，执行以下命令删除该变量（重启终端生效）：

     setx DOCKER_API_VERSION ""
     

  2. 打开C:\Users\<你的用户名>\.docker\config.json，如果里面有"apiVersion": "v1.24"这类字段，直接删除整行。

• 重新安装Docker Desktop

  1. 下载Docker 24.0.7的安装包，右键以管理员身份运行。
  2. 安装过程中勾选“重置为出厂设置”（如果有该选项），跳过之前的残留配置。
  3. 安装完成后启动Docker Desktop，等待初始化完成（状态栏变绿）。

• 验证修复效果
  打开新的管理员终端，执行：

  docker version
  

  确认Client和Server的API version字段一致（应为1.43），再执行docker ps，如果正常返回容器列表，且Docker Desktop不再冻结，说明问题解决。

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