Windows安装 Docker Desktop

Windows 安装 Docker Desktop（推荐 WSL2 后端，跑 AI 容器、vLLM 首选方案）

系统要求：Windows10 2004+/Windows11 64 位；CPU 必须开启硬件虚拟化 ⚠️ 家庭版 Windows不支持 Hyper-V，只能用 WSL2 模式。

前置第一步：检查 CPU 虚拟化（必做）

1. Ctrl+Shift+Esc 打开任务管理器 →【性能】→CPU
2. 右侧查看：虚拟化：已启用

• 如果显示【已禁用】：重启电脑，进 BIOS/UEFI 打开 Intel VT-x / AMD-V，保存重启。

第二步：一键启用 WSL2（管理员 PowerShell）

1. 开始菜单搜索 PowerShell → 右键【以管理员身份运行】 执行命令：

# 安装WSL组件，不额外装Ubuntu发行版
wsl --install --no-distribution

　　执行完成后 重启电脑。

　　重启后再次打开管理员 PowerShell，执行：

# 更新WSL内核
wsl --update
# 设置默认使用WSL2
wsl --set-default-version 2

 

备选：图形化手动开启（命令失败时用）

控制面板 → 程序 → 启用或关闭 Windows 功能 ✅ 勾选两项：

• 适用于 Linux 的 Windows 子系统
• 虚拟机平台 确定后重启电脑。

第三步：下载 Docker Desktop 官方安装包

官方直链（x64 普通电脑）： https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe

不要第三方修改安装包！

第四步：安装 Docker Desktop

1. 双击 Docker Desktop Installer.exe
2. 弹出配置框，务必勾选： ✅ Use WSL 2 instead of Hyper-V
3. 点击 OK 等待安装结束
4. 选择 Close and log out，注销并重新登录 Windows。

第五步：启动 & 验证安装

1. 开始菜单打开 Docker Desktop，同意许可协议；等待后台初始化 wsl docker 环境（首次启动较慢）。
2. 新开普通 PowerShell / CMD，执行测试命令：

# 查看版本
docker --version
# 运行测试容器
docker run hello-world

# 输出 Hello from Docker! 代表安装成功。

 

第六步（重要）配置国内镜像加速（解决拉取镜像超时）

1. Docker Desktop 右上角 ⚙️ Settings → Docker Engine
2. 在 json 配置内添加 registry-mirrors

   {
     "registry-mirrors": [
       "https://docker.mirrors.ustc.edu.cn",
       "https://hub-mirror.c.163.com"
     ],
     "builder": {
       "gc": {
         "defaultKeepStorage": "20GB"
       }
     },
     "experimental": false
   }

3. 点击右下角 Apply & Restart 重启生效。

第七步：WSL2 资源限制（推荐，防止 Docker 吃光内存）

很多人跑容器时 WSL 无限占用内存，可以限制最大内存：

1. 用户目录新建文件：C:\Users\你的用户名\.wslconfig 写入内容：

[wsl2]
memory=12GB
processors=6
swap=4GB

memory 根据你的电脑调整（例如 16G 内存主机填 10GB，32G 填 16GB） 保存后管理员终端执行：

wsl --shutdown

重启 Docker 即可生效。

 

常见报错解决

1. Unexpected WSL error

原因：虚拟化没开 / WSL 组件缺失

• 确认 BIOS 虚拟化开启；
• 重新执行 wsl --update，重启电脑；
• 执行：bcdedit /set hypervisorlaunchtype auto 再重启。

2. Docker 启动提示 WSL distro 找不到

　　管理员终端执行关闭 wsl：

wsl --shutdown

重启 Docker Desktop。

 

3. 家庭版 Windows 无法勾选 Hyper-V

　　完全不用 Hyper-V，保持 WSL2 模式即可，不要尝试开启 Hyper-V。

AI 场景额外提示（你后续跑 vLLM、大模型容器）

　　如果你要在 Docker 内使用NVIDIA 显卡 GPU： 需要额外安装 NVIDIA Container Toolkit for WSL2，才能让容器内部访问本机 RTX 显卡。 需要我把 WSL2 启用 Docker GPU 直通的完整步骤发给你吗？