认准官网

Docker Desktop 官方下载与安装：Windows 上先装 WSL2，再用 docker run 验证

2026-10-24

标签Docker官方下载开发环境

Docker Desktop 是 Docker 官方提供的一个桌面应用，让你在 Windows 或 macOS 上直接运行和管理 Linux 容器，个人开发者使用 Personal 计划免费（Docker 官网标价 $0）。它的官方下载入口只有一个：Docker 官网的 Docker Desktop 产品页（www.docker.com 下），页面上有 Download for Windows 按钮。对 Windows 用户来说，装 Docker Desktop 之前必须先准备好 WSL2，否则装完之后程序无法启动。下面按从零到可用的顺序把步骤写清楚。

装之前先确认三件事，不满足先补齐

Docker Desktop for Windows 对系统有最低要求，达不到会装不上或启动即报错：

| 检查项 | 要求 | 怎么查 | |------|------|------| | Windows 版本 | Win10 2004（Build 19041）及以上，或任意 Win11 | 按 Win+R 输入 winver 回车 | | CPU 虚拟化 | 必须在 BIOS/固件中开启 | 任务管理器 → 性能 → CPU，看「虚拟化」是否为已启用 | | 内存与硬盘 | 建议内存 ≥ 8GB，预留至少 10GB 空间 | 任务管理器 → 性能 → 内存 |

如果虚拟化显示「已禁用」，需要重启进 BIOS（常见按键 F2/Delete/F10），Intel CPU 开 VT-x，AMD CPU 开 SVM Mode。这一步不做，后面 Docker Desktop 会一直起不来。

第一步：用一条命令装好 WSL2

WSL2 是 Docker Desktop 在 Windows 上运行 Linux 容器的底层环境，官方推荐用它替代旧的 Hyper-V 方案。装法很简单：右键开始菜单，打开「Windows 终端（管理员）」或「PowerShell（管理员）」，执行：

wsl --install

执行完必须重启电脑。重启后通常会弹出 Ubuntu 终端窗口，提示你设置 Linux 用户名和密码——这一步会出现在那里，直接正常设置即可。装完可以用 wsl --status 确认默认版本是 2；如果想手工核对，就是开启「适用于 Linux 的 Windows 子系统」和「虚拟机平台」两个功能，再把默认版本设为 2。

第二步：从官网下载 Docker Desktop 安装包

打开 docker.com，进入 Docker Desktop 产品页，点 Download for Windows。页面会按 CPU 架构提供 AMD64 和 ARM64 两个版本的安装包，普通 Intel/AMD 电脑选 AMD64，苹果自研芯片的 Mac 用户选 Apple Silicon 版本。拿到的是 Docker Desktop Installer.exe，运行前先和官方安装包名对一下，别从搜索引擎里的「高速下载站」下载，那些站点经常把安装包二次打包、塞推广软件。

第三步：安装时的三个关键勾选

双击安装包后，在配置界面注意三个地方：

  1. 勾选 Use WSL 2 instead of Hyper-V（recommended）——新电脑默认推荐，保持勾选；
  2. 不要勾选 Allow Windows Containers——除非你明确要运行 Windows 容器，普通开发用 Linux 容器就够了；
  3. 是否添加桌面快捷方式按个人习惯，勾不勾都行。

安装过程会自动完成，期间不需要手动选路径。完成后桌面会出现 Docker Desktop 图标。

第四步：启动并验证容器能跑

双击图标启动，第一次启动比较慢，因为要完成初始化。启动过程中会弹服务协议窗口，同意即可；Docker 账号可以跳过登录，不登录也不影响使用。等界面进入正常的引导页后，打开任意终端（PowerShell、CMD 或 WSL 终端都行），执行：

docker run hello-world

能输出一段欢迎信息（Hello from Docker! 之类），就说明 Docker 完全可用。如果提示 docker 命令找不到，多半是 WSL 集成没开启：进 Docker Desktop 设置 → Resources → WSL Integration，把当前使用的发行版（如 Ubuntu）勾上再重启。

装完顺手做的三个设置

容器跑通后，建议做三件小事，能省掉后面很多麻烦：

  1. 迁移镜像存储位置：默认镜像存在 C 盘，进设置 → Resources → Advanced，把 Disk image location 改到 D 盘或其他空间大的盘，点 Apply & Restart 就会迁移；
  2. 配置镜像加速：国内直接拉镜像经常超时，在设置 → Docker Engine 的 JSON 里给 registry-mirrors 数组加一个可用的镜像源地址，保存重启；
  3. 限制资源占用：在 Resources → Advanced 里把内存、CPU 上限设到物理机的一半左右，避免 Docker 吃满整机。

Docker 的计划怎么选

Docker 官网目前的订阅分四档：Personal 对个人开发者免费，Pro 面向需要高级功能的个人专业用户（约每月 $9），Team 面向小团队（约每月 $15/人），Business 面向企业（约每月 $24/人）且有安全合规类功能。自己装机学习、个人项目开发，用 Personal 就够了；团队协作才需要考虑付费档。

常见启动问题怎么排查

装好之后遇到打不开、启动失败，按下面顺序排查，多数问题不用重装：

  1. 启动即报「WSL 相关错误」：先回管理员终端执行 wsl --status，确认默认版本为 2；版本不对就执行 wsl --set-default-version 2，完成后重启 Docker Desktop；
  2. 一直转圈不进入主界面：检查任务管理器里 CPU 虚拟化是否为「已启用」，被禁用会导致 WSL 起不来，需要进 BIOS 开启虚拟化后重启；
  3. 容器能跑但镜像拉取慢或超时：在设置 → Docker Engine 的 JSON 里加 registry-mirrors 镜像加速，保存并重启后重试；
  4. 报磁盘空间不足：镜像默认存 C 盘，迁移到其他盘符即可，迁移操作会保留已有镜像，不影响已有容器使用；
  5. 权限类报错（访问被拒绝）：确认是以普通用户身份正常安装，而不是从奇怪的「绿色版」解压运行——Docker Desktop 必须通过官方安装器安装。

如果以上都排查完仍无法启动，完整重装是最快的兜底方案：卸载 Docker Desktop、重启系统、重新走一遍上面的官方安装流程，此类复杂环境问题绝大多数能靠重装解决。

装完做这几件确认

  • [ ] wsl --status 显示默认版本为 2，虚拟化在任务管理器中显示「已启用」
  • [ ] docker run hello-world 能正常输出欢迎信息
  • [ ] Docker Desktop 设置里的 WSL Integration 已勾选你的 Linux 发行版
  • [ ] 镜像存储位置已迁移到非系统盘（如果 C 盘紧张）
  • [ ] 确认是从 docker.com 官方页面下载的安装包，不是第三方「高速下载站」版本