在 Windows 上安装 Docker Desktop

Docker Desktop 条款

在大型企业（员工人数超过 250 人或年营收超过 1000 万美元）中将 Docker Desktop 用于商业用途，需要 付费订阅。

本页面包含下载链接、系统要求信息以及在 Windows 上安装 Docker Desktop 的说明。

有关校验和，请参见 发行说明

系统要求

提示

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

Docker Desktop 在 WSL 和 Hyper-V 上的功能保持一致，不偏向任一架构。Hyper-V 和 WSL 各有优缺点，具体取决于您的具体配置和预期使用场景。

使用 Docker Desktop 创建的容器和镜像将在安装该软件的计算机的所有用户账户之间共享。这是因为所有 Windows 账户均使用同一个虚拟机来构建和运行容器。需要注意的是，当使用 Docker Desktop 的 WSL 2 后端时，无法在不同用户账户之间共享容器和镜像。

Docker Business 客户客户可支持在 VMware ESXi 或 Azure 虚拟机中运行 Docker Desktop。 此操作需先在虚拟机监控程序（Hypervisor）中启用嵌套虚拟化功能。 更多信息，请参见 在虚拟机或虚拟桌面基础架构（VDI）环境中运行 Docker Desktop。

在 Windows 上安装 Docker Desktop

提示

查看 常见问题，了解如何无需管理员权限即可安装和运行 Docker Desktop。

交互式安装

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

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

3. 当系统提示时，请根据您选择的后端，在配置页面上选择或取消选择使用 WSL 2 而非 Hyper-V选项。

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

4. 按照安装向导中的说明操作，以授权安装程序并继续安装。

5. 安装成功后，单击关闭以完成安装过程。

6. 启动 Docker Desktop。

如果您的管理员账户与您的用户账户不同，则必须将该用户添加到 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 命令提示符（Command Prompt）：

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>：绕过主机和域名的代理设置。使用逗号分隔的列表。

• --proxy-enable-kerberosntlm：启用 Kerberos 和 NTLM 代理身份验证。如果启用此选项，请确保您的代理服务器已正确配置以支持 Kerberos/NTLM 身份验证。Docker Desktop 4.32 及更高版本支持。

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

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

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

• --always-run-service：安装完成后，启动com.docker.service并将服务启动类型设置为“自动”。这避免了启动com.docker.service所需的管理员权限（否则需要管理员权限才能启动com.docker.service）。com.docker.service是Windows容器和Hyper-V后端所必需的。

注意

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

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

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

$ net localgroup docker-users <user> /add

启动 Docker Desktop

安装完成后，Docker Desktop 不会自动启动。要启动 Docker Desktop，请执行以下操作：

1. 搜索 Docker，并在搜索结果中选择 Docker Desktop。

2. The Docker menu () 显示 Docker 订阅服务协议。

   以下是关键点的总结：

   • Docker Desktop 对于小型企业（员工少于 250 人且年收入低于 1000 万美元）、个人用途、教育以及非商业开源项目是免费的。
   • 否则，专业使用需要付费订阅。
   • 政府实体也需要付费订阅。
   • Docker Pro、Team 和 Business 订阅包含 Docker Desktop 的商业用途授权。

3. 选择 接受 以继续。接受条款后，Docker Desktop 将启动。

   请注意，如果您不同意相关条款，Docker Desktop 将无法运行。您可以稍后通过打开 Docker Desktop 来选择接受这些条款。

   有关更多信息，请参阅 Docker Desktop 订阅服务协议。建议您阅读 常见问题解答。

提示

作为 IT 管理员，您可以使用终端管理 (MDM) 软件来识别您环境中 Docker Desktop 实例的数量及其版本。这可以提供准确的许可证报告，帮助确保您的机器使用最新版本的 Docker Desktop，并使您能够 强制登录。

• Intune
• Jamf
• Kandji
• Kolide
• Workspace One

下一步该去哪里

• 探索 Docker 的核心订阅方案，了解 Docker 能为您提供什么。
• 开始使用 Docker.
• 探索 Docker Desktop 及其所有功能。
• 故障排除介绍了常见问题、解决方案以及如何获取支持。
• 常见问题 提供对常见问题的解答。
• 发布说明 列出了与 Docker Desktop 发布相关的组件更新、新功能和改进。
• 备份和恢复数据 提供了有关备份和恢复Docker相关数据的说明。