在 Windows 上安裝 Docker Desktop

Docker Desktop 條款

在大型企業（超過 250 名員工或年收入超過 1000 萬美元）中商業使用 Docker Desktop 需要付費訂閱。

本頁面提供 Windows 版 Docker Desktop 的下載連結、系統要求和分步安裝說明。

適用於 Windows 的 Docker Desktop - x86_64 Microsoft Store 上的適用於 Windows 的 Docker Desktop - x86_64 適用於 Windows 的 Docker Desktop - Arm (搶先體驗版)

有關校驗和，請參閱發行說明

系統要求

提示

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

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

使用 Docker Desktop 建立的容器和映象在安裝了它的機器上的所有使用者賬戶之間共享。這是因為所有 Windows 賬戶都使用相同的 VM 來構建和執行容器。請注意，當使用 Docker Desktop WSL 2 後端時，無法在使用者賬戶之間共享容器和映象。

對於 Docker Business 客戶，支援在 VMware ESXi 或 Azure VM 中執行 Docker Desktop。這需要首先在虛擬機器管理程式上啟用巢狀虛擬化。有關詳細資訊，請參閱在 VM 或 VDI 環境中執行 Docker Desktop。

管理員許可權和安裝要求

安裝 Docker Desktop 需要管理員許可權。但是，一旦安裝，它可以在沒有管理員許可權的情況下使用。不過，某些操作仍然需要提升許可權。有關更多詳細資訊，請參閱瞭解 Windows 許可權要求。

如果您的使用者沒有管理員許可權並計劃執行需要提升許可權的操作，請務必使用 --always-run-service 安裝程式標誌安裝 Docker Desktop。這可確保這些操作仍可在不提示使用者賬戶控制 (UAC) 提升的情況下執行。有關更多詳細資訊，請參閱安裝程式標誌。

WSL：驗證和設定

如果您選擇使用 WSL，請首先透過在終端中執行以下命令來驗證您安裝的版本是否符合系統要求

wsl --version

如果未顯示版本詳細資訊，則您可能正在使用 WSL 的內建版本。此版本不支援現代功能，必須進行更新。

您可以使用以下任一方法更新或安裝 WSL

選項 1：透過終端安裝或更新 WSL

1. 以管理員模式開啟 PowerShell 或 Windows 命令提示符。
2. 執行安裝或更新命令。您可能會被提示重新啟動計算機。有關更多資訊，請參閱安裝 WSL。

wsl --install

wsl --update

選項 2：透過 MSI 包安裝 WSL

如果由於安全策略而阻止了對 Microsoft Store 的訪問

1. 轉到官方 WSL GitHub 釋出頁面。
2. 從最新的穩定版本下載 .msi 安裝程式（在 Assets 下拉選單中）。
3. 執行下載的安裝程式並按照設定說明進行操作。

在 Windows 上安裝 Docker Desktop

提示

有關如何在不需要管理員許可權的情況下安裝和執行 Docker Desktop，請參閱常見問題解答。

互動式安裝

1. 使用頁面頂部的下載按鈕或從發行說明下載安裝程式。

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

3. 出現提示時，根據您選擇的後端，確保“配置”頁面上的使用 WSL 2 而非 Hyper-V 選項已選中或未選中。

   在僅支援一個後端的系統上，Docker Desktop 會自動選擇可用的選項。

4. 按照安裝嚮導中的說明授權安裝程式並繼續安裝。

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

6. 啟動 Docker Desktop.

如果您的管理員賬戶與您的使用者賬戶不同，您必須將使用者新增到 docker-users 組才能訪問需要更高許可權的功能，例如建立和管理 Hyper-V VM，或使用 Windows 容器

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。

安裝程式標誌

注意

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

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

如果您的管理員賬戶與您的使用者賬戶不同，您必須將使用者新增到 docker-users 組才能訪問需要更高許可權的功能，例如建立和管理 Hyper-V VM，或使用 Windows 容器。

$ net localgroup docker-users <user> /add

install 命令接受以下標誌

安裝行為

• --quiet：執行安裝程式時抑制資訊輸出
• --accept-license：立即接受 Docker 訂閱服務協議，而不是要求在首次執行應用程式時接受
• --installation-dir=<path>：更改預設安裝位置 (C:\Program Files\Docker\Docker)
• --backend=<backend name>：選擇 Docker Desktop 要使用的預設後端，hyper-v、windows 或 wsl-2 (預設)
• --always-run-service：安裝完成後，啟動 com.docker.service 並將服務啟動型別設定為“自動”。這繞過了管理員許可權的需求，否則啟動 com.docker.service 需要管理員許可權。Windows 容器和 Hyper-V 後端需要 com.docker.service。

安全和訪問控制

• --allowed-org=<org name>：要求使用者在執行應用程式時登入併成為指定的 Docker Hub 組織的一部分
• --admin-settings：自動建立 admin-settings.json 檔案，管理員使用該檔案來控制其組織內客戶端機器上的某些 Docker Desktop 設定。有關詳細資訊，請參閱設定管理。
  • 它必須與 --allowed-org=<org name> 標誌一起使用。
  • 例如：--allowed-org=<org name> --admin-settings="{'configurationFileVersion': 2, 'enhancedContainerIsolation': {'value': true, 'locked': false}}"
• --no-windows-containers：停用 Windows 容器整合。這可以提高安全性。有關更多資訊，請參閱Windows 容器。

代理配置

• --proxy-http-mode=<mode>：設定 HTTP 代理模式，system (預設) 或 manual
• --override-proxy-http=<URL>：設定用於傳出 HTTP 請求的 HTTP 代理的 URL，需要 --proxy-http-mode 為 manual
• --override-proxy-https=<URL>：設定用於傳出 HTTPS 請求的 HTTP 代理的 URL，需要 --proxy-http-mode 為 manual
• --override-proxy-exclude=<hosts/domains>：繞過主機和域的代理設定。使用逗號分隔列表。
• --proxy-enable-kerberosntlm：啟用 Kerberos 和 NTLM 代理身份驗證。如果啟用此功能，請確保您的代理伺服器已正確配置為 Kerberos/NTLM 身份驗證。Docker Desktop 4.32 及更高版本可用。

資料根和磁碟位置

• --hyper-v-default-data-root=<path>：指定 Hyper-V VM 磁碟的預設位置。
• --windows-containers-default-data-root=<path>：指定 Windows 容器的預設位置。
• --wsl-default-data-root=<path>：指定 WSL 分散式磁碟的預設位置。

啟動 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 相關資料的說明。