境預(yù)檢、WSL2 配置與故障排查)
1. 為什么 Win10 裝 Docker Desktop 總卡在第一步Win10 系統(tǒng)安裝 Docker Desktop 這件事說(shuō)簡(jiǎn)單也簡(jiǎn)單說(shuō)折騰也真能折騰一整天。我前后在不下十臺(tái)不同配置的 Win10 機(jī)器上裝過(guò)這玩意兒從公司臺(tái)式機(jī)到個(gè)人筆記本從家庭版到專業(yè)版踩過(guò)的坑基本能湊成一本小冊(cè)子。很多人第一次裝的時(shí)候下載完安裝包雙擊進(jìn)度條走到一半報(bào)錯(cuò)或者裝完了啟動(dòng)一直轉(zhuǎn)圈又或者命令行里敲docker提示找不到命令心態(tài)直接崩。這篇內(nèi)容就是把這些年積累的實(shí)操經(jīng)驗(yàn)攤開(kāi)講清楚從系統(tǒng)環(huán)境預(yù)檢、組件依賴、安裝參數(shù)選擇到裝完之后的配置調(diào)優(yōu)和故障排查一條龍給你捋順。先說(shuō)清楚這個(gè)內(nèi)容適合誰(shuí)看。如果你是剛接觸容器技術(shù)、想在 Windows 上跑 Docker 做開(kāi)發(fā)環(huán)境的新手這篇能幫你少走至少三四個(gè)小時(shí)的彎路如果你是有一定基礎(chǔ)但被某個(gè)具體報(bào)錯(cuò)卡住的老手第四部分的排查速查表應(yīng)該能直接對(duì)上你的癥狀。核心關(guān)鍵詞就一個(gè)Win10 系統(tǒng)安裝 Docker Desktop圍繞它展開(kāi)的所有前置條件、安裝細(xì)節(jié)、啟動(dòng)配置和問(wèn)題處理我都會(huì)講到。Docker Desktop 本質(zhì)上是一個(gè)把 Docker 引擎、命令行客戶端、圖形管理界面打包在一起的桌面應(yīng)用。在 Windows 上它并不是原生跑 Linux 容器而是依賴一層虛擬化能力來(lái)承載一個(gè)輕量級(jí)的 Linux 運(yùn)行環(huán)境。這就決定了它對(duì) Windows 系統(tǒng)的版本、虛擬化開(kāi)關(guān)、相關(guān)系統(tǒng)組件有硬性要求。很多人裝不上根子不在 Docker 本身而在系統(tǒng)環(huán)境沒(méi)準(zhǔn)備好。所以整篇內(nèi)容的邏輯是先把地基打牢再談安裝最后處理裝完之后的收尾問(wèn)題。我見(jiàn)過(guò)太多人一上來(lái)就找安裝包結(jié)果系統(tǒng)版本不夠、虛擬化沒(méi)開(kāi)、相關(guān)組件缺失裝到一半各種報(bào)錯(cuò)然后開(kāi)始懷疑是安裝包有問(wèn)題。其實(shí)只要按順序把前置檢查做一遍后面會(huì)順很多。下面就從整體思路開(kāi)始拆。2. 安裝前的整體思路與環(huán)境預(yù)檢2.1 先搞清楚你的 Win10 到底夠不夠格Docker Desktop 對(duì) Windows 版本有明確門檻。我整理了一張對(duì)照表裝之前先對(duì)號(hào)入座別急著下載安裝包。系統(tǒng)版本是否支持關(guān)鍵說(shuō)明Win10 家庭版 2004 及以上支持需要啟用 WSL2 后端Win10 專業(yè)版 1903 及以上支持可用 Hyper-V 或 WSL2 后端Win10 企業(yè)版 1903 及以上支持同專業(yè)版Win10 1809 及以下不支持需先升級(jí)系統(tǒng)Win10 家庭版 1903 以下不支持家庭版早期版本缺組件查看系統(tǒng)版本的方法很簡(jiǎn)單按Win R輸入winver回車彈窗里就能看到版本號(hào)和內(nèi)部版本號(hào)。這里有個(gè)容易忽略的點(diǎn)家庭版和專業(yè)版的支持路徑不一樣。專業(yè)版可以用傳統(tǒng)的 Hyper-V 虛擬化后端家庭版沒(méi)有 Hyper-V 管理工具必須走 WSL2 這條路。所以家庭版用戶裝之前重點(diǎn)是把 WSL2 配好而不是去折騰 Hyper-V。我個(gè)人的建議是不管你是哪個(gè)版本只要系統(tǒng)支持優(yōu)先選 WSL2 后端。原因后面會(huì)細(xì)講簡(jiǎn)單說(shuō)就是資源占用更小、啟動(dòng)更快、和 Windows 文件系統(tǒng)的交互更順。Hyper-V 后端雖然成熟但它會(huì)獨(dú)占虛擬化層可能和你機(jī)器上其他虛擬化軟件比如某些安卓模擬器打架。2.2 虛擬化開(kāi)關(guān)最容易被忽略的第一道坎Docker Desktop 不管用哪種后端底層都要依賴 CPU 的硬件虛擬化能力。這個(gè)開(kāi)關(guān)在 BIOS/UEFI 里默認(rèn)可能是關(guān)閉的。判斷方法打開(kāi)任務(wù)管理器切到性能標(biāo)簽頁(yè)看 CPU 那一欄下方有沒(méi)有虛擬化已啟用字樣。如果顯示已禁用那就得進(jìn) BIOS 打開(kāi)。進(jìn) BIOS 的按鍵各家主板不一樣常見(jiàn)的是開(kāi)機(jī)時(shí)連按Del、F2、F10或F12。進(jìn)去之后找Virtualization Technology、Intel VT-x、AMD-V、SVM Mode這類選項(xiàng)設(shè)為 Enabled保存重啟。這一步聽(tīng)起來(lái)簡(jiǎn)單但實(shí)際卡住的人不少尤其是品牌整機(jī)BIOS 菜單藏得深有的還把虛擬化選項(xiàng)放在安全相關(guān)的子菜單里。注意部分公司配發(fā)的機(jī)器 BIOS 被鎖了虛擬化選項(xiàng)改不了。這種情況只能找 IT 管理員處理自己硬折騰沒(méi)用。虛擬化打開(kāi)之后還要確認(rèn) Windows 的虛擬化相關(guān)功能沒(méi)有被禁用。專業(yè)版用戶檢查啟用或關(guān)閉 Windows 功能里Hyper-V和虛擬機(jī)平臺(tái)是否可用家庭版用戶重點(diǎn)看虛擬機(jī)平臺(tái)這一項(xiàng)。這些是 WSL2 運(yùn)行的基礎(chǔ)。2.3 后端選型WSL2 還是 Hyper-V別選錯(cuò)這是安裝前最關(guān)鍵的決策選錯(cuò)了后面全是麻煩。我把兩種后端的差異列出來(lái)你對(duì)照自己的情況選。對(duì)比維度WSL2 后端Hyper-V 后端系統(tǒng)要求Win10 2004家庭版可用Win10 專業(yè)版/企業(yè)版資源占用較低按需分配內(nèi)存較高預(yù)留固定資源啟動(dòng)速度快秒級(jí)相對(duì)慢文件交互跨系統(tǒng)文件訪問(wèn)順暢需通過(guò)掛載稍繁瑣與其他虛擬化軟件共存兼容性較好可能沖突配置復(fù)雜度需先配好 WSL2開(kāi)啟 Hyper-V 即可我的實(shí)操結(jié)論很明確能用 WSL2 就用 WSL2。家庭版沒(méi)得選只能 WSL2專業(yè)版雖然兩條路都通但 WSL2 的體驗(yàn)明顯更輕快。唯一需要注意的是WSL2 要求系統(tǒng)版本 2004 及以上如果你的專業(yè)版還停在 1903 或 1909要么升級(jí)系統(tǒng)走 WSL2要么退回 Hyper-V 后端。選 WSL2 的話安裝 Docker Desktop 之前要先把 WSL2 本身配好包括啟用相關(guān) Windows 功能、安裝 WSL2 內(nèi)核更新包、設(shè)置默認(rèn)版本為 2。這部分是前置工作做扎實(shí)了 Docker Desktop 安裝過(guò)程會(huì)非常順。選 Hyper-V 的話確保 Hyper-V 功能已啟用、機(jī)器沒(méi)有跑其他搶占虛擬化層的軟件即可。2.4 磁盤和內(nèi)存別讓資源成為隱形瓶頸Docker 鏡像和容器都占磁盤默認(rèn)情況下鏡像存在系統(tǒng)盤。Win10 系統(tǒng)盤空間緊張是常態(tài)裝之前先看一眼 C 盤剩余空間。我的經(jīng)驗(yàn)是至少留出 20GB 以上因?yàn)槔瓗讉€(gè)常用鏡像比如數(shù)據(jù)庫(kù)、中間件很快就能吃掉好幾個(gè) G?？臻g實(shí)在不夠可以在安裝后把鏡像存儲(chǔ)位置遷到其他盤這個(gè)后面配置部分會(huì)講。內(nèi)存方面Docker Desktop 默認(rèn)會(huì)占用一部分內(nèi)存給 Linux 運(yùn)行環(huán)境。8GB 內(nèi)存的機(jī)器能跑但同時(shí)開(kāi) IDE、瀏覽器、數(shù)據(jù)庫(kù)容器會(huì)比較吃力16GB 是比較舒服的起步配置。如果內(nèi)存偏小可以在設(shè)置里限制 Docker 可用的內(nèi)存上限避免它把系統(tǒng)拖垮。3. 核心組件安裝與實(shí)操步驟3.1 WSL2 環(huán)境搭建家庭版和專業(yè)版都要過(guò)的關(guān)不管你最終用哪種后端只要走 WSL2 路線這一步繞不開(kāi)。我按順序列操作你照著做就行。第一步啟用兩個(gè) Windows 功能。以管理員身份打開(kāi) PowerShell執(zhí)行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart第一條啟用 Linux 子系統(tǒng)支持第二條啟用虛擬機(jī)平臺(tái)。兩條執(zhí)行完重啟電腦。這里解釋一下為什么需要這兩個(gè)前者是 WSL 的基礎(chǔ)支撐后者提供輕量級(jí)虛擬化能力WSL2 正是跑在這個(gè)虛擬化平臺(tái)上的。第二步安裝 WSL2 內(nèi)核更新包。這個(gè)包是微軟官方提供的獨(dú)立安裝程序下載后雙擊運(yùn)行即可。裝完之后把 WSL 的默認(rèn)版本設(shè)為 2wsl --set-default-version 2第三步驗(yàn)證。執(zhí)行wsl --list --verbose如果能看到已安裝的發(fā)行版且版本列顯示 2說(shuō)明配置成功。如果提示沒(méi)有安裝任何發(fā)行版也沒(méi)關(guān)系Docker Desktop 會(huì)自己帶一個(gè)運(yùn)行環(huán)境但建議至少裝一個(gè)基礎(chǔ)發(fā)行版方便調(diào)試。實(shí)操心得wsl --set-default-version 2這條命令如果報(bào)錯(cuò)說(shuō)內(nèi)核版本不支持多半是內(nèi)核更新包沒(méi)裝或沒(méi)裝對(duì)版本。重新下載對(duì)應(yīng)架構(gòu)x64 或 ARM64的更新包再試。3.2 下載與安裝 Docker Desktop 的正確姿勢(shì)安裝包從官方渠道獲取選 Windows 版本。下載的時(shí)候注意架構(gòu)絕大多數(shù)機(jī)器是 x64少數(shù)輕薄本是 ARM64下錯(cuò)了裝不上。安裝包體積不小下載慢的話耐心等別去第三方站點(diǎn)下所謂的精簡(jiǎn)版那些改過(guò)的包后續(xù)出問(wèn)題很難排查。雙擊安裝包安裝向?qū)Ю镉袀€(gè)關(guān)鍵選項(xiàng)Use WSL 2 instead of Hyper-V。這個(gè)勾選框決定了后端類型。如果你前面配好了 WSL2就勾上它如果你打算用 Hyper-V 后端就取消勾選。這一步選錯(cuò)裝完之后還得在設(shè)置里改不如一次到位。安裝過(guò)程會(huì)請(qǐng)求管理員權(quán)限同意即可。進(jìn)度條走完提示重啟或者直接完成按提示操作。這里有個(gè)細(xì)節(jié)安裝程序會(huì)自動(dòng)把 Docker 相關(guān)目錄加到系統(tǒng) PATH但有時(shí)候需要重新打開(kāi)終端才生效。裝完先別急著敲命令把終端關(guān)掉重開(kāi)一個(gè)。安裝路徑默認(rèn)在系統(tǒng)盤如果 C 盤緊張安裝向?qū)Ю锟梢愿牡狡渌P。不過(guò)要注意即使程序裝到別的盤鏡像數(shù)據(jù)默認(rèn)還是在系統(tǒng)盤的用戶目錄下這個(gè)后面單獨(dú)說(shuō)怎么遷。3.3 首次啟動(dòng)與初始配置第一次啟動(dòng) Docker Desktop會(huì)彈服務(wù)條款接受之后進(jìn)入初始化。這時(shí)候它會(huì)在后臺(tái)拉起 Linux 運(yùn)行環(huán)境第一次可能要等一兩分鐘。界面左下角會(huì)顯示引擎狀態(tài)變成綠色 running 就說(shuō)明起來(lái)了。首次啟動(dòng)后建議先做幾項(xiàng)基礎(chǔ)配置在設(shè)置界面里操作Resources 里限制內(nèi)存和 CPU默認(rèn)它會(huì)吃掉不少資源按你機(jī)器實(shí)際情況調(diào)。8GB 內(nèi)存的機(jī)器建議給 Docker 分配 2 到 3GB16GB 的可以給 4 到 6GB。Disk image location 改存儲(chǔ)位置如果系統(tǒng)盤緊張?jiān)谶@里把鏡像存儲(chǔ)目錄指到空間大的盤。改完它會(huì)遷移已有數(shù)據(jù)耐心等。General 里確認(rèn)后端類型核對(duì)一下是不是你想要的 WSL2 或 Hyper-V。配置改完點(diǎn) Apply Restart等它重啟生效。這時(shí)候打開(kāi)終端敲docker version能看到客戶端和服務(wù)端的版本信息就說(shuō)明裝好了。3.4 驗(yàn)證安裝三條命令確認(rèn)一切正常別裝完就以為萬(wàn)事大吉跑幾條命令驗(yàn)證一下。第一條docker version看客戶端和服務(wù)端是否都正常返回如果只有客戶端沒(méi)有服務(wù)端說(shuō)明引擎沒(méi)起來(lái)。第二條docker info輸出里能看到容器數(shù)、鏡像數(shù)、存儲(chǔ)驅(qū)動(dòng)、后端類型等信息重點(diǎn)確認(rèn)Operating System顯示的是 Linux說(shuō)明運(yùn)行環(huán)境正常。第三條拉個(gè)測(cè)試鏡像跑一下docker run --rm hello-world這條命令會(huì)拉取一個(gè)極小的鏡像并運(yùn)行輸出一段歡迎信息就代表整條鏈路通了。如果卡在拉取鏡像那一步多半是網(wǎng)絡(luò)問(wèn)題第四部分會(huì)講怎么處理。注意hello-world跑通不代表所有鏡像都能拉它體積小、層數(shù)少網(wǎng)絡(luò)波動(dòng)時(shí)更容易成功。真正驗(yàn)證網(wǎng)絡(luò)建議拉一個(gè)稍大的常用鏡像試試。4. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄4.1 安裝階段報(bào)錯(cuò)從報(bào)錯(cuò)信息反推根因安裝階段最常見(jiàn)的幾類報(bào)錯(cuò)我按癥狀整理成速查表對(duì)號(hào)入座。報(bào)錯(cuò)癥狀可能原因處理方向安裝到一半提示組件安裝失敗系統(tǒng)版本不滿足或組件缺失核對(duì)系統(tǒng)版本補(bǔ)裝運(yùn)行庫(kù)提示需要啟用虛擬化BIOS 虛擬化未開(kāi)進(jìn) BIOS 開(kāi)啟 VT-x/AMD-V提示 WSL2 內(nèi)核版本過(guò)低內(nèi)核更新包未裝下載安裝對(duì)應(yīng)架構(gòu)更新包安裝程序無(wú)響應(yīng)或閃退權(quán)限不足或殺毒軟件攔截以管理員運(yùn)行臨時(shí)關(guān)防護(hù)提示已有舊版本沖突殘留舊版 Docker 或組件徹底卸載舊版再裝拿組件安裝失敗這條來(lái)說(shuō)很多人以為是安裝包壞了反復(fù)重下。實(shí)際上更常見(jiàn)的是系統(tǒng)缺了某些運(yùn)行庫(kù)或者 Windows 更新沒(méi)打全。我的做法是先跑一遍 Windows 更新把系統(tǒng)補(bǔ)丁打齊再重試安裝成功率明顯提高。殺毒軟件攔截這條也值得單獨(dú)說(shuō)。某些安全軟件會(huì)對(duì)安裝程序?qū)懭胂到y(tǒng)目錄、注冊(cè)服務(wù)的行為比較敏感直接攔掉導(dǎo)致安裝中斷。遇到閃退又找不到原因臨時(shí)退出防護(hù)再裝一次裝完再開(kāi)回來(lái)往往就過(guò)了。4.2 啟動(dòng)卡住引擎起不來(lái)的幾種典型情況裝完了但啟動(dòng)一直轉(zhuǎn)圈或者界面顯示引擎 stopped這是第二大類問(wèn)題。根因通常集中在虛擬化層和 WSL2 配置上。第一種情況WSL2 沒(méi)配好。表現(xiàn)是 Docker Desktop 啟動(dòng)時(shí)報(bào) WSL 相關(guān)錯(cuò)誤。排查方法單獨(dú)在終端跑wsl --status看默認(rèn)版本和內(nèi)核狀態(tài)。如果提示需要更新內(nèi)核按提示裝更新包如果默認(rèn)版本還是 1重新執(zhí)行wsl --set-default-version 2。第二種情況虛擬化被其他軟件占用。Hyper-V 后端尤其容易遇到機(jī)器上如果裝了某些虛擬化軟件可能搶占了虛擬化層。表現(xiàn)是啟動(dòng)報(bào)虛擬化不可用的錯(cuò)誤。處理辦法是換用 WSL2 后端或者卸載沖突軟件。第三種情況WSL2 的發(fā)行版狀態(tài)異常。有時(shí)候 WSL 里的運(yùn)行環(huán)境卡死了Docker 拉不起來(lái)?？梢試L試wsl --shutdown關(guān)掉所有 WSL 實(shí)例再重新啟動(dòng) Docker Desktop。這一招我用了很多次十有八九能解決啟動(dòng)卡死。第四種情況磁盤空間不足導(dǎo)致引擎初始化失敗。這個(gè)報(bào)錯(cuò)信息有時(shí)候不明顯但看日志能看到寫入失敗。清理系統(tǒng)盤空間后重啟即可。4.3 命令行找不到 dockerPATH 與終端的老問(wèn)題裝完了圖形界面能開(kāi)但終端里敲docker提示不是內(nèi)部或外部命令。這個(gè)問(wèn)題九成是 PATH 沒(méi)生效或者終端沒(méi)刷新。先確認(rèn)安裝目錄在不在 PATH 里。Docker Desktop 默認(rèn)把可執(zhí)行文件放在安裝目錄下的 resources/bin 子目錄安裝程序會(huì)把它加到系統(tǒng) PATH。檢查方法打開(kāi)系統(tǒng)環(huán)境變量設(shè)置看 Path 里有沒(méi)有對(duì)應(yīng)條目。沒(méi)有的話手動(dòng)加上加完必須重開(kāi)終端。如果 PATH 里有但還是找不到多半是終端緩存了舊的環(huán)境變量。把當(dāng)前終端窗口關(guān)掉重新開(kāi)一個(gè)。VS Code 里的集成終端尤其容易有這個(gè)問(wèn)題因?yàn)樗^承的是啟動(dòng)時(shí)的環(huán)境裝完 Docker 后不重啟 VS Code 就一直找不到命令。我踩過(guò)這個(gè)坑折騰半天以為是安裝失敗其實(shí)重啟編輯器就好了。還有一種少見(jiàn)情況裝了多個(gè)終端工具某個(gè)工具的 shell 配置文件里覆蓋了 PATH。檢查一下.bashrc、.zshrc或者 PowerShell 的 profile 文件里有沒(méi)有手動(dòng)改 PATH 的語(yǔ)句。4.4 拉取鏡像慢或失敗網(wǎng)絡(luò)層面的處理思路鏡像拉取慢是高頻問(wèn)題尤其是拉一些體積大的基礎(chǔ)鏡像。這個(gè)問(wèn)題的本質(zhì)是鏡像倉(cāng)庫(kù)的網(wǎng)絡(luò)可達(dá)性和帶寬。處理思路分幾層。第一層確認(rèn)是不是全局網(wǎng)絡(luò)問(wèn)題。先拉h(huán)ello-world這種小鏡像測(cè)試如果小鏡像也拉不動(dòng)說(shuō)明是整體網(wǎng)絡(luò)不通檢查本機(jī)網(wǎng)絡(luò)和代理設(shè)置。如果小鏡像能拉、大鏡像卡住多半是帶寬或超時(shí)問(wèn)題。第二層調(diào)整 Docker 的鏡像拉取超時(shí)和并發(fā)。在 Docker Desktop 設(shè)置里可以配置不過(guò)更實(shí)用的做法是換用國(guó)內(nèi)可訪問(wèn)的鏡像加速地址。在設(shè)置界面的 Docker Engine 配置里找到 registry-mirrors 字段填入可用的加速地址保存重啟。這一步能顯著改善拉取速度。第三層如果某個(gè)特定鏡像反復(fù)失敗可能是該鏡像的層太大或者源站不穩(wěn)定?？梢該Q個(gè)時(shí)間重試或者找該鏡像的替代版本比如用 alpine 基礎(chǔ)的精簡(jiǎn)版。我遇到過(guò)拉某個(gè)中間件鏡像卡在最后一層的情況換了個(gè) tag 就順利拉下來(lái)了。實(shí)操心得鏡像加速地址不是越多越好配一兩個(gè)穩(wěn)定的就行。配太多反而可能因?yàn)槟硞€(gè)地址響應(yīng)慢拖累整體速度。配完記得重啟引擎生效。4.5 磁盤占用暴漲鏡像和容器的清理策略用一段時(shí)間之后發(fā)現(xiàn) C 盤空間告急這是 Docker 用戶的通病。鏡像、容器、構(gòu)建緩存都會(huì)占空間而且默認(rèn)不自動(dòng)清理。先看占用情況跑docker system df它會(huì)列出鏡像、容器、卷、構(gòu)建緩存各自占了多少。看完心里有數(shù)再?zèng)Q定清什么。清理的常用命令docker system prune這條會(huì)清理停止的容器、懸空鏡像、未使用的網(wǎng)絡(luò)和構(gòu)建緩存。加-a參數(shù)會(huì)連未被容器引用的鏡像一起清掉加--volumes會(huì)連未使用的數(shù)據(jù)卷也清掉。數(shù)據(jù)卷要謹(jǐn)慎里面可能有你要保留的數(shù)據(jù)。更根本的辦法是把鏡像存儲(chǔ)位置遷到空間大的盤。在 Docker Desktop 設(shè)置的 Disk image location 里改路徑它會(huì)自動(dòng)遷移。遷完之后系統(tǒng)盤壓力立刻緩解。我一般裝完就順手遷到 D 盤或數(shù)據(jù)盤省得后面反復(fù)清理。5. 裝完之后的調(diào)優(yōu)與長(zhǎng)期使用建議5.1 資源限制怎么設(shè)才合理Docker Desktop 默認(rèn)的資源分配策略偏保守容易在跑多個(gè)容器時(shí)把機(jī)器拖慢。合理的設(shè)置取決于你的機(jī)器配置和日常用法。8GB 內(nèi)存的機(jī)器建議給 Docker 分配 2 到 3GBCPU 給 2 核。這個(gè)配置能跑一兩個(gè)輕量容器再多就吃力了。16GB 內(nèi)存的機(jī)器給 4 到 6GB 內(nèi)存、4 核 CPU 比較舒服能同時(shí)跑數(shù)據(jù)庫(kù)、緩存、應(yīng)用服務(wù)。32GB 以上的機(jī)器可以放寬到 8GB 內(nèi)存基本不用太擔(dān)心資源爭(zhēng)搶。設(shè)置的位置在 Resources 面板。改完 Apply Restart 生效。這里有個(gè)細(xì)節(jié)內(nèi)存限制設(shè)得太低某些鏡像啟動(dòng)時(shí)會(huì)因?yàn)閮?nèi)存不足直接退出報(bào)錯(cuò)信息還不一定明確。如果遇到容器莫名退出先檢查是不是資源限制卡太死。5.2 開(kāi)機(jī)自啟與后臺(tái)運(yùn)行的取舍Docker Desktop 默認(rèn)開(kāi)機(jī)自啟方便是方便但會(huì)拖慢開(kāi)機(jī)速度還常駐占資源。我的建議是按需開(kāi)啟如果你每天都用保持自啟如果只是偶爾用關(guān)掉自啟需要時(shí)手動(dòng)開(kāi)。關(guān)閉自啟在設(shè)置的 General 里取消勾選開(kāi)機(jī)啟動(dòng)相關(guān)選項(xiàng)即可。另外Docker Desktop 在后臺(tái)運(yùn)行時(shí)會(huì)持續(xù)占用一部分內(nèi)存即使沒(méi)有容器在跑。機(jī)器內(nèi)存緊張的話不用的時(shí)候退出它能省下不少資源。5.3 數(shù)據(jù)卷和文件掛載的路徑習(xí)慣在 Windows 上用 Docker文件掛載的路徑寫法是個(gè)容易踩坑的地方。Windows 路徑用反斜杠Docker 命令里要用正斜杠而且盤符要寫成特定格式。比如把D:\projects\app掛載到容器里命令里要寫成/d/projects/app或者用D:/projects/app的形式具體取決于你用的終端和 Docker 版本。我的習(xí)慣是在項(xiàng)目目錄下統(tǒng)一用相對(duì)路徑或者環(huán)境變量避免硬編碼絕對(duì)路徑?？缦到y(tǒng)文件訪問(wèn)的性能也值得注意從容器里訪問(wèn) Windows 文件系統(tǒng)的文件性能比訪問(wèn)容器內(nèi)部文件慢不少尤其是大量小文件讀寫。所以代碼目錄掛載沒(méi)問(wèn)題但數(shù)據(jù)庫(kù)數(shù)據(jù)目錄、構(gòu)建緩存這類高頻讀寫的東西盡量放在容器內(nèi)部或者命名卷里別直接掛 Windows 目錄。5.4 版本升級(jí)的注意事項(xiàng)Docker Desktop 會(huì)提示新版本升級(jí)本身不復(fù)雜但升級(jí)前有兩件事要做。第一確認(rèn)當(dāng)前跑的容器和鏡像有沒(méi)有正在用的重要數(shù)據(jù)升級(jí)過(guò)程可能會(huì)重啟引擎運(yùn)行中的容器會(huì)停。第二升級(jí)前看一眼新版本的更新說(shuō)明某些大版本升級(jí)會(huì)改默認(rèn)配置或者要求更高的系統(tǒng)版本。升級(jí)后如果遇到啟動(dòng)問(wèn)題第一反應(yīng)是檢查 WSL2 狀態(tài)跑一下wsl --shutdown再啟動(dòng)。升級(jí)偶爾會(huì)把 WSL 的默認(rèn)版本重置重新設(shè)一下就好。我一般不在有重要容器運(yùn)行的時(shí)候升級(jí)挑個(gè)空閑時(shí)間操作出問(wèn)題也好處理。6. 我踩過(guò)的幾個(gè)坑和最后的經(jīng)驗(yàn)說(shuō)幾個(gè)印象深的實(shí)際經(jīng)歷。有一次在一臺(tái)家庭版機(jī)器上裝系統(tǒng)版本是 1909怎么都裝不上報(bào)錯(cuò)信息含糊。折騰半天才反應(yīng)過(guò)來(lái)家庭版 1909 不支持 WSL2 后端必須升到 2004 以上。升級(jí)系統(tǒng)之后一次就過(guò)了。這件事讓我養(yǎng)成了裝之前先winver看版本的習(xí)慣。還有一次裝完命令行死活找不到 dockerPATH 檢查了沒(méi)問(wèn)題最后發(fā)現(xiàn)是 VS Code 的集成終端沒(méi)重啟。關(guān)掉編輯器重開(kāi)立刻正常。這種問(wèn)題最氣人因?yàn)樗信渲枚紝?duì)就是環(huán)境沒(méi)刷新。另一個(gè)高頻坑是鏡像拉取。早期沒(méi)配加速地址拉個(gè)大鏡像能等到懷疑人生還經(jīng)常超時(shí)失敗。配上穩(wěn)定的加速地址之后體驗(yàn)完全不一樣。這個(gè)配置建議裝完就做別等被慢速折磨了才想起來(lái)。最后分享一個(gè)小技巧裝完之后把docker system df和docker system prune這兩個(gè)命令記牢定期看一眼占用、定期清理能避免磁盤被悄悄吃滿。Docker 用起來(lái)很爽但它不會(huì)主動(dòng)幫你管空間這個(gè)活兒得自己上心。這套流程走下來(lái)Win10 上裝 Docker Desktop 基本不會(huì)再卡住。核心就三件事系統(tǒng)環(huán)境和虛擬化先備好后端選對(duì)裝完做基礎(chǔ)配置和驗(yàn)證。剩下的問(wèn)題按第四部分的速查表對(duì)號(hào)入座絕大多數(shù)都能自己解決。 Win10 安裝 Docker Desktop 全攻略：環(huán)境預(yù)檢、WSL2 配置與故障排查
1. 為什么 Win10 裝 Docker Desktop 總卡在第一步Win10 系統(tǒng)安裝 Docker Desktop 這件事說(shuō)簡(jiǎn)單也簡(jiǎn)單說(shuō)折騰也真能折騰一整天。我前后在不下十臺(tái)不同配置的 Win10 機(jī)器上裝過(guò)這玩意兒從公司臺(tái)式機(jī)到個(gè)人筆記本從家庭版到專業(yè)版踩過(guò)的坑基本能湊成一本小冊(cè)子。很多人第一次裝的時(shí)候下載完安裝包雙擊進(jìn)度條走到一半報(bào)錯(cuò)或者裝完了啟動(dòng)一直轉(zhuǎn)圈又或者命令行里敲docker提示找不到命令心態(tài)直接崩。這篇內(nèi)容就是把這些年積累的實(shí)操經(jīng)驗(yàn)攤開(kāi)講清楚從系統(tǒng)環(huán)境預(yù)檢、組件依賴、安裝參數(shù)選擇到裝完之后的配置調(diào)優(yōu)和故障排查一條龍給你捋順。先說(shuō)清楚這個(gè)內(nèi)容適合誰(shuí)看。如果你是剛接觸容器技術(shù)、想在 Windows 上跑 Docker 做開(kāi)發(fā)環(huán)境的新手這篇能幫你少走至少三四個(gè)小時(shí)的彎路如果你是有一定基礎(chǔ)但被某個(gè)具體報(bào)錯(cuò)卡住的老手第四部分的排查速查表應(yīng)該能直接對(duì)上你的癥狀。核心關(guān)鍵詞就一個(gè)Win10 系統(tǒng)安裝 Docker Desktop圍繞它展開(kāi)的所有前置條件、安裝細(xì)節(jié)、啟動(dòng)配置和問(wèn)題處理我都會(huì)講到。Docker Desktop 本質(zhì)上是一個(gè)把 Docker 引擎、命令行客戶端、圖形管理界面打包在一起的桌面應(yīng)用。在 Windows 上它并不是原生跑 Linux 容器而是依賴一層虛擬化能力來(lái)承載一個(gè)輕量級(jí)的 Linux 運(yùn)行環(huán)境。這就決定了它對(duì) Windows 系統(tǒng)的版本、虛擬化開(kāi)關(guān)、相關(guān)系統(tǒng)組件有硬性要求。很多人裝不上根子不在 Docker 本身而在系統(tǒng)環(huán)境沒(méi)準(zhǔn)備好。所以整篇內(nèi)容的邏輯是先把地基打牢再談安裝最后處理裝完之后的收尾問(wèn)題。我見(jiàn)過(guò)太多人一上來(lái)就找安裝包結(jié)果系統(tǒng)版本不夠、虛擬化沒(méi)開(kāi)、相關(guān)組件缺失裝到一半各種報(bào)錯(cuò)然后開(kāi)始懷疑是安裝包有問(wèn)題。其實(shí)只要按順序把前置檢查做一遍后面會(huì)順很多。下面就從整體思路開(kāi)始拆。2. 安裝前的整體思路與環(huán)境預(yù)檢2.1 先搞清楚你的 Win10 到底夠不夠格Docker Desktop 對(duì) Windows 版本有明確門檻。我整理了一張對(duì)照表裝之前先對(duì)號(hào)入座別急著下載安裝包。系統(tǒng)版本是否支持關(guān)鍵說(shuō)明Win10 家庭版 2004 及以上支持需要啟用 WSL2 后端Win10 專業(yè)版 1903 及以上支持可用 Hyper-V 或 WSL2 后端Win10 企業(yè)版 1903 及以上支持同專業(yè)版Win10 1809 及以下不支持需先升級(jí)系統(tǒng)Win10 家庭版 1903 以下不支持家庭版早期版本缺組件查看系統(tǒng)版本的方法很簡(jiǎn)單按Win R輸入winver回車彈窗里就能看到版本號(hào)和內(nèi)部版本號(hào)。這里有個(gè)容易忽略的點(diǎn)家庭版和專業(yè)版的支持路徑不一樣。專業(yè)版可以用傳統(tǒng)的 Hyper-V 虛擬化后端家庭版沒(méi)有 Hyper-V 管理工具必須走 WSL2 這條路。所以家庭版用戶裝之前重點(diǎn)是把 WSL2 配好而不是去折騰 Hyper-V。我個(gè)人的建議是不管你是哪個(gè)版本只要系統(tǒng)支持優(yōu)先選 WSL2 后端。原因后面會(huì)細(xì)講簡(jiǎn)單說(shuō)就是資源占用更小、啟動(dòng)更快、和 Windows 文件系統(tǒng)的交互更順。Hyper-V 后端雖然成熟但它會(huì)獨(dú)占虛擬化層可能和你機(jī)器上其他虛擬化軟件比如某些安卓模擬器打架。2.2 虛擬化開(kāi)關(guān)最容易被忽略的第一道坎Docker Desktop 不管用哪種后端底層都要依賴 CPU 的硬件虛擬化能力。這個(gè)開(kāi)關(guān)在 BIOS/UEFI 里默認(rèn)可能是關(guān)閉的。判斷方法打開(kāi)任務(wù)管理器切到性能標(biāo)簽頁(yè)看 CPU 那一欄下方有沒(méi)有虛擬化已啟用字樣。如果顯示已禁用那就得進(jìn) BIOS 打開(kāi)。進(jìn) BIOS 的按鍵各家主板不一樣常見(jiàn)的是開(kāi)機(jī)時(shí)連按Del、F2、F10或F12。進(jìn)去之后找Virtualization Technology、Intel VT-x、AMD-V、SVM Mode這類選項(xiàng)設(shè)為 Enabled保存重啟。這一步聽(tīng)起來(lái)簡(jiǎn)單但實(shí)際卡住的人不少尤其是品牌整機(jī)BIOS 菜單藏得深有的還把虛擬化選項(xiàng)放在安全相關(guān)的子菜單里。注意部分公司配發(fā)的機(jī)器 BIOS 被鎖了虛擬化選項(xiàng)改不了。這種情況只能找 IT 管理員處理自己硬折騰沒(méi)用。虛擬化打開(kāi)之后還要確認(rèn) Windows 的虛擬化相關(guān)功能沒(méi)有被禁用。專業(yè)版用戶檢查啟用或關(guān)閉 Windows 功能里Hyper-V和虛擬機(jī)平臺(tái)是否可用家庭版用戶重點(diǎn)看虛擬機(jī)平臺(tái)這一項(xiàng)。這些是 WSL2 運(yùn)行的基礎(chǔ)。2.3 后端選型WSL2 還是 Hyper-V別選錯(cuò)這是安裝前最關(guān)鍵的決策選錯(cuò)了后面全是麻煩。我把兩種后端的差異列出來(lái)你對(duì)照自己的情況選。對(duì)比維度WSL2 后端Hyper-V 后端系統(tǒng)要求Win10 2004家庭版可用Win10 專業(yè)版/企業(yè)版資源占用較低按需分配內(nèi)存較高預(yù)留固定資源啟動(dòng)速度快秒級(jí)相對(duì)慢文件交互跨系統(tǒng)文件訪問(wèn)順暢需通過(guò)掛載稍繁瑣與其他虛擬化軟件共存兼容性較好可能沖突配置復(fù)雜度需先配好 WSL2開(kāi)啟 Hyper-V 即可我的實(shí)操結(jié)論很明確能用 WSL2 就用 WSL2。家庭版沒(méi)得選只能 WSL2專業(yè)版雖然兩條路都通但 WSL2 的體驗(yàn)明顯更輕快。唯一需要注意的是WSL2 要求系統(tǒng)版本 2004 及以上如果你的專業(yè)版還停在 1903 或 1909要么升級(jí)系統(tǒng)走 WSL2要么退回 Hyper-V 后端。選 WSL2 的話安裝 Docker Desktop 之前要先把 WSL2 本身配好包括啟用相關(guān) Windows 功能、安裝 WSL2 內(nèi)核更新包、設(shè)置默認(rèn)版本為 2。這部分是前置工作做扎實(shí)了 Docker Desktop 安裝過(guò)程會(huì)非常順。選 Hyper-V 的話確保 Hyper-V 功能已啟用、機(jī)器沒(méi)有跑其他搶占虛擬化層的軟件即可。2.4 磁盤和內(nèi)存別讓資源成為隱形瓶頸Docker 鏡像和容器都占磁盤默認(rèn)情況下鏡像存在系統(tǒng)盤。Win10 系統(tǒng)盤空間緊張是常態(tài)裝之前先看一眼 C 盤剩余空間。我的經(jīng)驗(yàn)是至少留出 20GB 以上因?yàn)槔瓗讉€(gè)常用鏡像比如數(shù)據(jù)庫(kù)、中間件很快就能吃掉好幾個(gè) G?？臻g實(shí)在不夠可以在安裝后把鏡像存儲(chǔ)位置遷到其他盤這個(gè)后面配置部分會(huì)講。內(nèi)存方面Docker Desktop 默認(rèn)會(huì)占用一部分內(nèi)存給 Linux 運(yùn)行環(huán)境。8GB 內(nèi)存的機(jī)器能跑但同時(shí)開(kāi) IDE、瀏覽器、數(shù)據(jù)庫(kù)容器會(huì)比較吃力16GB 是比較舒服的起步配置。如果內(nèi)存偏小可以在設(shè)置里限制 Docker 可用的內(nèi)存上限避免它把系統(tǒng)拖垮。3. 核心組件安裝與實(shí)操步驟3.1 WSL2 環(huán)境搭建家庭版和專業(yè)版都要過(guò)的關(guān)不管你最終用哪種后端只要走 WSL2 路線這一步繞不開(kāi)。我按順序列操作你照著做就行。第一步啟用兩個(gè) Windows 功能。以管理員身份打開(kāi) PowerShell執(zhí)行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart第一條啟用 Linux 子系統(tǒng)支持第二條啟用虛擬機(jī)平臺(tái)。兩條執(zhí)行完重啟電腦。這里解釋一下為什么需要這兩個(gè)前者是 WSL 的基礎(chǔ)支撐后者提供輕量級(jí)虛擬化能力WSL2 正是跑在這個(gè)虛擬化平臺(tái)上的。第二步安裝 WSL2 內(nèi)核更新包。這個(gè)包是微軟官方提供的獨(dú)立安裝程序下載后雙擊運(yùn)行即可。裝完之后把 WSL 的默認(rèn)版本設(shè)為 2wsl --set-default-version 2第三步驗(yàn)證。執(zhí)行wsl --list --verbose如果能看到已安裝的發(fā)行版且版本列顯示 2說(shuō)明配置成功。如果提示沒(méi)有安裝任何發(fā)行版也沒(méi)關(guān)系Docker Desktop 會(huì)自己帶一個(gè)運(yùn)行環(huán)境但建議至少裝一個(gè)基礎(chǔ)發(fā)行版方便調(diào)試。實(shí)操心得wsl --set-default-version 2這條命令如果報(bào)錯(cuò)說(shuō)內(nèi)核版本不支持多半是內(nèi)核更新包沒(méi)裝或沒(méi)裝對(duì)版本。重新下載對(duì)應(yīng)架構(gòu)x64 或 ARM64的更新包再試。3.2 下載與安裝 Docker Desktop 的正確姿勢(shì)安裝包從官方渠道獲取選 Windows 版本。下載的時(shí)候注意架構(gòu)絕大多數(shù)機(jī)器是 x64少數(shù)輕薄本是 ARM64下錯(cuò)了裝不上。安裝包體積不小下載慢的話耐心等別去第三方站點(diǎn)下所謂的精簡(jiǎn)版那些改過(guò)的包后續(xù)出問(wèn)題很難排查。雙擊安裝包安裝向?qū)Ю镉袀€(gè)關(guān)鍵選項(xiàng)Use WSL 2 instead of Hyper-V。這個(gè)勾選框決定了后端類型。如果你前面配好了 WSL2就勾上它如果你打算用 Hyper-V 后端就取消勾選。這一步選錯(cuò)裝完之后還得在設(shè)置里改不如一次到位。安裝過(guò)程會(huì)請(qǐng)求管理員權(quán)限同意即可。進(jìn)度條走完提示重啟或者直接完成按提示操作。這里有個(gè)細(xì)節(jié)安裝程序會(huì)自動(dòng)把 Docker 相關(guān)目錄加到系統(tǒng) PATH但有時(shí)候需要重新打開(kāi)終端才生效。裝完先別急著敲命令把終端關(guān)掉重開(kāi)一個(gè)。安裝路徑默認(rèn)在系統(tǒng)盤如果 C 盤緊張安裝向?qū)Ю锟梢愿牡狡渌P。不過(guò)要注意即使程序裝到別的盤鏡像數(shù)據(jù)默認(rèn)還是在系統(tǒng)盤的用戶目錄下這個(gè)后面單獨(dú)說(shuō)怎么遷。3.3 首次啟動(dòng)與初始配置第一次啟動(dòng) Docker Desktop會(huì)彈服務(wù)條款接受之后進(jìn)入初始化。這時(shí)候它會(huì)在后臺(tái)拉起 Linux 運(yùn)行環(huán)境第一次可能要等一兩分鐘。界面左下角會(huì)顯示引擎狀態(tài)變成綠色 running 就說(shuō)明起來(lái)了。首次啟動(dòng)后建議先做幾項(xiàng)基礎(chǔ)配置在設(shè)置界面里操作Resources 里限制內(nèi)存和 CPU默認(rèn)它會(huì)吃掉不少資源按你機(jī)器實(shí)際情況調(diào)。8GB 內(nèi)存的機(jī)器建議給 Docker 分配 2 到 3GB16GB 的可以給 4 到 6GB。Disk image location 改存儲(chǔ)位置如果系統(tǒng)盤緊張?jiān)谶@里把鏡像存儲(chǔ)目錄指到空間大的盤。改完它會(huì)遷移已有數(shù)據(jù)耐心等。General 里確認(rèn)后端類型核對(duì)一下是不是你想要的 WSL2 或 Hyper-V。配置改完點(diǎn) Apply Restart等它重啟生效。這時(shí)候打開(kāi)終端敲docker version能看到客戶端和服務(wù)端的版本信息就說(shuō)明裝好了。3.4 驗(yàn)證安裝三條命令確認(rèn)一切正常別裝完就以為萬(wàn)事大吉跑幾條命令驗(yàn)證一下。第一條docker version看客戶端和服務(wù)端是否都正常返回如果只有客戶端沒(méi)有服務(wù)端說(shuō)明引擎沒(méi)起來(lái)。第二條docker info輸出里能看到容器數(shù)、鏡像數(shù)、存儲(chǔ)驅(qū)動(dòng)、后端類型等信息重點(diǎn)確認(rèn)Operating System顯示的是 Linux說(shuō)明運(yùn)行環(huán)境正常。第三條拉個(gè)測(cè)試鏡像跑一下docker run --rm hello-world這條命令會(huì)拉取一個(gè)極小的鏡像并運(yùn)行輸出一段歡迎信息就代表整條鏈路通了。如果卡在拉取鏡像那一步多半是網(wǎng)絡(luò)問(wèn)題第四部分會(huì)講怎么處理。注意hello-world跑通不代表所有鏡像都能拉它體積小、層數(shù)少網(wǎng)絡(luò)波動(dòng)時(shí)更容易成功。真正驗(yàn)證網(wǎng)絡(luò)建議拉一個(gè)稍大的常用鏡像試試。4. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄4.1 安裝階段報(bào)錯(cuò)從報(bào)錯(cuò)信息反推根因安裝階段最常見(jiàn)的幾類報(bào)錯(cuò)我按癥狀整理成速查表對(duì)號(hào)入座。報(bào)錯(cuò)癥狀可能原因處理方向安裝到一半提示組件安裝失敗系統(tǒng)版本不滿足或組件缺失核對(duì)系統(tǒng)版本補(bǔ)裝運(yùn)行庫(kù)提示需要啟用虛擬化BIOS 虛擬化未開(kāi)進(jìn) BIOS 開(kāi)啟 VT-x/AMD-V提示 WSL2 內(nèi)核版本過(guò)低內(nèi)核更新包未裝下載安裝對(duì)應(yīng)架構(gòu)更新包安裝程序無(wú)響應(yīng)或閃退權(quán)限不足或殺毒軟件攔截以管理員運(yùn)行臨時(shí)關(guān)防護(hù)提示已有舊版本沖突殘留舊版 Docker 或組件徹底卸載舊版再裝拿組件安裝失敗這條來(lái)說(shuō)很多人以為是安裝包壞了反復(fù)重下。實(shí)際上更常見(jiàn)的是系統(tǒng)缺了某些運(yùn)行庫(kù)或者 Windows 更新沒(méi)打全。我的做法是先跑一遍 Windows 更新把系統(tǒng)補(bǔ)丁打齊再重試安裝成功率明顯提高。殺毒軟件攔截這條也值得單獨(dú)說(shuō)。某些安全軟件會(huì)對(duì)安裝程序?qū)懭胂到y(tǒng)目錄、注冊(cè)服務(wù)的行為比較敏感直接攔掉導(dǎo)致安裝中斷。遇到閃退又找不到原因臨時(shí)退出防護(hù)再裝一次裝完再開(kāi)回來(lái)往往就過(guò)了。4.2 啟動(dòng)卡住引擎起不來(lái)的幾種典型情況裝完了但啟動(dòng)一直轉(zhuǎn)圈或者界面顯示引擎 stopped這是第二大類問(wèn)題。根因通常集中在虛擬化層和 WSL2 配置上。第一種情況WSL2 沒(méi)配好。表現(xiàn)是 Docker Desktop 啟動(dòng)時(shí)報(bào) WSL 相關(guān)錯(cuò)誤。排查方法單獨(dú)在終端跑wsl --status看默認(rèn)版本和內(nèi)核狀態(tài)。如果提示需要更新內(nèi)核按提示裝更新包如果默認(rèn)版本還是 1重新執(zhí)行wsl --set-default-version 2。第二種情況虛擬化被其他軟件占用。Hyper-V 后端尤其容易遇到機(jī)器上如果裝了某些虛擬化軟件可能搶占了虛擬化層。表現(xiàn)是啟動(dòng)報(bào)虛擬化不可用的錯(cuò)誤。處理辦法是換用 WSL2 后端或者卸載沖突軟件。第三種情況WSL2 的發(fā)行版狀態(tài)異常。有時(shí)候 WSL 里的運(yùn)行環(huán)境卡死了Docker 拉不起來(lái)?？梢試L試wsl --shutdown關(guān)掉所有 WSL 實(shí)例再重新啟動(dòng) Docker Desktop。這一招我用了很多次十有八九能解決啟動(dòng)卡死。第四種情況磁盤空間不足導(dǎo)致引擎初始化失敗。這個(gè)報(bào)錯(cuò)信息有時(shí)候不明顯但看日志能看到寫入失敗。清理系統(tǒng)盤空間后重啟即可。4.3 命令行找不到 dockerPATH 與終端的老問(wèn)題裝完了圖形界面能開(kāi)但終端里敲docker提示不是內(nèi)部或外部命令。這個(gè)問(wèn)題九成是 PATH 沒(méi)生效或者終端沒(méi)刷新。先確認(rèn)安裝目錄在不在 PATH 里。Docker Desktop 默認(rèn)把可執(zhí)行文件放在安裝目錄下的 resources/bin 子目錄安裝程序會(huì)把它加到系統(tǒng) PATH。檢查方法打開(kāi)系統(tǒng)環(huán)境變量設(shè)置看 Path 里有沒(méi)有對(duì)應(yīng)條目。沒(méi)有的話手動(dòng)加上加完必須重開(kāi)終端。如果 PATH 里有但還是找不到多半是終端緩存了舊的環(huán)境變量。把當(dāng)前終端窗口關(guān)掉重新開(kāi)一個(gè)。VS Code 里的集成終端尤其容易有這個(gè)問(wèn)題因?yàn)樗^承的是啟動(dòng)時(shí)的環(huán)境裝完 Docker 后不重啟 VS Code 就一直找不到命令。我踩過(guò)這個(gè)坑折騰半天以為是安裝失敗其實(shí)重啟編輯器就好了。還有一種少見(jiàn)情況裝了多個(gè)終端工具某個(gè)工具的 shell 配置文件里覆蓋了 PATH。檢查一下.bashrc、.zshrc或者 PowerShell 的 profile 文件里有沒(méi)有手動(dòng)改 PATH 的語(yǔ)句。4.4 拉取鏡像慢或失敗網(wǎng)絡(luò)層面的處理思路鏡像拉取慢是高頻問(wèn)題尤其是拉一些體積大的基礎(chǔ)鏡像。這個(gè)問(wèn)題的本質(zhì)是鏡像倉(cāng)庫(kù)的網(wǎng)絡(luò)可達(dá)性和帶寬。處理思路分幾層。第一層確認(rèn)是不是全局網(wǎng)絡(luò)問(wèn)題。先拉h(huán)ello-world這種小鏡像測(cè)試如果小鏡像也拉不動(dòng)說(shuō)明是整體網(wǎng)絡(luò)不通檢查本機(jī)網(wǎng)絡(luò)和代理設(shè)置。如果小鏡像能拉、大鏡像卡住多半是帶寬或超時(shí)問(wèn)題。第二層調(diào)整 Docker 的鏡像拉取超時(shí)和并發(fā)。在 Docker Desktop 設(shè)置里可以配置不過(guò)更實(shí)用的做法是換用國(guó)內(nèi)可訪問(wèn)的鏡像加速地址。在設(shè)置界面的 Docker Engine 配置里找到 registry-mirrors 字段填入可用的加速地址保存重啟。這一步能顯著改善拉取速度。第三層如果某個(gè)特定鏡像反復(fù)失敗可能是該鏡像的層太大或者源站不穩(wěn)定?？梢該Q個(gè)時(shí)間重試或者找該鏡像的替代版本比如用 alpine 基礎(chǔ)的精簡(jiǎn)版。我遇到過(guò)拉某個(gè)中間件鏡像卡在最后一層的情況換了個(gè) tag 就順利拉下來(lái)了。實(shí)操心得鏡像加速地址不是越多越好配一兩個(gè)穩(wěn)定的就行。配太多反而可能因?yàn)槟硞€(gè)地址響應(yīng)慢拖累整體速度。配完記得重啟引擎生效。4.5 磁盤占用暴漲鏡像和容器的清理策略用一段時(shí)間之后發(fā)現(xiàn) C 盤空間告急這是 Docker 用戶的通病。鏡像、容器、構(gòu)建緩存都會(huì)占空間而且默認(rèn)不自動(dòng)清理。先看占用情況跑docker system df它會(huì)列出鏡像、容器、卷、構(gòu)建緩存各自占了多少。看完心里有數(shù)再?zèng)Q定清什么。清理的常用命令docker system prune這條會(huì)清理停止的容器、懸空鏡像、未使用的網(wǎng)絡(luò)和構(gòu)建緩存。加-a參數(shù)會(huì)連未被容器引用的鏡像一起清掉加--volumes會(huì)連未使用的數(shù)據(jù)卷也清掉。數(shù)據(jù)卷要謹(jǐn)慎里面可能有你要保留的數(shù)據(jù)。更根本的辦法是把鏡像存儲(chǔ)位置遷到空間大的盤。在 Docker Desktop 設(shè)置的 Disk image location 里改路徑它會(huì)自動(dòng)遷移。遷完之后系統(tǒng)盤壓力立刻緩解。我一般裝完就順手遷到 D 盤或數(shù)據(jù)盤省得后面反復(fù)清理。5. 裝完之后的調(diào)優(yōu)與長(zhǎng)期使用建議5.1 資源限制怎么設(shè)才合理Docker Desktop 默認(rèn)的資源分配策略偏保守容易在跑多個(gè)容器時(shí)把機(jī)器拖慢。合理的設(shè)置取決于你的機(jī)器配置和日常用法。8GB 內(nèi)存的機(jī)器建議給 Docker 分配 2 到 3GBCPU 給 2 核。這個(gè)配置能跑一兩個(gè)輕量容器再多就吃力了。16GB 內(nèi)存的機(jī)器給 4 到 6GB 內(nèi)存、4 核 CPU 比較舒服能同時(shí)跑數(shù)據(jù)庫(kù)、緩存、應(yīng)用服務(wù)。32GB 以上的機(jī)器可以放寬到 8GB 內(nèi)存基本不用太擔(dān)心資源爭(zhēng)搶。設(shè)置的位置在 Resources 面板。改完 Apply Restart 生效。這里有個(gè)細(xì)節(jié)內(nèi)存限制設(shè)得太低某些鏡像啟動(dòng)時(shí)會(huì)因?yàn)閮?nèi)存不足直接退出報(bào)錯(cuò)信息還不一定明確。如果遇到容器莫名退出先檢查是不是資源限制卡太死。5.2 開(kāi)機(jī)自啟與后臺(tái)運(yùn)行的取舍Docker Desktop 默認(rèn)開(kāi)機(jī)自啟方便是方便但會(huì)拖慢開(kāi)機(jī)速度還常駐占資源。我的建議是按需開(kāi)啟如果你每天都用保持自啟如果只是偶爾用關(guān)掉自啟需要時(shí)手動(dòng)開(kāi)。關(guān)閉自啟在設(shè)置的 General 里取消勾選開(kāi)機(jī)啟動(dòng)相關(guān)選項(xiàng)即可。另外Docker Desktop 在后臺(tái)運(yùn)行時(shí)會(huì)持續(xù)占用一部分內(nèi)存即使沒(méi)有容器在跑。機(jī)器內(nèi)存緊張的話不用的時(shí)候退出它能省下不少資源。5.3 數(shù)據(jù)卷和文件掛載的路徑習(xí)慣在 Windows 上用 Docker文件掛載的路徑寫法是個(gè)容易踩坑的地方。Windows 路徑用反斜杠Docker 命令里要用正斜杠而且盤符要寫成特定格式。比如把D:\projects\app掛載到容器里命令里要寫成/d/projects/app或者用D:/projects/app的形式具體取決于你用的終端和 Docker 版本。我的習(xí)慣是在項(xiàng)目目錄下統(tǒng)一用相對(duì)路徑或者環(huán)境變量避免硬編碼絕對(duì)路徑?？缦到y(tǒng)文件訪問(wèn)的性能也值得注意從容器里訪問(wèn) Windows 文件系統(tǒng)的文件性能比訪問(wèn)容器內(nèi)部文件慢不少尤其是大量小文件讀寫。所以代碼目錄掛載沒(méi)問(wèn)題但數(shù)據(jù)庫(kù)數(shù)據(jù)目錄、構(gòu)建緩存這類高頻讀寫的東西盡量放在容器內(nèi)部或者命名卷里別直接掛 Windows 目錄。5.4 版本升級(jí)的注意事項(xiàng)Docker Desktop 會(huì)提示新版本升級(jí)本身不復(fù)雜但升級(jí)前有兩件事要做。第一確認(rèn)當(dāng)前跑的容器和鏡像有沒(méi)有正在用的重要數(shù)據(jù)升級(jí)過(guò)程可能會(huì)重啟引擎運(yùn)行中的容器會(huì)停。第二升級(jí)前看一眼新版本的更新說(shuō)明某些大版本升級(jí)會(huì)改默認(rèn)配置或者要求更高的系統(tǒng)版本。升級(jí)后如果遇到啟動(dòng)問(wèn)題第一反應(yīng)是檢查 WSL2 狀態(tài)跑一下wsl --shutdown再啟動(dòng)。升級(jí)偶爾會(huì)把 WSL 的默認(rèn)版本重置重新設(shè)一下就好。我一般不在有重要容器運(yùn)行的時(shí)候升級(jí)挑個(gè)空閑時(shí)間操作出問(wèn)題也好處理。6. 我踩過(guò)的幾個(gè)坑和最后的經(jīng)驗(yàn)說(shuō)幾個(gè)印象深的實(shí)際經(jīng)歷。有一次在一臺(tái)家庭版機(jī)器上裝系統(tǒng)版本是 1909怎么都裝不上報(bào)錯(cuò)信息含糊。折騰半天才反應(yīng)過(guò)來(lái)家庭版 1909 不支持 WSL2 后端必須升到 2004 以上。升級(jí)系統(tǒng)之后一次就過(guò)了。這件事讓我養(yǎng)成了裝之前先winver看版本的習(xí)慣。還有一次裝完命令行死活找不到 dockerPATH 檢查了沒(méi)問(wèn)題最后發(fā)現(xiàn)是 VS Code 的集成終端沒(méi)重啟。關(guān)掉編輯器重開(kāi)立刻正常。這種問(wèn)題最氣人因?yàn)樗信渲枚紝?duì)就是環(huán)境沒(méi)刷新。另一個(gè)高頻坑是鏡像拉取。早期沒(méi)配加速地址拉個(gè)大鏡像能等到懷疑人生還經(jīng)常超時(shí)失敗。配上穩(wěn)定的加速地址之后體驗(yàn)完全不一樣。這個(gè)配置建議裝完就做別等被慢速折磨了才想起來(lái)。最后分享一個(gè)小技巧裝完之后把docker system df和docker system prune這兩個(gè)命令記牢定期看一眼占用、定期清理能避免磁盤被悄悄吃滿。Docker 用起來(lái)很爽但它不會(huì)主動(dòng)幫你管空間這個(gè)活兒得自己上心。這套流程走下來(lái)Win10 上裝 Docker Desktop 基本不會(huì)再卡住。核心就三件事系統(tǒng)環(huán)境和虛擬化先備好后端選對(duì)裝完做基礎(chǔ)配置和驗(yàn)證。剩下的問(wèn)題按第四部分的速查表對(duì)號(hào)入座絕大多數(shù)都能自己解決。