在 Windows 上安装 Docker Desktop

Docker Desktop 条款

对于员工人数超过 250 人或年收入超过 1000 万美元的大型企业,商业使用 Docker Desktop 需要 付费订阅

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

有关校验和,请参阅版本说明

系统要求

提示

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

Docker Desktop 在 WSL 和 Hyper-V 上的功能保持一致,无需偏好任何一种架构。Hyper-V 和 WSL 各有优劣,具体取决于您的特定设置和计划的使用场景。


  • WSL 版本 1.1.3.0 或更高版本。
  • Windows 11 64 位:Home 或 Pro 22H2 版或更高版本,或 Enterprise 或 Education 22H2 版或更高版本。
  • Windows 10 64 位:最低要求为 Home 或 Pro 22H2(构建 19045)或更高版本,或 Enterprise 或 Education 22H2(构建 19045)或更高版本。
  • 在 Windows 上启用 WSL 2 功能。有关详细说明,请参阅Microsoft 文档
  • 在 Windows 10 或 Windows 11 上成功运行 WSL 2 需要满足以下硬件先决条件

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

注意

Docker Desktop 仅支持仍在 Microsoft 服务时间线 内的 Windows 版本。Docker Desktop 不支持 Windows Server 版本,例如 Windows Server 2019 或 Windows Server 2022。有关如何在 Windows Server 上运行容器的更多信息,请参阅 Microsoft 官方文档

重要提示

要运行 Windows 容器,您需要 Windows 10 或 Windows 11 的 Professional 或 Enterprise 版本。Windows Home 或 Education 版本仅允许您运行 Linux 容器。


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

Docker Business 客户支持在 VMware ESXi 或 Azure VM 内运行 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选项。

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

  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 命令提示符

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

$ 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-vwindowswsl-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 菜单( whale menu )显示 Docker 订阅服务协议。

    以下是关键点的摘要

    • 对于小型企业(员工少于 250 人且年收入少于 1000 万美元)、个人使用、教育和非商业开源项目,Docker Desktop 是免费的。
    • 否则,商业用途需要付费订阅。
    • 政府机构也需要付费订阅。
    • Docker Pro、Team 和 Business 订阅包括 Docker Desktop 的商业使用。
  3. 选择接受继续。接受条款后,Docker Desktop 将启动。

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

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

提示

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

下一步

页面选项