Windows下Docker Desktop使用docker --host参数连接报错如何解决

根因说明 #

你手动修改C:\ProgramData\Docker\config\daemon.json不生效的核心原因是：该路径配置仅对独立安装的Docker daemon生效，Docker Desktop默认会覆盖该文件的配置，所有生效配置需要从Docker Desktop的UI界面修改。

操作步骤 #

• 打开Docker Desktop客户端，点击右上角齿轮图标进入设置页面
• 左侧菜单选择「Docker Engine」选项
• 在右侧的JSON编辑框中，在原有配置基础上新增hosts字段，必须保留本地管道配置，否则常规Docker命令会无法运行，参考配置如下：

{
  "builder": { "gc": { "defaultKeepStorage": "20GB", "enabled": true } },
  "experimental": false,
  "hosts": ["tcp://0.0.0.0:2375","tcp://127.0.0.1:2376", "npipe:////./pipe/docker_engine"]
}

• 点击「Apply & Restart」按钮，等待Docker服务完全重启
• 重启完成后执行命令验证端口监听状态：netstat -ano | findstr :2376，如果能返回对应监听进程说明配置生效

额外排查项 #

如果配置完成后还是无法连接，检查Windows防火墙是否拦截了2376端口的本地连接，可临时关闭防火墙测试确认。

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