在 Windows 上安装 Docker Desktop

Docker Desktop 条款

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

本页面提供 Windows 版 Docker Desktop 的下载链接、系统要求和分步安装说明。

适用于 Windows 的 Docker Desktop - x86_64 Microsoft Store 上的适用于 Windows 的 Docker Desktop - x86_64 适用于 Windows 的 Docker Desktop - Arm (抢先体验版)

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

系统要求

提示

我应该使用 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。这需要首先在虚拟机管理程序上启用嵌套虚拟化。有关详细信息，请参阅在 VM 或 VDI 环境中运行 Docker Desktop。

管理员权限和安装要求

安装 Docker Desktop 需要管理员权限。但是，一旦安装，它可以在没有管理员权限的情况下使用。不过，某些操作仍然需要提升权限。有关更多详细信息，请参阅了解 Windows 权限要求。

如果您的用户没有管理员权限并计划执行需要提升权限的操作，请务必使用 --always-run-service 安装程序标志安装 Docker Desktop。这可确保这些操作仍可在不提示用户账户控制 (UAC) 提升的情况下执行。有关更多详细信息，请参阅安装程序标志。

WSL：验证和设置

如果您选择使用 WSL，请首先通过在终端中运行以下命令来验证您安装的版本是否符合系统要求

wsl --version

如果未显示版本详细信息，则您可能正在使用 WSL 的内置版本。此版本不支持现代功能，必须进行更新。

您可以使用以下任一方法更新或安装 WSL

选项 1：通过终端安装或更新 WSL

1. 以管理员模式打开 PowerShell 或 Windows 命令提示符。
2. 运行安装或更新命令。您可能会被提示重新启动计算机。有关更多信息，请参阅安装 WSL。

wsl --install

wsl --update

选项 2：通过 MSI 包安装 WSL

如果由于安全策略而阻止了对 Microsoft Store 的访问

1. 转到官方 WSL GitHub 发布页面。
2. 从最新的稳定版本下载 .msi 安装程序（在 Assets 下拉菜单中）。
3. 运行下载的安装程序并按照设置说明进行操作。

在 Windows 上安装 Docker Desktop

提示

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

交互式安装

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

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

3. 出现提示时，根据您选择的后端，确保“配置”页面上的使用 WSL 2 而非 Hyper-V 选项已选中或未选中。

   在仅支持一个后端的系统上，Docker Desktop 会自动选择可用的选项。

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

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

6. 启动 Docker Desktop.

如果您的管理员账户与您的用户账户不同，您必须将用户添加到 docker-users 组才能访问需要更高权限的功能，例如创建和管理 Hyper-V VM，或使用 Windows 容器

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。

安装程序标志

注意

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

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

如果您的管理员账户与您的用户账户不同，您必须将用户添加到 docker-users 组才能访问需要更高权限的功能，例如创建和管理 Hyper-V VM，或使用 Windows 容器。

$ net localgroup docker-users <user> /add

install 命令接受以下标志

安装行为

• --quiet：运行安装程序时抑制信息输出
• --accept-license：立即接受 Docker 订阅服务协议，而不是要求在首次运行应用程序时接受
• --installation-dir=<path>：更改默认安装位置 (C:\Program Files\Docker\Docker)
• --backend=<backend name>：选择 Docker Desktop 要使用的默认后端，hyper-v、windows 或 wsl-2 (默认)
• --always-run-service：安装完成后，启动 com.docker.service 并将服务启动类型设置为“自动”。这绕过了管理员权限的需求，否则启动 com.docker.service 需要管理员权限。Windows 容器和 Hyper-V 后端需要 com.docker.service。

安全和访问控制

• --allowed-org=<org name>：要求用户在运行应用程序时登录并成为指定的 Docker Hub 组织的一部分
• --admin-settings：自动创建 admin-settings.json 文件，管理员使用该文件来控制其组织内客户端机器上的某些 Docker Desktop 设置。有关详细信息，请参阅设置管理。
  • 它必须与 --allowed-org=<org name> 标志一起使用。
  • 例如：--allowed-org=<org name> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"
• --no-windows-containers：禁用 Windows 容器集成。这可以提高安全性。有关更多信息，请参阅Windows 容器。

代理配置

• --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 VM 磁盘的默认位置。
• --windows-containers-default-data-root=<path>：指定 Windows 容器的默认位置。
• --wsl-default-data-root=<path>：指定 WSL 分布式磁盘的默认位置。

启动 Docker Desktop

Docker Desktop 安装后不会自动启动。要启动 Docker Desktop

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

2. Docker 菜单 ( ) 显示 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 相关数据的说明。