执行docker version命令请求错误端口12375连接被拒绝如何解决

排查修复步骤 #

1. 清理Docker相关环境变量 #

• 按下Win + R组合键，输入sysdm.cpl后回车打开系统属性窗口
• 切换到「高级」标签页，点击底部「环境变量」按钮
• 分别在「用户变量」「系统变量」列表中查找DOCKER_HOST变量，如果存在直接删除该变量
• 保存所有修改后，关闭所有已打开的CMD/PowerShell窗口，重新打开终端执行docker version测试是否恢复

2. 修正Docker上下文配置 #

如果清理环境变量后问题仍存在，大概率是Docker默认上下文的连接地址被修改，执行如下命令查看当前上下文配置：

docker context inspect default

如果返回结果中Endpoints.docker.Host字段值为tcp://127.0.0.1:12375，执行以下命令修改为默认配置：

• 如果你使用Docker Desktop默认的npipe监听（推荐）：

docker context update default --docker host=npipe:////./pipe/docker_engine

• 如果你需要走TCP端口2375连接：

docker context update default --docker host=tcp://127.0.0.1:2375

修改完成后重新执行docker version即可验证恢复。

3. 开启Docker Desktop 2375端口监听（可选） #

如果你需要使用TCP端口连接Docker daemon，需先在Docker Desktop中开启对应配置：

• 打开Docker Desktop设置面板，进入「General」选项页
• 勾选「Expose daemon on tcp://localhost:2375 without TLS」选项
• 点击「Apply & Restart」等待Docker服务重启完成即可

内容的提问来源于stack exchange，提问作者Mritunjay Kumar Jay