好的,阿杰 👍
下面是最详细、手把手的 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-V 或 WSL2 |
CPU | 支持虚拟化(Intel VT-x / AMD-V) |
内存 | 建议 8GB 以上 |
硬盘 | 至少 20GB 空闲空间 |
网络 | 需要访问 https://desktop.docker.com 下载文件 |
⚙️ 三、开启虚拟化支持
✅ 1. 检查是否已启用
按下:
Ctrl + Shift + Esc
打开任务管理器 → 切换到 性能 (Performance) → 选 CPU
→ 右下角看看 “虚拟化” 是否显示为 已启用 (Enabled)。
如果是 ✅ 已启用,可以跳到下一步。
🚀 2. 在 BIOS 中开启虚拟化
如果是 未启用,你需要:
- 重启电脑,进入 BIOS(开机按
Del
、F2
、F10
、ESC
等键,视主板而定) - 找到下列选项之一并启用:
- Intel CPU:
Intel Virtualization Technology (VT-x)
- AMD CPU:
SVM Mode
- Intel CPU:
- 保存并退出 BIOS (
F10
保存) - 重启回到系统后再检查,确认 “虚拟化:已启用”。
🧱 四、启用 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 在国内较慢,建议配置镜像加速。
- 打开 Docker Desktop → Settings
- 左侧选择 Docker Engine
- 在
"registry-mirrors"
中加入国内镜像源,如:
{
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://mirror.ccs.tencentyun.com",
"https://registry.docker-cn.com"
]
}
- 点击右下角 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 网络 |
🧾 九、卸载 / 重新安装
如果要卸载:
- 打开 设置 → 应用 → 已安装的应用
- 搜索 “Docker Desktop”
- 点击 卸载
- 若要清除数据,删除以下目录:
%AppData%\Docker %LocalAppData%\Docker %UserProfile%\.docker
重新安装时,重复本教程即可。
✅ 十、下一步建议
安装完 Docker Desktop 后,你可以尝试:
- 运行一个简单的 Nginx:
docker run -d -p 8080:80 nginx
然后浏览器访问:http://localhost:8080 - 尝试运行 vLLM 镜像:
docker pull vllm/vllm-openai:latest
发表回复