前言
在現代軟件開發和人工智能應用中,環境的穩定性和可移植性至關重要。Docker 作為一種輕量級的容器化技術,為開發者提供一致的運行環境,使得軟件可以在不同平臺上無縫運行,極大地提升了開發和部署的效率。無論是本地開發、測試,還是大規模的云端部署,Docker 都能顯著降低環境配置的復雜性,減少依賴沖突問題。
本教程將詳細介紹在 Windows 上 Docker Desktop 的安裝和配置方法,幫助用戶快速上手并熟練使用 Docker。此外,我們還提供了 Docker Desktop 的 漢化教程,使用戶能夠以更直觀的方式管理和使用容器環境。希望本指南能為您的開發工作帶來便利,讓 Docker 成為您高效工作的得力助手。
本教程內容摘自我之前撰寫的文章 《在Windows上輕松部署本地大語言模型:Ollama與Open-WebUI的完整指南》。由于原文的瀏覽量不盡如人意,因此我將其中的 Docker Desktop 安裝與漢化部分 單獨整理成這篇獨立教程,以便更多讀者能夠快速獲取相關信息。
前置要求:安裝 WSL 2 與 Linux 發行版
在 Windows 上使用 Docker Desktop 依賴 WSL 2 作為后端運行環境。因此,在安裝 Docker Desktop 之前,您需要先 安裝 WSL 2 并配置至少一個 Linux 發行版(如 Ubuntu)。如果您尚未完成此步驟,請參考我之前的文章:
🔗 Win10/11系統下WSL2+Ubuntu20.04的全流程安裝指南(支持安裝至 D 盤)
按照教程完成 WSL 2 的安裝,并確保能夠在 WSL 終端中正常運行 Linux 命令后,再繼續進行 Docker Desktop 的安裝配置。
一、安裝 Docker Desktop
1. 下載 Docker Desktop:
- 訪問 Docker 官網:https://www.docker.com/。
- 點擊頁面上的“Download for Windows - AMD64”按鈕,以下載適用于 Windows 系統的 Docker Desktop 安裝文件。
2. 安裝 Docker Desktop:
- 雙擊下載的安裝文件,開始安裝 Docker Desktop。
- 按照安裝向導的指示完成安裝。在安裝過程中,將提示安裝 WSL 2,建議勾選此選項以獲得更好的性能。
3. 配置 Docker Desktop:
-
安裝完成后,啟動 Docker Desktop。
-
首次打開時,將出現 Docker 訂閱協議,點擊
Accept
(接受)以繼續。 -
隨后,系統將提示用戶登錄。您可以選擇使用 GitHub 賬戶或 Google 賬戶登錄,若無上述賬戶,可選擇跳過登錄步驟。
-
接下來,將出現調查問卷,您可以根據個人喜好選擇填寫,或直接跳過此步驟。
-
最后,Docker Desktop 將正常啟動。
二、漢化 Docker Desktop(可選)
若想使 Docker Desktop 顯示中文界面,按照以下步驟進行漢化:
1. 下載對應版本的中文語言包:
- 訪問 GitHub,下載適用于 Docker Desktop 的中文語言包,鏈接地址為:DockerDesktop-CN。
- 將下載的文件解壓至
C:\Program Files\Docker
目錄下(即 Docker 的安裝根目錄)。
2. 檢查 Docker Desktop 版本:
- 啟動 Docker Desktop,版本號將在右下角顯示。
3. 備份并替換 app.asar 文件:
- 打開 Docker Desktop 中文語言包,選擇與您 Docker 版本相符的
app.asar
文件并復制。
- 導航至 Docker 的安裝目錄,路徑默認為:
C:\Program Files\Docker\Docker\frontend\resources
- 在該目錄下找到
app.asar
文件,建議先備份原文件,然后將復制的中文語言包中的app.asar
文件粘貼并替換原有文件。
4. 重新啟動 Docker Desktop:
- 完成替換后,請關閉 Docker Desktop,然后重新啟動該程序。此時,Docker Desktop 應該以中文界面顯示。
三、報錯 WSL 更新失敗
打開 Docker Desktop 后若出現如下警告,表明 Docker Desktop 在 WSL 更新時失敗,系統無法找到 WSL。這通常是由于 Windows 版本較低,導致 WSL 兼容性問題,建議升級 Windows 以解決該問題。
解決方案:升級 Windows 11 版本以修復 WSL2 更新問題
1. 檢查 Windows 版本
-
在 PowerShell 或 運行(Win + R) 輸入:
winver
如圖所示我的 Windows版本 為是 21H2,WSL2 需要至少滿足 22H2 或更高。
2. 手動升級 Windows
-
訪問 Windows 11 安裝助手官網 ,點擊
立即下載
。 -
根據系統提示,依次完成下載、安裝和重啟,直至升級完成,請勿中斷操作,這里不再進行演示。
-
再次檢查 Windows版本,在 PowerShell 或 運行(Win + R) 輸入:
winver
如圖所示我的 Windows版本 已成功升級至 24H2,滿足 WSL2 需求(至少 22H2 或更高)。
3. 手動更新 WSL
-
Windows 更新完畢后,以管理員身份運行
PowerShell
執行:wsl --update
-
如果一切正常,然后運行,你會看到如下圖所示,說明 WSL 已成功更新!
wsl --version
4. 重新啟動 Docker Desktop
-
重新啟動 Docker Desktop 后可以看到不再彈出報錯