安装和配置
以交互方式安装
在 Docker 管理控制台 中,导航到您的组织。
在 安全和访问 下,选择 部署 Docker Desktop 页面。
选择 下载 MSI 安装程序 按钮。
下载完成后,双击
Docker Desktop Installer.msi
运行安装程序。接受许可协议后,您可以选择安装位置。默认情况下,Docker Desktop 安装在
C:\Program Files\Docker\Docker
中。配置 Docker Desktop 安装。您可以
创建桌面快捷方式
将 Docker Desktop 服务启动类型设置为自动
禁用 Windows 容器的使用
选择 Docker Desktop 的引擎。可以是 WSL 或 Hyper-V。如果您的系统只支持这两个选项中的一个,则无法选择要使用的后端。
按照安装向导中的说明授权安装程序并继续安装。
安装成功后,选择 完成 以完成安装过程。
如果您的管理员帐户与您的用户帐户不同,则必须将用户添加到 docker-users 组。
- 以 管理员 身份运行 计算机管理。
- 导航到 本地用户和组 > 组 > docker-users。
- 右键单击以将用户添加到组。
- 注销并重新登录以使更改生效。
注意
使用 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 引擎。可以是 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
。