Docker 安装指南

本文档提供在 Windows、macOS 和 Linux（以 Ubuntu 为例）上安装 Docker 的详细步骤。选择适合你操作系统的安装方法。

---

## 1. 在 Windows 上安装 Docker

**系统要求**：Windows 10/11 专业版、企业版或教育版（支持 Hyper-V 和 WSL 2）。

### 步骤

1. **下载 Docker Desktop**：
    
    - 访问 [Docker 官网](https://www.docker.com/products/docker-desktop/)，下载 Windows 版 Docker Desktop 安装程序。
2. **安装 Docker Desktop**：
    
    - 运行 `Docker Desktop Installer.exe`。
    - 按提示安装，建议启用 WSL 2（Windows Subsystem for Linux 2）以获得最佳性能。
    - 如果未启用 WSL 2，安装程序会提示启用。
3. **启用 WSL 2（若未启用）**：
    
    - 以管理员身份打开 PowerShell，运行：
        
        ```powershell
        wsl --install
        ```
        
    - 重启计算机。
4. **启动 Docker Desktop**：
    
    - 安装完成后，启动 Docker Desktop，它会在系统托盘运行。
    - 可选择登录 Docker Hub 或跳过。
5. **验证安装**：
    
    - 打开命令提示符或 PowerShell，运行：
        
        ```bash
        docker --version
        docker run hello-world
        ```
        
    - 成功输出版本信息和 `hello-world` 容器信息即表示安装完成。

---

## 2. 在 macOS 上安装 Docker

**系统要求**：macOS 10.15 或更高版本。

### 步骤

1. **下载 Docker Desktop**：
    
    - 访问 [Docker 官网](https://www.docker.com/products/docker-desktop/)，下载 macOS 版 Docker Desktop（支持 Intel 和 Apple Silicon）。
2. **安装 Docker Desktop**：
    
    - 打开 `.dmg` 文件，将 Docker 图标拖到 Applications 文件夹。
    - 从 Applications 文件夹启动 Docker Desktop。
3. **启动 Docker Desktop**：
    
    - 启动后，Docker 图标会出现在菜单栏。
    - 可选择登录 Docker Hub 或跳过。
4. **验证安装**：
    
    - 打开终端，运行：
        
        ```bash
        docker --version
        docker run hello-world
        ```
        
    - 成功输出表示安装完成。

---

## 3. 在 Linux（Ubuntu）上安装 Docker

以下以 Ubuntu 为例，其他发行版（如 Debian、CentOS）可参考 [Docker 官方文档](https://docs.docker.com/engine/install/)。

### 步骤

1. **更新系统包**：
    
    ```bash
    sudo apt-get update
    sudo apt-get upgrade -y
    ```
    
2. **安装依赖**：
    
    ```bash
    sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common
    ```
    
3. **添加 Docker 官方 GPG 密钥**：
    
    ```bash
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
    ```
    
4. **添加 Docker 仓库**：
    
    ```bash
    echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
    ```
    
5. **安装 Docker Engine**：
    
    ```bash
    sudo apt-get update
    sudo apt-get install -y docker-ce docker-ce-cli containerd.io
    ```
    
6. **启动并启用 Docker 服务**：
    
    ```bash
    sudo systemctl start docker
    sudo systemctl enable docker
    ```
    
7. **添加用户到 Docker 组（避免每次使用 sudo）**：
    
    ```bash
    sudo usermod -aG docker $USER
    ```
    
    - 注销并重新登录以生效。
8. **验证安装**：
    
    ```bash
    docker --version
    docker run hello-world
    ```

---

## 4. 其他 Linux 发行版

- **Debian**：参考 [Debian 安装指南](https://docs.docker.com/engine/install/debian/)。
- **CentOS/RHEL**：参考 [CentOS 安装指南](https://docs.docker.com/engine/install/centos/)。
- **Fedora**：参考 [Fedora 安装指南](https://docs.docker.com/engine/install/fedora/)。

---

## 常见问题

1. **是否需要 Docker Hub 账户？**
    
    - 安装和基本使用无需账户。推送或拉取镜像到 Docker Hub 时需注册。
2. **Windows Home 版如何安装？**
    
    - Windows 10/11 Home 版不支持 Hyper-V，但可通过 WSL 2 安装 Docker Desktop。确保启用 WSL 2。
3. **Docker 不工作？**
    
    - 检查 Docker 服务状态：
        
        ```bash
        sudo systemctl status docker
        ```
        
    - 确保系统满足要求（CPU 虚拟化、内存等）。
4. **安装特定版本的 Docker？**
    
    - Linux 上可使用 `apt-get install docker-ce=<VERSION>`，参考 [Docker 版本列表](https://download.docker.com/linux/ubuntu/dists/)。