Windows 安装 Docker Desktop

创建日期：2024/09/14 修改日期：2024/09/14 Windows Docker

- Docker Desktop 官方文档：[Install Docker Desktop on Windows](https://docs.docker.com/desktop/install/windows-install/)
- 微软 WLS 2 官方文档：[How to install Linux on Windows with WSL](https://learn.microsoft.com/en-us/windows/wsl/install)

# 下载

1. 打开官网：[https://www.docker.com/](https://www.docker.com/)
2. 点击 `Download for Windows - AMD64`

# 环境准备

- 64 位处理器
- 4GB 系统内存
- 在 BIOS 中启用硬件虚拟化
- 需要先在 Windows 系统中开启 `WSL 2` 或 `Hyper-V`

`Docker Desktop` 的功能在 `WSL 2` 和 `Hyper-V `上保持一致，不偏向任何一种架构。个人推荐使用 `WSL 2`

## WSL 2

您必须运行 Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11 才能使用以下命令。

1. 以 **管理员模式** 打开 `PowerShell` 或 `Windows 命令提示符`
2. 执行 `wsl --install --no-distribution` 命令
   - `--install` 代表执行安装
   - `--no-distribution` 代表安装 `WSL` 时不要安装发行版（即不安装一个默认的 `Ubuntu` 子系统）
3. 完成后重启电脑
4. 再次以 **管理员模式** 打开 `PowerShell` 或 `Windows 命令提示符`
5. 执行 `wsl --status` 查看状态
   1. 若提示类似于 `默认版本: 2` 则正常
   2. 若提示类似于 `默认版本: 2` 则执行 `wsl --set-default-version 2` 修改版本

## Hyper-V

注：一般是企业版 `win10/win11` 才能开启

1. 打开 `控制面板`
2. 点击 `卸载程序/程序和功能`
3. 点击 `启用或关闭 Windows 功能`
4. 勾选 `Hyper-V` 并确定
5. 等待完成并重启系统

# 安装 Docker Desktop

1. 以 **管理员模式** 运行 `Docker Desktop Installer.exe` ，默认情况下，会安装在 `C:\Program Files\Docker\Docker` 目录下
2. 在 `Configuration` 页面，完成以下配置之后点击 `OK`
   - 若以 `WSL 2` 模式，则保留默认勾选的 `Use WSL 2 instead of Hyper-V(recommended)` 
   - 若以 `Hyper-V` 默认，则取消勾选 `Use WSL 2 instead of Hyper-V(recommended)` 
   - `Add shortcut to desktop` 代表添加桌面快捷方式，自行决定
3. 安装完成后根据提示重启（若提示注销，则手动执行重启！）
4. 再次进入系统后，运行 `Docker Desktop` 程序，一般情况下，会正常运行，
   1. 第一个弹出的用户协议，必须点击同意
   2. 剩下的一些操作可以选择 `Skip` 跳过

# 补充说明

1. 先执行了 `Docker Desktop` 安装，重启后无法启动 `Docker Desktop` ，可以尝试以 **管理员模式** 打开 `PowerShell` 或 `Windows 命令提示符`执行 `wsl --update` 并重启
2. `WSL 2` 模式下可以使用 `.wslconfig` 设置一些配置（例如最大使用内存），配置文件路径为`C:\Users\<UserName>\.wslconfig`
   1. 微软官方教程：[Advanced settings configuration in WSL](https://learn.microsoft.com/en-us/windows/wsl/wsl-config)
   2. 示例配置：
   ```
   [wsl2]
   memory=4GB
   processors=2
   swap=0GB
   ```

全部评论