Windows 本地安装 Docker Desktop
适用场景:在 Windows 物理机上安装最新稳定版 Docker Desktop(版本必然 ≥ 4.17),供本地容器化开发或运行 Wren AI 等服务使用。
核心要点:Docker Desktop 直接装在 Windows 本机,不装进虚拟机;后端使用 WSL 2。
前置条件
- 64 位 Windows 10(22H2 及以上)或 Windows 11
- BIOS/UEFI 中已开启硬件虚拟化(任务管理器 → 性能 → CPU → 虚拟化显示“已启用”)
- 至少 4GB 内存
第一步:确认 WSL 2 就绪
以管理员身份打开 PowerShell,执行:
wsl --version
- 能显示版本号(如
2.x.x或3.x.x)→ 直接进入第二步。 - 提示命令不存在或版本过低 → 执行以下命令,按提示重启后再更新:
wsl --install
wsl --update
若报错
Wsl/CallMsi/Install/REGDB_E_CLASSNOTREG(没有注册类),说明 WSL 组件注册异常。可到微软官方 WSL 发布页(GitHubmicrosoft/WSL/releases)下载对应 x64 的.msi安装包重新安装,再执行wsl --version验证。
第二步:下载并运行安装程序
- 下载最新稳定版安装包(官方直链):
https://desktop.docker.com/win/main/amd64/238018/Docker%20Desktop%20Installer.exe - 双击运行
Docker Desktop Installer.exe。 - 在 Configuration 页面,勾选 “Use WSL 2 instead of Hyper-V (recommended)”,其他保持默认。
- 点击 Ok,等待安装完成,点击 “Close and restart” 重启电脑。
第三步:启动并接受协议
- 重启后,从开始菜单手动打开 Docker Desktop(它不会自动启动)。
- 首次启动弹出 Docker Subscription Service Agreement,必须点击 “Accept”,否则引擎不会启动。
- 等待左下角引擎图标变为绿色(Running)。
第四步:验证安装
打开普通(非管理员)PowerShell 或 CMD,执行:
docker --version
能输出版本号即安装成功。可进一步用官方测试镜像确认引擎正常:
docker run hello-world
看到 Hello from Docker! 字样即表示一切正常。
常见问题
报错:Virtualization support not detected
按顺序排查:
- 任务管理器 → 性能 → CPU,确认“虚拟化”为“已启用”;若为“已禁用”,重启进 BIOS/UEFI 开启 Intel VT-x 或 AMD-V/SVM。
- 管理员 PowerShell 执行以下命令后重启:
DISM /Online /Enable-Feature /FeatureName:VirtualMachinePlatform /All /NoRestart - 检查 Hypervisor 启动类型:
若显示bcdedit /enum | findstr -i hypervisorlaunchtypeOff,执行bcdedit /set hypervisorlaunchtype Auto后重启。
备注
- 若之前装过旧版 Docker Desktop,建议先在“设置 → 应用”中卸载并重启,再按上述步骤安装。
- 后续若在 Docker 中运行需要访问 Windows 宿主机数据库的服务,连接主机名应填
host.docker.internal,而非localhost。
DJOSIMON

浙公网安备 33010602011771号