好的,阿杰 👍
下面是最详细、手把手的 Windows 安装 Docker Desktop 教程 —— 无论你是第一次接触 Docker,还是想重新配置,都可以一步一步照着来。


🐳 一、Docker Desktop 是什么?

Docker Desktop 是官方提供的可视化桌面版本,用来在 Windows 上运行 Docker 容器。
它包含:

  • Docker Engine(容器核心引擎)
  • Docker CLI(命令行工具)
  • Docker Compose
  • Docker Hub 登录功能
  • 图形界面 (Dashboard)

🧩 二、系统要求

⚠️ 必须满足以下条件,否则安装会失败。

项目最低要求
操作系统Windows 10 64-bit 专业版/企业版/Education (Build 19045+)Windows 11
虚拟化必须启用 Hyper-VWSL2
CPU支持虚拟化(Intel VT-x / AMD-V)
内存建议 8GB 以上
硬盘至少 20GB 空闲空间
网络需要访问 https://desktop.docker.com 下载文件

⚙️ 三、开启虚拟化支持

✅ 1. 检查是否已启用

按下:

Ctrl + Shift + Esc

打开任务管理器 → 切换到 性能 (Performance) → 选 CPU
→ 右下角看看 “虚拟化” 是否显示为 已启用 (Enabled)

如果是 ✅ 已启用,可以跳到下一步。


🚀 2. 在 BIOS 中开启虚拟化

如果是 未启用,你需要:

  1. 重启电脑,进入 BIOS(开机按 DelF2F10ESC 等键,视主板而定)
  2. 找到下列选项之一并启用:
    • Intel CPU:Intel Virtualization Technology (VT-x)
    • AMD CPU:SVM Mode
  3. 保存并退出 BIOS (F10 保存)
  4. 重启回到系统后再检查,确认 “虚拟化:已启用”。

🧱 四、启用 WSL 2(Windows Subsystem for Linux)

Docker Desktop 在 Windows 上主要依赖 WSL2 来运行容器。
我们现在来启用它👇

✅ 1. 打开 PowerShell(管理员权限)

右键开始菜单 → “Windows PowerShell(管理员)”

输入命令:

wsl --install

等待系统自动安装 Linux 内核与 WSL2 组件。
(需要联网,会自动下载安装 Ubuntu)


✅ 2. 设置 WSL 默认版本为 2

wsl --set-default-version 2

如果出现 “wsl: 无法识别命令”,请重启电脑或更新 Windows。


✅ 3. 验证是否安装成功

输入:

wsl -l -v

若看到:

NAME      STATE           VERSION
Ubuntu    Running         2

表示成功安装。


🧰 五、下载并安装 Docker Desktop

✅ 1. 前往官方下载页面

👉 https://www.docker.com/products/docker-desktop/

点击 Download for Windows (Windows 10/11)


✅ 2. 运行安装程序

下载完成后,双击 Docker Desktop Installer.exe

  • 勾选:
    • ✅ “Install required Windows components for WSL 2”
  • 点击 “OK” 安装

安装过程中可能会提示:

“Docker Desktop requires the WSL 2 feature to be enabled”

此时点击 “Yes”,让它帮你配置。

等待几分钟后,会提示安装完成。


✅ 3. 登录 Docker Hub(可选)

安装完成后首次启动时,会弹出登录窗口:

  • 你可以点击 “Skip” 跳过登录(仍可使用 Docker 本地功能)
  • 或注册一个 Docker Hub 账号后登录(用于拉取镜像)

✅ 4. 检查 Docker 是否运行

打开命令提示符或 PowerShell:

docker version

若输出类似:

Client: Docker Engine - Community
 Version: 27.0.0
Server: Docker Engine - Community
 Engine:
  Version: 27.0.0

则安装成功 🎉


🔧 六、设置镜像加速器(重要!提升国内拉取速度)

由于访问 Docker Hub 在国内较慢,建议配置镜像加速。

  1. 打开 Docker Desktop → Settings
  2. 左侧选择 Docker Engine
  3. "registry-mirrors" 中加入国内镜像源,如:
{
  "registry-mirrors": [
    "https://docker.m.daocloud.io",
    "https://mirror.ccs.tencentyun.com",
    "https://registry.docker-cn.com"
  ]
}

  1. 点击右下角 Apply & Restart

🧠 七、测试 Docker 是否可用

打开 PowerShell 输入:

docker run hello-world

如果输出:

Hello from Docker!
This message shows that your installation appears to be working correctly.

恭喜你 🎉
Docker Desktop 安装成功!


🧩 八、常见问题解决

问题原因解决方法
Docker 启动时报错 “WSL kernel not installed”没安装 WSL2 内核手动安装:https://aka.ms/wsl2kernel
出现 “WSL 2 installation is incomplete”系统版本太低Windows 版本需 ≥ 19045,执行 winver 查看
启动后提示 “Cannot enable Hyper-V”Home 版本系统默认禁用用 WSL2 模式运行,不使用 Hyper-V
拉取镜像慢网络限制配置镜像加速器
容器无法访问外网防火墙阻断在 Windows 防火墙中允许 Docker Desktop 网络

🧾 九、卸载 / 重新安装

如果要卸载:

  1. 打开 设置 → 应用 → 已安装的应用
  2. 搜索 “Docker Desktop”
  3. 点击 卸载
  4. 若要清除数据,删除以下目录: %AppData%\Docker %LocalAppData%\Docker %UserProfile%\.docker

重新安装时,重复本教程即可。


✅ 十、下一步建议

安装完 Docker Desktop 后,你可以尝试:

  1. 运行一个简单的 Nginx: docker run -d -p 8080:80 nginx 然后浏览器访问:http://localhost:8080
  2. 尝试运行 vLLM 镜像: docker pull vllm/vllm-openai:latest