### 配置 WSL2 中的 DOCKER_HOST 环境变量以连接到 Docker 服务 在 WSL2 中配置 `DOCKER_HOST` 环境变量是为了让 Docker CLI 能够正确连接到 Docker 守护进程（Docker daemon）。以下内容详细介绍了如何完成这一配置[^1]。 #### 1. 确认 Docker Desktop 已安装并运行 首先，确保 Docker Desktop 已安装，并且启用了 WSL2 后端支持。可以通过以下命令检查 Docker 是否正在运行： ```bash docker info ``` 如果命令返回了关于 Docker 的详细信息，则说明 Docker 正常工作[^2]。 #### 2. 设置 DOCKER_HOST 环境变量 默认情况下，Docker Desktop 在 WSL2 中通过 Unix 套接字或 TCP 提供服务。为了明确指定连接方式，可以设置 `DOCKER_HOST` 环境变量。以下是两种常见的配置方法： - **使用 Unix 套接字** 如果 Docker Desktop 使用的是 Unix 套接字，可以通过以下命令设置环境变量： ```bash export DOCKER_HOST="unix:///mnt/wslg/runtime-dir/docker.sock" ``` 这里的路径 `/mnt/wslg/runtime-dir/docker.sock` 是 WSL2 中 Docker Desktop 默认的套接字文件位置[^3]。 - **使用 TCP 协议** 如果 Docker Desktop 配置为通过 TCP 提供服务，可以使用以下命令设置环境变量： ```bash export DOCKER_HOST="tcp://localhost:2375" ``` 注意：默认情况下，Docker Desktop 不会启用未加密的 TCP 端口（如 2375）。如果需要使用此方式，请在 Docker Desktop 设置中启用“Expose daemon on tcp://localhost:2375 without TLS”选项[^4]。 #### 3. 验证配置是否生效 完成环境变量设置后，可以通过以下命令验证是否能够正常连接到 Docker 服务： ```bash docker ps ``` 如果命令返回了当前运行的容器列表，则说明配置成功。 #### 4. 持久化环境变量 为了每次启动 WSL2 时自动加载 `DOCKER_HOST` 环境变量，可以将其添加到 `.bashrc` 或 `.zshrc` 文件中。例如： ```bash echo 'export DOCKER_HOST="unix:///mnt/wslg/runtime-dir/docker.sock"' >> ~/.bashrc source ~/.bashrc ``` ### 注意事项 - 如果使用的是 Unix 套接字方式，通常无需额外配置即可直接使用 Docker CLI，因为这是 Docker Desktop 的默认行为。 - 如果选择 TCP 方式，请确保安全风险可控，尤其是在生产环境中避免使用未加密的连接[^3]。 ```bash # 示例：持久化设置 DOCKER_HOST 环境变量 echo 'export DOCKER_HOST="tcp://localhost:2375"' >> ~/.bashrc source ~/.bashrc ```