如何配置VS Code Docker扩展使用远程主机且本地终端DOCKER_HOST为空

核心思路 #

避开通过系统环境变量或VS Code全局环境变量设置DOCKER_HOST，直接配置Docker扩展的专属主机参数，同时确保终端环境不继承远程主机变量。

具体操作步骤 #

1. 清理全局/系统级的DOCKER_HOST设置

   • 打开Windows「系统属性」→「高级」→「环境变量」，检查用户或系统变量中的DOCKER_HOST，存在则删除。
   • 打开VS Code用户设置（快捷键Ctrl+,），搜索terminal.integrated.env.windows，若其中配置了DOCKER_HOST，一并删除。

2. 配置Docker扩展的远程主机

   • 在VS Code用户设置或工作区设置中，搜索docker.host，填入远程Docker主机地址，示例：

     "docker.host": "tcp://192.168.1.100:2375"
     

   • 保存设置后，通过命令面板（Ctrl+Shift+P）输入Docker: Restart重启Docker扩展。

3. 验证终端环境

   • 打开VS Code终端，执行命令检查DOCKER_HOST：

     echo %DOCKER_HOST%
     

   • 输出为空即说明终端环境正常，此时docker ps会连接本地Docker；VS Code的Docker扩展侧边栏则会显示远程主机的容器、镜像等资源。

补充说明 #

若仅需特定工作区使用远程主机，其他工作区保留本地配置，只需将docker.host配置放在工作区设置（.vscode/settings.json）中，而非用户全局设置。切换工作区时，扩展会自动对应不同Docker主机，终端始终保持本地环境。

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