在Windows上安装Docker Desktop

目录

Docker Desktop 条款

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

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

Docker Desktop for Windows - x86_64
Docker Desktop for Windows - Arm (Beta)

关于校验和，请参阅 发布说明

系统要求

提示

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

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

  • WSL 版本 1.1.3.0 或更高版本。
  • Windows 11 64位：家庭版或专业版 22H2 或更高版本，或企业版或教育版 22H2 或更高版本。
  • Windows 10 64位：最低要求是家庭版或专业版 22H2（版本 19045）或更高，或企业版或教育版 22H2（版本 19045）或更高。
  • 在Windows上启用WSL 2功能。有关详细说明，请参阅 Microsoft文档。
  • 要在Windows 10或Windows 11上成功运行WSL 2，需要满足以下硬件要求：

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

注意

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

重要

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

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

  • Windows 10 64位：最低要求是家庭版或专业版 22H2（版本 19045）或更高，或企业版或教育版 22H2（版本 19045）或更高。

  • 启用Hyper-V和容器Windows功能。

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

    • 64 bit processor with 二级地址转换 (SLAT)
    • 4GB system RAM
    • Turn on BIOS-level hardware virtualization support in the BIOS settings. For more information, see 虚拟化.

注意

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

重要

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

  • WSL 版本 1.1.3.0 或更高版本。
  • Windows 11 64位：家庭版或专业版 22H2 或更高版本，或企业版或教育版 22H2 或更高版本。
  • Windows 10 64位：最低要求是家庭版或专业版 22H2（版本 19045）或更高，或企业版或教育版 22H2（版本 19045）或更高。
  • 在Windows上启用WSL 2功能。有关详细说明，请参阅 Microsoft文档。
  • 要在Windows 10或Windows 11上成功运行WSL 2，需要满足以下硬件要求：

重要

不支持Windows容器。

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

对于Docker商业客户，支持在VMware ESXi或Azure虚拟机内运行Docker Desktop。 首先需要在虚拟机管理程序上启用嵌套虚拟化。 有关更多信息，请参阅 在VM或VDI环境中运行Docker Desktop。

从Docker Desktop菜单中，您可以切换Docker CLI与之通信的守护进程（Linux或Windows）。选择切换到Windows容器以使用Windows容器，或选择切换到Linux容器以使用Linux容器（默认）。

有关Windows容器的更多信息，请参考以下文档：

注意

当你切换到Windows容器时，设置仅显示那些活动且适用于你的Windows容器的标签。

如果您在Windows容器模式下设置代理或守护程序配置，这些设置仅适用于Windows容器。如果您切换回Linux容器，代理和守护程序配置将恢复为您为Linux容器设置的配置。您的Windows容器设置将被保留，并在您切换回时再次可用。

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

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=: 要求用户在运行应用程序时登录并成为指定的Docker Hub组织的一部分

  • --backend=: 选择用于Docker Desktop的默认后端，hyper-v, windows 或 wsl-2 (默认)

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

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

    • It must be used together with the --allowed-org=<org name> flag.
    • For example:--allowed-org=<org name> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"

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

  • --override-proxy-http=: 设置必须用于传出HTTP请求的HTTP代理的URL，需要--proxy-http-mode为manual

  • --override-proxy-https=: 设置用于传出HTTPS请求的HTTP代理的URL，要求--proxy-http-mode为manual

  • --override-proxy-exclude=: 绕过指定主机和域的代理设置。使用逗号分隔的列表。

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

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

  • --windows-containers-default-data-root=: 指定Windows容器的默认位置。

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

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

    以下是关键点的总结：

    • Docker Desktop is free for small businesses (fewer than 250 employees AND less than $10 million in annual revenue), personal use, education, and non-commercial open source projects.
    • Otherwise, it requires a paid subscription for professional use.
    • Paid subscriptions are also required for government entities.
    • The Docker Pro, Team, and Business subscriptions include commercial use of Docker Desktop.

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

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

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

提示

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

下一步去哪里