在 Windows 上安装 Docker Desktop

Docker Desktop 术语

Docker Desktop 在大型企业中的商业用途（超过 250 个 员工或超过 1000 万美元的年收入）需要支付 订阅。

此页面包含下载 URL、有关系统要求的信息以及有关如何安装适用于 Windows 的 Docker Desktop 的说明。

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

系统要求

提示

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

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

使用 Docker Desktop 创建的容器和镜像在所有人之间共享 安装了它的计算机上的用户帐户。这是因为所有 Windows 帐户使用相同的 VM 来构建和运行容器。请注意，使用 Docker Desktop WSL 2 后端时，无法在用户帐户之间共享容器和镜像。

Docker Business 客户支持在 VMware ESXi 或 Azure VM 中运行 Docker Desktop。 它需要首先在 Hypervisor 上启用嵌套虚拟化。 有关更多信息，请参阅在 VM 或 VDI 环境中运行 Docker Desktop。

在 Windows 上安装 Docker Desktop

提示

请参阅有关如何在不需要管理员权限的情况下安装和运行 Docker Desktop 的常见问题解答。

以交互方式安装

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

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

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

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

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

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

6. 启动 Docker Desktop。

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

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

从命令行安装

下载完成后，在终端执行以下命令安装 Docker Desktop。Docker Desktop Installer.exe

$ "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-vwindowswsl-2

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

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

  • 它必须与 flag 一起使用。--allowed-org=<org name>
  • 例如：--allowed-org=<org name> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"

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

• --override-proxy-http=<URL>：设置必须用于传出 HTTP 请求的 HTTP 代理的 URL，要求为--proxy-http-modemanual

• --override-proxy-https=<URL>：设置必须用于传出 HTTPS 请求的 HTTP 代理的 URL，要求为--proxy-http-modemanual

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

• --proxy-enable-kerberosntlm：启用 Kerberos 和 NTLM 代理身份验证。如果要启用此功能，请确保您的代理服务器已正确配置为 Kerberos/NTLM 身份验证。适用于 Docker Desktop 4.32 及更高版本。

• --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：安装完成后，启动服务启动类型，并将服务启动类型设置为 Automatic。这避免了对管理员权限的需求，否则需要管理员权限才能启动 。 Windows 容器和 Hyper-V 后端需要。com.docker.servicecom.docker.servicecom.docker.service

注意

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

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

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

$ net localgroup docker-users <user> /add

启动 Docker Desktop

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

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

2. Docker 菜单 （） 显示 Docker 订阅服务协议。

   以下是关键点的摘要：

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

3. 选择 Accept （接受） 以继续。Docker Desktop 在您接受条款后启动。

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

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

提示

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

• Intune
• Jamf 系列
• 坎吉
• 科利德
• Workspace One

下一步

• 探索 Docker 的核心订阅，了解 Docker 可以为您提供什么。
• Docker 入门。
• 探索 Docker Desktop 及其所有功能。
• 疑难解答介绍了常见问题、解决方法和 如何获得支持。
• 常见问题解答提供常见问题的答案。
• 发行说明列出了与 Docker Desktop 版本相关的组件更新、新功能和改进。
• 备份和还原数据 提供有关备份和还原与 Docker 相关的数据的说明。