docker windows wsl

### 如何在 Windows 上使用 Docker 与 WSL 集成

#### 启用并设置 WSL2 和 Docker Desktop

为了使 Docker 能够与 WSL2 正常协作，需确认已启用 WSL2 功能。对于新版本的 Windows，可以通过 PowerShell 使用命令 `wsl --set-default-version 2` 设置默认版本为 WSL2[^2]。

安装完成后，在 Docker Desktop 的通用设置中找到“Use the WSL 2 based engine”，勾选此选项来利用 WSL2 引擎运行容器服务[^3]。

#### 创建和管理 Docker 上下文

创建特定于 WSL2 的 Docker 上下文有助于区分不同的工作环境：

docker context create wsl2-context --description "Docker daemon hosted in WSL 2" --docker host=npipe:./pipe/docker_wsl

切换至新建好的上下文中执行后续操作可以确保指令被发送给位于 WSL2 中的 Docker 守护进程处理[^1]。

#### 在 IDE 或终端内调用 Docker 命令

当希望从 Windows 系统内的开发工具比如 IntelliJ IDEA 发起构建镜像或是启动容器的操作时，只需保证这些应用程序能够访问到正确的 Docker CLI 工具路径即可。通常情况下，默认安装位置下的 `docker-compose.exe` 及关联文件已经足够满足需求。

例如，通过如下方式可以在当前目录基于 Dockerfile 构建名为 `dockerdemo:0.1` 的镜像而不依赖缓存数据：

docker build --no-cache -t dockerdemo:0.1 .

#### 浏览器端口映射测试

完成上述配置之后，任何由 WSL2 内部发起的服务只要正确设置了外部可访问的端口号，则可以直接通过主机上的浏览器地址栏输入形如 `http://localhost:<port>` 来验证应用是否成功部署并对外提供服务[^5]。