逐步指南:在 Windows 和 macOS 上安装 Docker Desktop

通过在 Windows 和 macOS 上安装 Docker Desktop 来开始使用 Docker。本逐步指南涵盖了这两个操作系统的先决条件、下载说明、安装过程以及初步验证步骤。学习如何设置您的开发环境以实现高效的容器化。

分步指南:在 Windows 和 macOS 上安装 Docker Desktop

当你想在 Windows 或 macOS 笔记本电脑上运行容器时,Docker Desktop 通常是起点。安装过程很简单,但一些系统设置可能会阻止 Docker 在安装完成后启动。

本指南将引导你在 Windows 和 macOS 上安装 Docker Desktop,然后验证 Docker CLI、Docker Engine 和一个测试容器是否正常工作。

Docker Desktop 安装的内容

Docker Desktop 为你提供了一个本地 Docker 环境,包括 Docker CLI、Docker Engine、Docker Compose、一个桌面仪表板以及可选的 Kubernetes 支持。在 Windows 上,Docker Desktop 通常通过 WSL 2 运行 Linux 容器。在 macOS 上,它在一个轻量级 Linux 虚拟机内运行容器。

对于日常开发,这意味着你可以运行如下命令:

docker run hello-world
docker compose up
docker build -t my-app .

你不需要先安装单独的 Docker Engine 包。

首先检查要求

Docker 会随时间更改平台要求,因此在旧机器上安装前,请查看 Docker 的当前文档。在大多数当前设置中,你应该确认这些基本条件。

Windows 要求

使用受支持的 64 位 Windows 版本,并保持 Windows 更新。Docker Desktop 与 WSL 2 后端配合最佳,因此在安装过程中或之前安装 WSL:

wsl --install

以管理员身份运行 PowerShell 或命令提示符执行该命令,如果 Windows 要求,则重新启动。

同时检查硬件虚拟化。打开任务管理器,转到 性能,选择 CPU,查找 虚拟化:已启用。如果已禁用,请在 BIOS 或 UEFI 设置中启用它。

Docker Desktop 适用于桌面 Windows 环境,不适用于 Windows Server。

macOS 要求

在 Apple 芯片或 Intel Mac 上使用受支持的 macOS 版本。根据你的芯片类型下载正确的安装程序。如果你不确定自己的 Mac 型号,请打开 Apple 菜单 > 关于本机 并查看芯片或处理器行。

Docker Desktop 需要足够的内存和磁盘空间来运行 Linux 虚拟机并存储镜像。如果你计划在本地运行数据库或多服务堆栈,请在安装后在设置中为 Docker 分配更多内存。

在 Windows 上安装 Docker Desktop

从 Docker 官方网站下载 Docker Desktop。避免使用第三方下载镜像来获取开发者工具。

运行 .exe 安装程序,并在出现 WSL 2 选项时保持启用。如果安装程序提供添加所需的 Windows 组件,请允许。安装后,如果提示,请重新启动计算机。

从开始菜单打开 Docker Desktop。首次启动时,接受许可条款并让 Docker 完成设置。如果 Docker 报告 WSL 问题,请更新 WSL 并重试:

wsl --update

如果你使用公司笔记本电脑,端点安全软件可能会干扰虚拟化或本地网络。在这种情况下,请在更改防火墙或防病毒设置前检查你公司的 Docker Desktop 策略。

在 macOS 上安装 Docker Desktop

从 Docker 官方网站下载适用于 Mac 的 Docker Desktop。为 M 系列 Mac 选择 Apple 芯片安装程序,为 Intel Mac 选择 Intel 安装程序。

打开 .dmg 文件,然后将 Docker 拖入应用程序文件夹。从应用程序启动 Docker。macOS 可能会要求输入密码或权限以安装用于网络和虚拟化的辅助组件。

当 Docker Desktop 启动时,等待菜单栏图标显示 Docker 正在运行。首次启动可能需要更长时间,因为 Docker 会创建其本地虚拟机和存储。

验证安装

打开终端并检查 Docker 客户端和服务器:

docker version

你应该看到客户端部分和服务器部分。如果只看到客户端信息或有关连接守护进程的错误,则说明 Docker Desktop 尚未运行或启动失败。

运行标准测试容器:

docker run hello-world

Docker 会下载一个小镜像并运行它。成功运行会打印一条消息,说明 Docker 正在工作。

你还可以检查 Docker Compose:

docker compose version

使用空格分隔的 docker compose 命令用于 Compose v2,它已包含在 Docker Desktop 中。

调整初始设置

在首次成功测试后打开 Docker Desktop 设置。

在 Windows 上,检查 资源 > WSL 集成,并为你运行开发命令的 Linux 发行版启用集成。如果你在 WSL 中使用 Ubuntu,这将允许你从 Ubuntu shell 运行 docker

在 Windows 和 macOS 上,查看 资源。小型项目可能默认设置就足够,但本地 Kubernetes、数据库和大规模构建通常需要更多内存或磁盘空间。

仅当你需要本地单节点集群时才启用 Kubernetes。保持禁用状态可使 Docker Desktop 更轻量。

常见安装问题

如果 Docker 在 Windows 上无法启动,首先确认虚拟化已启用且 WSL 已安装:

wsl --status

如果 WSL 过时,请运行:

wsl --update

如果 docker version 无法连接到 Docker 守护进程,请确保 Docker Desktop 正在运行且已完成启动。在 macOS 上,检查菜单栏图标。在 Windows 上,检查系统托盘。

如果测试容器无法访问网络,请从不同的网络或 VPN 状态进行测试。VPN 客户端和公司代理通常会影响 Docker 网络。当你的环境需要时,Docker Desktop 提供了可配置的代理设置。

一旦 docker run hello-world 正常工作,你的本地容器环境就准备好了。一个好的下一步是运行一个你已经知道的服务,例如 Nginx:

docker run --rm -p 8080:80 nginx

然后打开 http://localhost:8080。如果你看到 Nginx 欢迎页面,说明 Docker 可以拉取镜像、启动容器并在你的机器上发布端口。