当前位置：首页 > news >正文

Windows 11 24H2 图形化安装 Docker Desktop（自定义安装路径到 D 盘）

news 2025/10/18 5:41:42

🐳 Windows 11 24H2 图形化安装 Docker Desktop（自定义安装路径到 D 盘）

💡适用系统：Windows 11 24H2
📦目标路径：D:\setupTools\docker
🧭安装方式：显示完整安装界面（非静默模式）

🧩 一、前置条件

在安装前，先确认以下三项都开启了：

虚拟化已启用（BIOS）
- Intel CPU：VT-x
- AMD CPU：SVM
  可在任务管理器 → 性能 → CPU 中查看 “虚拟化：已启用”

启用必要的 Windows 功能
打开管理员 PowerShell，执行：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

如果你希望支持 Hyper-V：

dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V /all /norestart

重启电脑
```
shutdown /r /t 0
```

🐧 二、安装或更新 WSL2

在 PowerShell 执行：

wsl --install
wsl --update
wsl --set-default-version 2

确认结果：

wsl -l -v

显示 “VERSION 2” 即代表成功。

🚀 三、图形化安装 Docker Desktop 到 D 盘

1️⃣ 在 PowerShell 或文件资源管理器运行以下命令：

Start-Process "D:\setupTools\archive\Docker Desktop Installer.exe"

2️⃣ 会弹出 Docker Desktop 安装界面。
在安装界面中：

点击 “Customize”
修改路径为：
```
D:\setupTools\docker
```
勾选：
- ✅ Use WSL 2 instead of Hyper-V
- ✅ Add shortcut to desktop
点击 “OK” → “Install”

3️⃣ 等待安装进度条完成（大约 2-3 分钟）。
安装完成后，会提示 “Installation succeeded”。

🧱 四、首次启动配置

安装完成后，运行：

Start-Process "D:\setupTools\docker\Docker Desktop.exe"

或者从开始菜单点击 “Docker Desktop”。

首次启动时：

Docker 会自动检测 WSL；
创建 docker-desktop 环境；
初始化 Docker Engine；
（可选）要求登录 Docker Hub，可跳过。

✅ 五、验证安装

在 PowerShell 中输入：

docker version

输出类似：

Client: Docker Engine - CommunityVersion: 27.x.x
...
Server: Docker DesktopEngine:Version: 27.x.x

说明安装成功 🎉

⚙️ 六、（可选）把 Docker 数据放到 D 盘

为防止未来镜像/容器文件占满 C 盘，可以在安装后设置 WSL 默认存储路径：

wsl --shutdown
mkdir D:\setupTools\wsl
setx WSL2_VM_DIR "D:\setupTools\wsl"

之后新建的 Docker/WSL 环境都会保存在 D 盘。

💡 七、常见错误提示

错误提示	原因	解决方法
`HCS_E_SERVICE_NOT_AVAILABLE`	虚拟化或 WSL 功能未启用	重新执行 DISM 命令并重启
Docker Desktop 无法启动	Windows Defender/VBS 干扰	BIOS 打开虚拟化并关闭 VBS
`WSL 内核过旧`	系统内核版本太低	执行 `wsl --update`