在 Windows 上安裝 Docker Desktop

Docker Desktop 條款

大型企業（員工人數超過 250 人或年收入超過 1,000 萬美元）的 Docker Desktop 商業使用需要付費訂閱。

本頁提供下載連結、系統需求，以及在 Windows 上安裝 Docker Desktop 的逐步安裝說明。

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

如需校驗和，請參閱發行說明

系統需求

提示

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

Docker Desktop 在 WSL 和 Hyper-V 上的功能保持一致，沒有偏好任一架構。Hyper-V 和 WSL 各有優缺點，具體取決於您的特定設定和預期的使用情境。

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

在 VMware ESXi 或 Azure 虛擬機器中執行 Docker Desktop 支援 Docker Business 客戶。這需要先在 hypervisor 上啟用巢狀虛擬化。如需更多資訊，請參閱在 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. 當系統提示時，請根據您選擇的後端，確保「組態 (Configuration)」頁面上的使用 WSL 2 而非 Hyper-V 選項已選取或未選取。

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

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

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

6. 啟動 Docker Desktop.

如果您的管理員帳戶與使用者帳戶不同，您必須將使用者新增到 docker-users 群組，才能存取需要更高權限的功能，例如建立和管理 Hyper-V 虛擬機器，或使用 Windows 容器。

1. 以管理員身分執行電腦管理。
2. 導覽至「本機使用者和群組」（Local Users and Groups）>「群組」（Groups）>「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 虛擬機器，或使用 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 虛擬機器磁碟的預設位置。
• --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 人且年收入低於 1,000 萬美元)、個人使用、教育和非商業開源專案是免費的。
   • 否則，專業用途需要付費訂閱。
   • 政府機構也需要付費訂閱。
   • 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 相關資料的說明。