Loading

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 发布页(GitHub microsoft/WSL/releases)下载对应 x64 的 .msi 安装包重新安装,再执行 wsl --version 验证。

第二步:下载并运行安装程序

  1. 下载最新稳定版安装包(官方直链):
    https://desktop.docker.com/win/main/amd64/238018/Docker%20Desktop%20Installer.exe
    
  2. 双击运行 Docker Desktop Installer.exe。
  3. 在 Configuration 页面,勾选 “Use WSL 2 instead of Hyper-V (recommended)”,其他保持默认。
  4. 点击 Ok,等待安装完成,点击 “Close and restart” 重启电脑。

第三步:启动并接受协议

  1. 重启后,从开始菜单手动打开 Docker Desktop(它不会自动启动)。
  2. 首次启动弹出 Docker Subscription Service Agreement,必须点击 “Accept”,否则引擎不会启动。
  3. 等待左下角引擎图标变为绿色(Running)。

第四步:验证安装

打开普通(非管理员)PowerShell 或 CMD,执行:

docker --version

能输出版本号即安装成功。可进一步用官方测试镜像确认引擎正常:

docker run hello-world

看到 Hello from Docker! 字样即表示一切正常。

常见问题

报错:Virtualization support not detected

按顺序排查:

  1. 任务管理器 → 性能 → CPU,确认“虚拟化”为“已启用”;若为“已禁用”,重启进 BIOS/UEFI 开启 Intel VT-x 或 AMD-V/SVM。
  2. 管理员 PowerShell 执行以下命令后重启:
    DISM /Online /Enable-Feature /FeatureName:VirtualMachinePlatform /All /NoRestart
    
  3. 检查 Hypervisor 启动类型:
    bcdedit /enum | findstr -i hypervisorlaunchtype
    
    若显示 Off,执行 bcdedit /set hypervisorlaunchtype Auto 后重启。

备注

  • 若之前装过旧版 Docker Desktop,建议先在“设置 → 应用”中卸载并重启,再按上述步骤安装。
  • 后续若在 Docker 中运行需要访问 Windows 宿主机数据库的服务,连接主机名应填 host.docker.internal,而非 localhost。
posted @ 2026-10-27 10:46  溫柔の風  阅读(31)  评论(0)    收藏  举报