安装和配置

以交互方式安装

  1. Docker 管理控制台 中,导航到您的组织。

  2. 安全和访问 下,选择 部署 Docker Desktop 页面。

  3. 选择 下载 MSI 安装程序 按钮。

  4. 下载完成后,双击 Docker Desktop Installer.msi 运行安装程序。

  5. 接受许可协议后,您可以选择安装位置。默认情况下,Docker Desktop 安装在 C:\Program Files\Docker\Docker 中。

  6. 配置 Docker Desktop 安装。您可以

    • 创建桌面快捷方式

    • 将 Docker Desktop 服务启动类型设置为自动

    • 禁用 Windows 容器的使用

    • 选择 Docker Desktop 的引擎。可以是 WSL 或 Hyper-V。如果您的系统只支持这两个选项中的一个,则无法选择要使用的后端。

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

  8. 安装成功后,选择 完成 以完成安装过程。

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

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

注意

使用 MSI 安装 Docker Desktop 时,应用内更新会自动禁用。此功能可确保您的组织维护所需的 Docker Desktop 版本。对于使用 .exe 安装程序安装的 Docker Desktop,应用内更新仍然受支持。

当有更新可用时,Docker Desktop 会通知您。要更新 Docker Desktop,请从 Docker 管理控制台下载最新的安装程序。导航到 部署 Docker Desktop 页面 > 在 安全和访问 下。

要了解新版本的最新信息,请查看 发行说明 页面。

从命令行安装

本节介绍使用 PowerShell 从命令行安装 Docker Desktop。它提供了您可以运行的常见安装命令。您还可以添加其他参数,这些参数在 配置选项 中列出。

安装 Docker Desktop 时,可以选择交互式或非交互式安装。

交互式安装(不指定 /quiet/qn)会显示用户界面并允许您选择自己的属性。

通过用户界面安装时,可以

  • 选择目标文件夹
  • 创建桌面快捷方式
  • 配置 Docker Desktop 服务启动类型
  • 禁用 Windows 容器
  • 在 WSL 或 Hyper-V 引擎之间选择

非交互式安装是静默的,任何其他配置都必须作为参数传递。

常见的安装命令

重要

运行以下任何命令都需要管理员权限。

以交互方式安装并启用详细日志记录

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log"

以交互方式安装,但不启用详细日志记录

msiexec /i "DockerDesktop.msi"

以非交互方式安装并启用详细日志记录

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet

以非交互方式安装并抑制重新启动

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart

以非交互方式安装并使用管理员设置

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /quiet /norestart ADMINSETTINGS="{"configurationFileVersion":2,"enhancedContainerIsolation":{"value":true,"locked":false}}" ALLOWEDORG="docker.com"

使用被动显示选项安装

当您想要执行非交互式安装但要显示进度对话框时,可以使用 /passive 显示选项,而不是 /quiet

在被动模式下,安装程序不会向用户显示任何提示或错误消息,并且无法取消安装。

例如

msiexec /i "DockerDesktop.msi" /L*V ".\msi.log" /passive /norestart

提示

创建期望以 JSON 字符串作为其值的 value 时,需要记住一些有用的提示

  • 该属性期望一个 JSON 格式的字符串
  • 该字符串应包含在双引号中
  • 该字符串不应包含任何空格
  • 属性名称应包含在双引号中

常见的卸载命令

卸载 Docker Desktop 时,需要使用与最初用于安装应用程序的相同 .msi 文件。

如果您不再拥有原始的 .msi 文件,则需要使用与安装相关的产品代码。要查找产品代码,请运行

Get-WmiObject Win32_Product | Select-Object IdentifyingNumber, Name | Where-Object {$_.Name -eq "Docker Desktop"}

它应该返回类似于以下内容的输出

IdentifyingNumber                      Name
-----------------                      ----
{10FC87E2-9145-4D7D-B493-2E99E8D8E103} Docker Desktop

注意

此命令可能需要一些时间才能返回,具体取决于已安装应用程序的数量。

IdentifyingNumber 是应用程序的产品代码,可用于卸载 Docker Desktop。例如

msiexec /x {10FC87E2-9145-4D7D-B493-2E99E8D8E103} /L*V ".\msi.log" /quiet

以交互方式卸载并启用详细日志记录

msiexec /x "DockerDesktop.msi" /L*V ".\msi.log"

以交互方式卸载,但不启用详细日志记录

msiexec /x "DockerDesktop.msi"

以非交互方式卸载并启用详细日志记录

msiexec /x "DockerDesktop.msi" /L*V ".\msi.log" /quiet

以非交互方式卸载,但不启用详细日志记录

msiexec /x "DockerDesktop.msi" /quiet

配置选项

重要

除了以下自定义属性之外,Docker Desktop MSI 安装程序还支持标准的 Windows 安装程序命令行选项.

属性描述默认值
ENABLEDESKTOPSHORTCUT创建桌面快捷方式。1
INSTALLFOLDER指定 Docker Desktop 将安装的自定义位置。C:\Program Files\Docker
ADMINSETTINGS自动创建一个 admin-settings.json 文件,该文件用于 控制组织内客户端计算机上的某些 Docker Desktop 设置。它必须与 ALLOWEDORG 属性一起使用。
ALLOWEDORG要求用户在运行应用程序时登录并成为指定 Docker Hub 组织的成员。这将在 HKLM\Software\Policies\Docker\Docker Desktop 中创建一个名为 allowedOrgs 的注册表项。
ALWAYSRUNSERVICE允许用户在无需管理员权限的情况下切换到 Windows 容器0
DISABLEWINDOWSCONTAINERS禁用 Windows 容器集成0
ENGINE设置用于运行容器的 Docker 引擎。可以是 wslhypervwindowswsl
PROXYENABLEKERBEROSNTLM设置为 1 时,将启用对 Kerberos 和 NTLM 代理身份验证的支持。适用于 Docker Desktop 4.33 及更高版本0
PROXYHTTPMODE设置 HTTP 代理模式。可以是 systemmanualsystem
OVERRIDEPROXYHTTP设置必须用于传出 HTTP 请求的 HTTP 代理的 URL。
OVERRIDEPROXYHTTPS设置必须用于传出 HTTPS 请求的 HTTP 代理的 URL。
OVERRIDEPROXYEXCLUDE绕过主机和域名的代理设置。使用逗号分隔的列表。
HYPERVDEFAULTDATAROOT指定 Hyper-V 虚拟机磁盘的默认位置。
WINDOWSCONTAINERSDEFAULTDATAROOT指定 Windows 容器的默认位置。
WSLDEFAULTDATAROOT指定 WSL 发行版磁盘的默认位置。
DISABLEANALYTICS设置为 1 时,将禁用 MSI 的分析数据收集。有关更多信息,请参阅分析0

此外,您还可以使用 /norestart/forcerestart 来控制重启行为。

默认情况下,安装程序在成功安装后会重启机器。静默运行时,重启是自动的,不会提示用户。

分析

MSI 安装程序会收集匿名的使用统计信息,以更好地了解用户行为,并通过识别和解决问题或优化热门功能来改善用户体验。

如何选择退出


从默认的安装程序 GUI 安装 Docker Desktop 时,选择“欢迎”对话框左下角的“禁用分析”复选框。

从命令行安装 Docker Desktop 时,请使用 DISABLEANALYTICS 属性。

msiexec /i "win\msi\bin\en-US\DockerDesktop.msi" /L*V ".\msi.log" DISABLEANALYTICS=1

持久性

如果您决定为安装禁用分析,您的选择将保留在注册表中,并在以后的升级和卸载中生效。

但是,当卸载 Docker Desktop 时,此键会被删除,必须通过上述方法之一再次配置。

注册表项如下

SOFTWARE\Docker Inc.\Docker Desktop\DisableMsiAnalytics

禁用分析时,此键的值为 1

其他资源