安裝和配置

目錄

以互動方式安裝

  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 引擎。可以是 wsl、hyperv 或 windowswsl
PROXYENABLEKERBEROSNTLM設定為 1 時，將啟用對 Kerberos 和 NTLM 代理身份驗證的支援。適用於 Docker Desktop 4.33 及更高版本0
PROXYHTTPMODE設定 HTTP 代理模式。可以是 system 或 manualsystem
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。

其他資源