在 Windows 上安裝 Docker Desktop

如需檢查碼，請參閱版本資訊

系統需求

秘訣

我應該使用 Hyper-V 還是 WSL？

Docker Desktop 的功能在 WSL 和 Hyper-V 上保持一致，兩種架構沒有偏好。Hyper-V 和 WSL 各有優缺點，具體取決於您的特定設定和計畫的用例。

使用 Docker Desktop 建立的容器和映像會在安裝 Docker Desktop 的機器上的所有使用者帳戶之間共用。這是因為所有 Windows 帳戶都使用相同的虛擬機器來建置和執行容器。請注意，使用 Docker Desktop WSL 2 後端時，無法在使用者帳戶之間共用容器和映像。

Docker Business 客戶支援在 VMware ESXi 或 Azure VM 內執行 Docker Desktop。它需要先在 hypervisor 上啟用巢狀虛擬化。更多資訊，請參閱在 VM 或 VDI 環境中執行 Docker Desktop。

在 Windows 上安裝 Docker Desktop

秘訣

請參閱常見問題，瞭解如何在不需要系統管理員權限的情況下安裝和執行 Docker Desktop。

互動式安裝

1. 使用頁面頂端的下載按鈕或從版本資訊下載安裝程式。

2. 雙擊 `Docker Desktop Installer.exe` 以執行安裝程式。預設情況下，Docker Desktop 安裝在 `C:\Program Files\Docker\Docker`。

3. 出現提示時，請根據您選擇的後端，確定在設定頁面上選取或取消選取**使用 WSL 2 取代 Hyper-V** 選項。

   如果您的系統只支援兩個選項的其中一個，您將無法選擇要使用的後端。

4. 按照安裝精靈上的指示授權安裝程式並繼續安裝。

5. 安裝成功後，選擇**關閉**以完成安裝程序。

6. 啟動 Docker Desktop.

如果您的系統管理員帳戶與您的使用者帳戶不同，您必須將使用者新增到 **docker-users** 群組

1. 以**系統管理員**身分執行**電腦管理**。
2. 瀏覽至**本機使用者和群組** > **群組** > **docker-users**。
3. 按右鍵將使用者新增到群組。
4. 登出並重新登入以使變更生效。

從命令列安裝

下載 `Docker Desktop Installer.exe` 後，在終端機中執行以下命令以安裝 Docker Desktop

$ "Docker Desktop Installer.exe" install

如果您使用的是 PowerShell，您應該以如下方式執行它

Start-Process 'Docker Desktop Installer.exe' -Wait install

如果使用 Windows 命令提示字元

start /w "" "Docker Desktop Installer.exe" install

預設情況下，Docker Desktop 安裝在 `C:\Program Files\Docker\Docker`。

`install` 命令接受以下旗標

• `--quiet`：在執行安裝程式時隱藏資訊輸出

• `--accept-license`：立即接受Docker 訂閱服務協議，而不是要求在應用程式第一次執行時接受它

• `--no-windows-containers`：停用 Windows 容器整合

• --allowed-org=<組織名稱>：要求使用者在執行應用程式時登入並加入指定的 Docker Hub 組織。

• --backend=<後端名稱>：選擇 Docker Desktop 使用的預設後端，可選 hyper-v、windows 或 wsl-2（預設）。

• --installation-dir=<路徑>：變更預設安裝位置（C:\Program Files\Docker\Docker）。

• --admin-settings：自動建立一個 admin-settings.json 檔案，供管理員用來控制組織內用戶端電腦上的某些 Docker Desktop 設定。如需更多資訊，請參閱設定管理。

  • 此旗標必須與 --allowed-org=<組織名稱> 旗標一起使用。
  • 例如：--allowed-org=<組織名稱> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"

• --proxy-http-mode=<模式>：設定 HTTP Proxy 模式，可選 system（預設）或 manual。

• --override-proxy-http=<URL>：設定用於輸出 HTTP 請求的 HTTP Proxy URL，需要將 --proxy-http-mode 設定為 manual。

• --override-proxy-https=<URL>：設定用於輸出 HTTPS 請求的 HTTP Proxy URL，需要將 --proxy-http-mode 設定為 manual。

• --override-proxy-exclude=<主機/網域>：略過指定主機和網域的 Proxy 設定。使用逗號分隔列表。

• --proxy-enable-kerberosntlm：啟用 Kerberos 和 NTLM Proxy 驗證。如果您啟用此功能，請確保您的 Proxy 伺器已正確設定 Kerberos/NTLM 驗證。適用於 Docker Desktop 4.32 及更高版本。

• --hyper-v-default-data-root=<路徑>：指定 Hyper-V 虛擬機器磁碟的預設位置。

• --windows-containers-default-data-root=<路徑>：指定 Windows 容器的預設位置。

• --wsl-default-data-root=<路徑>：指定 WSL 發行版磁碟的預設位置。

• --always-run-service：安裝完成後，啟動 com.docker.service 並將服務啟動類型設定為自動。這可以避免需要管理員權限才能啟動 com.docker.service 的情況。Windows 容器和 Hyper-V 後端都需要 com.docker.service。

注意事項

如果您使用的是 PowerShell，則需要在任何旗標之前使用 ArgumentList 參數。例如：

Start-Process 'Docker Desktop Installer.exe' -Wait -ArgumentList 'install', '--accept-license'

如果您的管理員帳戶與使用者帳戶不同，則必須將使用者新增到 docker-users 群組。

$ net localgroup docker-users <user> /add

啟動 Docker Desktop

Docker Desktop 安裝後不會自動啟動。要啟動 Docker Desktop：

1. 搜尋 Docker，然後在搜尋結果中選擇 Docker Desktop。

2. Docker 選單（ ）會顯示 Docker 訂閱服務協議。

   以下是重點摘要：

   • Docker Desktop 對於小型企業（員工少於 250 人且年收入低於 1000 萬美元）、個人使用、教育和非商業性開放原始碼專案是免費的。
   • 否則，專業用途需要付費訂閱。
   • 政府機構也需要付費訂閱。
   • Docker Pro、Team 和 Business 訂閱方案包含 Docker Desktop 的商業用途。

3. 選擇 接受 以繼續。接受條款後，Docker Desktop 將會啟動。

   請注意，如果您不同意條款，Docker Desktop 將無法執行。您可以稍後開啟 Docker Desktop 選擇接受條款。

   如需更多資訊，請參閱Docker Desktop 訂閱服務協議。建議您閱讀常見問題

   秘訣

   身為 IT 管理員，您可以使用端點管理 (MDM) 軟體來識別環境中 Docker Desktop 執行個體的數量及其版本。這可以提供準確的授權報告，協助確保您的機器使用最新版本的 Docker Desktop，並讓您可以強制執行登入。

   • Intune...
   • Jamf...
   • Kandji...
   • Kolide...
   • Workspace One...

   後續步驟

   • 探索Docker 的核心訂閱方案...，瞭解 Docker 可以為您提供什麼。
   • Docker 快速入門.
   • 探索 Docker Desktop及其所有功能。
   • 疑難排解說明常見問題、解決方法以及如何獲得支援。
   • 常見問題提供常見問題的解答。
   • 版本資訊列出 Docker Desktop 版本的元件更新、新功能和改進。
   • 備份和還原資料提供有關備份和還原 Docker 相關資料的說明。