### 解决方案概述 Docker Desktop 和基于 WSL2 的 Docker Engine 是两种不同的工具，它们可能会因为端口占用或其他资源分配问题而发生冲突。为了有效解决这种冲突，可以选择禁用 Docker Desktop 中的 WSL2 功能并切换到纯 WSL2 环境下的 Docker Engine[^1]。 以下是具体的实现方法： --- ### 方法一：完全移除 Docker Desktop 并使用 WSL2 原生支持 如果决定不再使用 Docker Desktop，则可以通过以下方式配置 WSL2 上的 Docker Engine： #### 安装必要的组件 1. **启用 WSL2** 如果尚未安装 WSL2，请按照官方文档完成设置[^2]。 2. **安装 Ubuntu 发行版** 使用 Microsoft Store 或其他途径下载并安装最新版本的 Ubuntu。 3. **更新包管理器** ```bash sudo apt update && sudo apt upgrade -y ``` 4. **导入 Docker 官方 GPG 密钥** ```bash sudo install -m 0755 -d /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null ``` 此命令会根据当前系统的 Ubuntu 版本自动匹配对应的仓库地址[^2]。 5. **安装 Docker Engine** ```bash sudo apt-get update sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin ``` 6. **启动并验证服务状态** 启动 Docker 服务并测试其功能： ```bash sudo systemctl start docker sudo docker run hello-world ``` --- ### 方法二：保留 Docker Desktop 并调整配置 如果希望继续使用 Docker Desktop 而不引发冲突，可以尝试以下措施： 1. **关闭 Docker Desktop 的 WSL2 支持** 打开 Docker Desktop 设置界面，在 `General` -> `Use the WSL 2 based engine` 处取消勾选此项[^3]。 2. **手动指定 Docker Socket 文件路径** 修改环境变量以区分两个 Docker 实例使用的套接字文件位置： ```bash export DOCKER_HOST="unix:///var/run/user/$(id -u)/docker.sock" ``` 3. **避免端口冲突** 默认情况下，Docker Desktop 占用了本地主机上的 TCP 端口 2375 和 2376。可以在 Windows 防火墙中释放这些端口或将自定义映射应用于特定容器实例。 --- ### 注意事项 无论采用哪种策略，都需要确保系统中的依赖项已正确初始化以及权限授予无误。例如，将当前用户加入 `docker` 用户组以便无需每次都输入密码执行相关操作： ```bash sudo usermod -aG docker $USER newgrp docker ``` 此外，定期检查日志记录来确认是否存在潜在异常情况也很重要： ```bash journalctl -xe | grep docker ``` ---