在 Windows 上安装 Docker 桌面

• WSL 版本 1.1.3.0 或更高版本。

• Windows 11 64 位：家庭版或专业版 21H2 或更高版本，或者企业版或教育版 21H2 或更高版本。

• Windows 10 64 位：

  • 我们建议使用 Home 或 Pro 22H2（内部版本 19045）或更高版本，或者 Enterprise 或 Education 22H2（内部版本 19045）或更高版本。
  • 最低要求是 Home 或 Pro 21H2（内部版本 19044）或更高版本，或者 Enterprise 或 Education 21H2（内部版本 19044）或更高版本。

• 在 Windows 上打开 WSL 2 功能。有关详细说明，请参阅 Microsoft 文档。

• 要在 Windows 10 或 Windows 11 上成功运行 WSL 2，需要满足以下硬件先决条件：

  • 具有二级地址转换 (SLAT)功能的 64 位处理器
  • 4GB系统内存
  • 在 BIOS 中启用硬件虚拟化。有关详细信息，请参阅 虚拟化。

有关使用 Docker Desktop 设置 WSL 2 的更多信息，请参阅 WSL。

重要的

要运行 Windows 容器，您需要 Windows 10 或 Windows 11 专业版或企业版。 Windows 家庭版或教育版仅允许您运行 Linux 容器。

笔记

对于仍在Microsoft 服务时间表内的 Windows 版本，Docker 仅支持 Windows 上的 Docker Desktop 。

我应该使用 Hyper-V 还是 WSL？

Docker Desktop 的功能在 WSL 和 Hyper-V 上保持一致，没有对任何一种架构的偏好。 Hyper-V 和 WSL 各有优缺点，具体取决于您的具体设置和计划的用例。

• Windows 11 64 位：专业版 21H2 或更高版本，或者企业版或教育版 21H2 或更高版本。

• Windows 10 64 位：

  • 我们建议使用 Home 或 Pro 22H2（内部版本 19045）或更高版本，或者 Enterprise 或 Education 22H2（内部版本 19045）或更高版本。
  • 最低要求是 Home 或 Pro 21H2（内部版本 19044）或更高版本，或者 Enterprise 或 Education 21H2（内部版本 19044）或更高版本。

  对于 Windows 10 和 Windows 11 家庭版，请参阅 WSL 2 后端选项卡中的系统要求。

• 打开 Hyper-V 和容器 Windows 功能。

• 要在 Windows 10 上成功运行客户端 Hyper-V，需要满足以下硬件先决条件：

  • 具有二级地址转换 (SLAT)功能的 64 位处理器
  • 4GB系统内存
  • 在 BIOS 设置中打开 BIOS 级硬件虚拟化支持。有关详细信息，请参阅 虚拟化。

重要的

要运行 Windows 容器，您需要 Windows 10 或 Windows 11 专业版或企业版。 Windows 家庭版或教育版仅允许您运行 Linux 容器。

笔记

对于仍在Microsoft 服务时间表内的 Windows 版本，Docker 仅支持 Windows 上的 Docker Desktop 。

1. 使用页面顶部的下载按钮或从 发行说明下载安装程序。

2. 双击Docker Desktop Installer.exe运行安装程序。默认情况下，Docker Desktop 安装在C:\Program Files\Docker\Docker.

3. 出现提示时，请确保选择或不选择“配置”页面上的“使用 WSL 2 而不是 Hyper-V”选项，具体取决于您选择的后端。

   如果您的系统仅支持这两个选项之一，您将无法选择使用哪个后端。

4. 按照安装向导上的说明授权安装程序并继续安装。

5. 安装成功后，选择关闭以完成安装过程。

如果您的管理员帐户与您的用户帐户不同，则必须将该用户添加到docker-users组：

1. 以管理员身份运行计算机管理。
2. 导航到本地用户和组>组> docker-users。
3. 右键单击将用户添加到组中。
4. 注销并重新登录以使更改生效。

下载后Docker Desktop Installer.exe，在终端中运行以下命令来安装 Docker Desktop：

$ "Docker Desktop Installer.exe" install

如果您使用 PowerShell，则应将其运行为：

Start-Process 'Docker Desktop Installer.exe' -Wait install

如果使用 Windows 命令提示符：

start /w "" "Docker Desktop Installer.exe" install

默认情况下，Docker Desktop 安装在C:\Program Files\Docker\Docker.

该install命令接受以下标志：

• --quiet：运行安装程序时禁止信息输出

• --accept-license：现在接受 Docker 订阅服务协议，而不是要求在应用程序首次运行时接受它

• --no-windows-containers：禁用 Windows 容器集成

• --allowed-org=<org name>：运行应用程序时要求用户登录并成为指定 Docker Hub 组织的一部分

• --backend=<backend name>：选择用于 Docker Desktop 的默认后端，hyper-v或windows（wsl-2默认）

• --installation-dir=<path>：更改默认安装位置 ( C:\Program Files\Docker\Docker)

• --admin-settings：自动创建一个admin-settings.json文件，管理员使用该文件来控制组织内客户端计算机上的某些 Docker Desktop 设置。有关详细信息，请参阅设置管理。

  • 它必须与标志一起使用--allowed-org=<org name>。

  • 例如：

    --allowed-org=<org name> --admin-settings='{"configurationFileVersion": 2, "enhancedContainerIsolation": {"value": true, "locked": false}}'

• --proxy-http-mode=<mode>：设置 HTTP 代理模式，system（默认）或manual

• --override-proxy-http=<URL>：设置传出HTTP请求必须使用的HTTP代理的URL，要求--proxy-http-mode是manual

• --override-proxy-https=<URL>：设置用于传出 HTTPS 请求的 HTTP 代理的 URL，需要--proxy-http-mode是manual

• --override-proxy-exclude=<hosts/domains>：绕过主机和域的代理设置。使用逗号分隔的列表。

• --hyper-v-default-data-root=<path>：指定 Hyper-V VM 磁盘的默认位置。

• --windows-containers-default-data-root=<path>：指定 Windows 容器的默认位置。

• --wsl-default-data-root=<path>：指定 WSL 分发磁盘的默认位置。

• --always-run-service：允许用户切换到 Windows 容器，而无需管理员权限。

笔记

如果您使用的是 PowerShell，则需要ArgumentList在任何标志之前使用该参数。例如：

Start-Process 'Docker Desktop Installer.exe' -Wait -ArgumentList 'install', '--accept-license'

如果您的管理员帐户与您的用户帐户不同，则必须将该用户添加到docker-users组：

$ net localgroup docker-users <user> /add