Docker Desktop 安装指南:Windows、macOS、Linux 下载与首次运行
简答:如果你只是想把 Docker Desktop 装起来:先从 Docker 官方页面按系统和芯片下载,再检查虚拟化、内存与系统版本;Windows 通常先选 WSL 2,Mac 区分 Apple 芯片与 Intel,Linux 还要检查 KVM。安装后启动 Docker Desktop,等待 Engine 就绪,再运行一条 hello-world 命令验证。版本与界面会变化,本次核验日期为 2026 年 11 月 17 日。
定义:Docker Desktop 是面向 Mac、Linux 和 Windows 的桌面应用,集成 Docker Engine、Docker CLI、Compose 等组件,用于本机创建、运行和管理容器。
先看这张速查表:你应该下载哪个 Docker Desktop
如果目标是本机开发,先按操作系统和处理器架构选择官方安装包,再检查虚拟化和许可条件;不要从不明镜像站下载安装程序。Docker 官方将 Docker Desktop 定义为可在 Mac、Linux 和 Windows 上安装的桌面应用,并集成 Docker Engine、Docker CLI、Docker Compose 等组件,可参考Docker Desktop 官方文档。
| 设备或场景 | 下载与选择 | 安装前重点检查 |
|---|---|---|
| Windows x86_64 | 选择 Windows AMD64 或 x86_64 安装包 | Windows 版本、WSL 2、8GB 内存、BIOS/UEFI 硬件虚拟化 |
| Windows ARM | 以当前官方页面是否提供 ARM 安装包为准 | 后端支持和功能状态需以当前安装页为准 |
| Mac Apple 芯片 | 选择 Mac with Apple silicon | 支持的 macOS、至少 4GB 内存;Rosetta 2 按需要安装 |
| Mac Intel | 选择 Mac with Intel chip | 支持的 macOS、至少 4GB 内存 |
| Linux | 从 Linux 安装页进入对应发行版安装包 | 64 位 CPU、KVM、QEMU、systemd 和桌面环境 |
本表依据 Docker 官方安装页整理,版本、下载按钮和可用架构可能变化;本次核验日期为 2026 年 11 月 17 日,请以当前官方页面为准。
Docker Desktop、Docker Engine 和 Docker CLI 有什么区别
Docker Desktop 是桌面应用,Docker Engine 是负责构建和运行容器的核心运行时,Docker CLI 是在终端执行 Docker 命令的客户端。
- Docker Desktop:提供图形界面、设置入口、容器与镜像管理,并负责在不同系统上准备运行环境。
- Docker Engine:真正启动容器、创建网络和管理镜像;Docker Desktop 页面将它列为内置组件。
- Docker CLI:通过
docker run、docker pull、docker ps等命令与 Engine 通信。 - Docker Compose:用于通过配置文件管理多个容器,通常随 Docker Desktop 一起提供。
Linux 用户需要特别注意:Docker Desktop for Linux 会运行虚拟机,并创建名为 desktop-linux 的 Docker context;如果本机原先已有 Docker Engine,两者可能因端口和资源占用产生冲突,具体可参考Linux 安装说明。
Windows 安装步骤:优先检查 WSL 2 与硬件虚拟化
Windows 安装的关键不是双击安装包,而是先确认系统版本、WSL 2 和硬件虚拟化满足官方要求。
- 打开 Docker 官方 Windows 安装页,选择与处理器匹配的安装包;官方页面同时提供 x86_64、Microsoft Store 和部分 ARM 入口,下载前核对架构。
- 检查 Windows 版本是否满足当前页面要求;本次核验页面列出 Windows 10 64 位 22H2,以及 Windows 11 64 位 23H2 或更高版本,实际支持范围应以当前页面为准。
- 确认 WSL 版本达到页面要求,并在 BIOS/UEFI 中启用硬件虚拟化;官方页面还列出 64 位处理器、SLAT 和 8GB 系统内存等前置条件。
- 运行安装程序,选择 per-user 或 all-users 安装模式。普通个人开发环境通常可先使用默认的 per-user 模式;需要 Windows 容器或统一安装位置时,再按权限需求选择。
- 在配置页选择后端。WSL 2 是常见起点;Hyper-V、Docker VMM 等选项是否出现,取决于安装模式、处理器架构和当前版本。
- 安装完成后启动 Docker Desktop,等待 Docker Engine 完成启动,再在 PowerShell 或终端运行验证命令。
Windows 具体菜单、后端名称和 ARM 支持状态会随版本变化,安装前请查看Docker 官方 Windows 安装页面,不要依据旧截图判断当前界面。
macOS 安装步骤:先确认 Apple 芯片还是 Intel
Mac 安装最容易出错的地方是下载错架构,因此先在“关于本机”确认处理器,再选择 Apple silicon 或 Intel 安装包。
- 从 Docker 官方 Mac 安装页选择 Apple silicon 或 Intel 下载入口。
- 打开下载的
Docker.dmg,将 Docker 图标拖入 Applications 文件夹。 - 从 Applications 启动 Docker.app,阅读并接受 Docker Desktop Subscription Service Agreement。
- 等待 Docker Desktop 启动完成;官方当前说明会将 CLI 工具放入用户目录下的
$HOME/.docker/bin,具体路径和设置仍以当前版本为准。 - 如果需要运行部分 Darwin/AMD64 命令行工具,可按官方说明安装 Rosetta 2:
softwareupdate --install-rosetta。
Docker 官方当前说明支持当前及前两个主要 macOS 版本,并要求至少 4GB 内存;这是滚动条件,不应把某个固定 macOS 版本长期写死。安装细节请查看Docker 官方 Mac 安装页面。
Linux 安装步骤:先确认发行版、KVM 和 Docker context
Linux 版 Docker Desktop 不是简单的桌面壳层,它会在虚拟机中运行并使用独立存储,因此安装前要区分它与原生 Docker Engine。
- 确认发行版和架构。Docker 官方当前页面列出 Ubuntu、Debian、RHEL、Fedora 等支持平台,并说明 Arch 相关安装包属于实验性支持,实际状态以当前页面为准。
- 检查 64 位内核与 CPU 虚拟化支持,确认 KVM 可用。
- 检查 QEMU、systemd 和桌面环境等一般要求;官方页面列出了 QEMU 5.2 或更高版本,若系统版本不同,应以当前 Linux 安装页为准。
- 从对应发行版的官方入口下载并安装 Docker Desktop 包。
- 启动 Docker Desktop,使用
docker context ls查看当前 context;启动后通常会出现desktop-linuxcontext。 - 如果机器上同时运行原生 Docker Engine,先确认是否会发生端口冲突;不需要同时运行时,可按官方文档停止或禁用原生服务。
Linux 上不要把原生 Engine 中已有的镜像和容器默认视为 Desktop 中可见;Docker 官方说明两者使用隔离存储,切换时要检查当前 context。
许可与版本怎么核对:不要把“免费”理解成所有商业场景免费
Docker Desktop 的许可取决于使用者、组织规模和用途,个人安装前应同时看安装页和当前订阅协议。
| 使用场景 | 核对结论 | 操作建议 |
|---|---|---|
| 个人使用 | 官方安装页列为可免费使用的场景之一 | 仍应阅读当前订阅协议 |
| 教育用途 | 官方安装页列为可免费使用的场景之一 | 按实际用途核对 |
| 非商业开源项目 | 官方安装页列为可免费使用的场景之一 | 确认项目和组织情况 |
| 小型企业 | 官方页面以员工人数和年收入条件描述适用范围 | 同时核对“少于 250 名员工且年收入低于 1000 万美元”等条件 |
| 大型企业、政府或其他商业使用 | 可能需要付费订阅 | 查看当前Docker 产品与套餐页面及订阅协议 |
截至 2026 年 11 月 17 日,Docker 官方发布说明页面顶部列出的条目为 Docker Desktop 4.99.0,发布日期为 2026 年 11 月 9 日;发布页面同时提供各平台下载和校验入口。这个版本判断只代表本次访问,不代表未来长期有效,更新前应重新查看Docker Desktop Release Notes。
安装后第一步:启动 Engine 并运行首个容器
安装成功不等于 Engine 已经可用,最短验证路径是确认版本、查看运行状态并启动一个测试容器。
- 打开 Docker Desktop,等待界面显示 Engine 已启动或命令行不再返回连接错误。
- 在终端运行
docker version,确认客户端和服务端信息能够返回。 - 运行
docker run hello-world,让 Docker 拉取测试镜像并启动一次性容器。 - 如果命令提示无法连接 daemon,先回到 Docker Desktop 检查 Engine 是否仍在启动,再检查当前 context、WSL/KVM、虚拟化和代理设置。
- 如果是拉取镜像超时,先区分本机网络、DNS、代理和 Docker Hub 访问问题,不要直接反复重装;可先运行
docker info、docker context ls,并记录完整报错。
命令名称和默认界面可能因平台或版本变化而不同;遇到启动、拉取或端口问题时,优先依据当前官方文档和报错文本定位。
常见启动与连接问题:按顺序排查,不要先删数据
Docker Desktop 启动失败通常应先检查基础条件和当前后端,再处理网络或数据问题。
- 一直停留在 Starting:检查 WSL 2、Hyper-V 或 KVM 是否可用,并确认硬件虚拟化已启用。
- 提示权限不足:确认 Windows 安装模式、管理员权限和相关用户组;Mac 或 Linux 则检查当前账户是否有访问所需组件的权限。
- 镜像拉取失败:先看 DNS、代理、证书、系统时间和网络连通性,再确认 Docker Desktop 内的代理设置与当前网络是否匹配。
- 端口已被占用:检查是否同时运行原生 Docker Engine、其他容器或本地服务;Linux 用户尤其要确认当前使用的是
default还是desktop-linuxcontext。 - 安装后想回滚:先查看发布说明和备份选项;不要在未确认镜像、容器、卷和配置已备份前直接卸载或恢复出厂设置。
如果问题涉及跨境办公网络、DNS、MTU、丢包或代理链路,应先保留 Docker Desktop 的原始错误,再分别测试宿主机和容器内网络,避免把应用层故障直接归因于线路。
常见问题
Docker Desktop 从哪里下载最安全?
优先使用 Docker 官方产品页或各平台官方安装文档中的下载按钮,并核对系统、处理器架构和校验入口;不要只看搜索结果中的第三方下载站。
Windows 安装 Docker Desktop 一定要用 Hyper-V 吗?
不一定。Docker 官方 Windows 页面同时说明 WSL 2、Hyper-V 和 Docker VMM 等后端,具体可选项取决于安装模式、系统和处理器;普通 Linux 容器场景可先按当前页面检查 WSL 2。
Mac 应该下载 Apple silicon 还是 Intel 版本?
在“关于本机”查看处理器类型:Apple 芯片选择 Apple silicon,Intel 处理器选择 Intel。下载错误架构可能导致无法正常启动或运行部分工具。
Linux 已经安装 Docker Engine,还需要 Docker Desktop 吗?
不一定。Docker Desktop 提供图形界面和额外组件,但 Linux 版会运行独立虚拟机并使用 desktop-linux context;如果已有 Engine,应先判断是否需要 GUI、隔离环境和 Desktop 功能。
安装后运行 docker 命令提示无法连接怎么办?
先确认 Docker Desktop 已启动并完成 Engine 初始化,再运行 docker context ls、docker version 检查当前 context 和服务端连接;Windows 检查 WSL 2,Linux 检查 KVM,网络错误再检查 DNS 与代理。
Docker Desktop 4.99.0 现在是不是长期最新版本?
本次核验日期为 2026 年 11 月 17 日,官方发布说明顶部列出 4.99.0、日期为 2026 年 11 月 9 日。版本会继续变化,安装或更新前应重新查看当前 Release Notes。