# 在 macOS / Windows 上安装 Docker Desktop

URL: https://caijiao.org/docker/installation/desktop
Source: docs/docker/installation/desktop.md
Description: 本章节介绍如何在 macOS 与 Windows 系统上安装 Docker Desktop，包括下载、安装步骤、系统要求、初次配置以及启动验证，帮助用户快速在桌面环境中运行 Docker。

Docker Desktop 是 Docker 官方提供的桌面版应用程序，可在 macOS 和 Windows 系统上运行 Docker 引擎与容器。它包含 Docker CLI、Docker Compose 以及 Kubernetes 的可选集成，方便开发者在本地环境进行容器化开发和测试。

## 系统要求

### macOS

- macOS 版本：10.15 及以上
- CPU：支持 Intel 或 Apple Silicon 芯片
- 内存：至少 4GB RAM
- 虚拟化支持开启（默认开启即可）

### Windows

- Windows 10/11 64-bit: Pro, Enterprise 或 Education
- 启用 WSL 2（Windows Subsystem for Linux）
- CPU：支持虚拟化技术
- 内存：至少 4GB RAM

## 下载与安装

1. 访问 Docker 官方下载页面：
   - [Docker Desktop for Mac](https://www.docker.com/products/docker-desktop/)
   - [Docker Desktop for Windows](https://www.docker.com/products/docker-desktop/)

2. 下载对应系统的安装包（.dmg / .exe）。

3. **macOS 安装步骤**
   - 双击 `.dmg` 文件
   - 拖动 Docker 图标到 Applications 文件夹
   - 打开 Docker Desktop，首次启动会要求授权

4. **Windows 安装步骤**
   - 双击 `.exe` 文件
   - 按照安装向导完成安装
   - 启用 WSL 2 集成（可选 Kubernetes）
   - 完成后启动 Docker Desktop

## 初次配置与验证

1. 打开 Docker Desktop，确保状态显示为 “Docker is running”。

2. 验证 Docker CLI

```bash
docker --version
docker run hello-world
````

成功输出 “Hello from Docker!” 表示安装完成。

3. 配置资源（可选）

   - 通过 Docker Desktop 设置 CPU、内存、磁盘空间等资源限制
   - 设置代理、镜像加速器或 Kubernetes 集群

---

安装完成后，你即可在 macOS 或 Windows 系统上使用 Docker 进行本地开发、测试和容器管理。