使用 MSI 安装程序

注意

MSI 安装程序可供所有拥有商业订阅和 Docker Desktop 版本 4.32 及更高版本的公司和组织所有者使用。

MSI 软件包支持各种 MDM（移动设备管理）解决方案，非常适合批量安装，无需个人用户手动设置。借助此软件包，IT 管理员可以确保标准化、策略驱动的 Docker Desktop 安装，从而提高整个组织的效率和软件管理。

以交互方式安装

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

2. 在 Security and access （安全和访问） 下，选择 Deploy Docker Desktop （部署 Docker 桌面） 页面。

3. 从 Windows OS 选项卡中，选择 Download MSI installer 按钮。

4. 下载后，双击以运行安装程序。Docker Desktop Installer.msi

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

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

   • 创建桌面快捷方式

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

   • 禁用 Windows 容器使用

   • 选择 Docker Desktop 的引擎。WSL 或 Hyper-V。如果您的系统仅支持这两个选项之一，您将无法选择要使用的后端。

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

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

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

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

注意

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

Docker Desktop 会在有可用更新时通知您。要更新 Docker Desktop，请从 Docker Admin Console 下载最新的安装程序。导航到 Security and access >下的 Deploy 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"

使用被动显示选项安装

您可以使用 display 选项，而不是在您想要执行非交互式安装时显示进度对话框。/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 命令行选项。

此外，您还可以使用 或 来控制重启行为。/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

禁用 analytics 后，此键的值为 。1

其他资源

• 探索常见问题解答