使用 MSI 安装程序

注意

MSI 安装程序适用于所有拥有商务版订阅且 Docker Desktop 版本为 4.32 及更高版本的公司和组织管理员。

MSI 安装包支持多种 MDM（移动设备管理）解决方案，非常适合批量部署，可消除用户手动安装的需要。通过该安装包，IT 管理员可确保 Docker Desktop 的标准化、策略驱动式部署，从而提升组织内部的效率与软件管理能力。

交互式安装

1. 在 Docker 管理控制台中，导航至您的组织。

2. 在 安全性与访问 下，选择 部署 Docker Desktop 页面。

3. 从 Windows 操作系统 选项卡中，选择 下载 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"

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

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

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

例如：

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

提示

创建预期以JSON字符串作为其值的值时，请务必记住以下一些实用技巧：

• 该属性期望一个 JSON 格式的字符串
• The string should be wrapped in double quotes
• 该字符串不应包含任何空白字符
• 属性名称应使用双引号括起

通用卸载命令

卸载 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 命令行选项。

此外，您也可以使用 /norestart 或 /forcerestart 来控制重启行为。

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

分析

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

如何选择退出

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

持久化存储

如果您决定为某次安装禁用分析，您的选择将被保存在注册表中，并在未来的升级和卸载过程中得到保留。

然而，当卸载 Docker Desktop 时，该密钥会被移除，并且必须通过上述方法之一重新配置。

注册表键值如下：

SOFTWARE\Docker Inc.\Docker Desktop\DisableMsiAnalytics

当禁用分析时，此键的值为 1。

其他资源

• 浏览常见问题