MSI 安装程序

目录
订阅： Business
要求： Docker Desktop 4.32 及更高版本
面向： 管理员

MSI 安装包支持各种 MDM (移动设备管理) 解决方案，非常适合批量安装，并消除了个人用户手动设置的需求。使用此安装包，IT 管理员可以确保 Docker Desktop 的标准化、策略驱动式安装，从而提高组织内部的效率和软件管理水平。

交互式安装

  1. 在 Docker Admin Console 中，导航到您的组织。

  2. 在 Docker Desktop 下，选择 部署 页面。

  3. 在 Windows OS 选项卡中，选择 下载 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 时，应用内更新会自动禁用。这可确保组织能够保持版本一致性并防止未经批准的更新。对于使用 .exe 安装程序安装的 Docker Desktop，仍支持应用内更新。

当有可用更新时，Docker Desktop 会通知您。要更新 Docker Desktop，请从 Docker Admin Console 下载最新的安装程序。导航到部署页面 > 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"

使用被动显示选项进行安装

当您想执行非交互式安装但显示进度对话框时，可以使用 /passive 显示选项替代 /quiet。

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

例如

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

提示

创建需要 JSON 字符串的值时

  • 属性需要 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 Installer 命令行选项。

属性描述默认值
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 Engine。可以是 wsl、hyperv 或 windows。wsl
PROXYENABLEKERBEROSNTLM设置为 1 时，启用对 Kerberos 和 NTLM 代理认证的支持。适用于 Docker Desktop 4.33 及更高版本。0
PROXYHTTPMODE设置 HTTP 代理模式。可以是 system 或 manual。system
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。

附加资源

页面选项