Docker Desktop 的安裝包雙擊下去一路點下一步最后托盤里冒出那條小鯨魚——不少人以為這就裝完了。等真正敲下第一條docker run畫面卡在 pulling 上半天不動或者干脆甩一句 WSL kernel version too old才知道剛才那幾分鐘只是走了個過場。在 Windows 上部署 Docker麻煩的從來不是安裝本身而是它底下那層虛擬化底座有沒有鋪好、資源劃得合不合理、路徑掛載對不對得上。這篇就按我這幾年的實際折騰順序從底層選型講到日常維護把 Windows 上跑 Docker 這件事拆開揉碎說清楚適合剛上手的同學(xué)照著做也適合裝過但老是出毛病的人回頭對一遍。1. 裝之前先搞清楚Windows 上的 Docker 到底跑在什么之上1.1 三種運行模式的本質(zhì)區(qū)別很多人腦子里有個默認(rèn)印象覺得 Docker 是個裝在 Windows 上的普通軟件跟裝個壓縮工具沒區(qū)別。實際上 Windows 上的 Docker 從來不是原生跑的容器里的進程終究要落在某層虛擬化上。這一點想不明白后面所有報錯都會變成玄學(xué)。目前主流就三條路。第一條是 Docker Desktop WSL2 后端也是現(xiàn)在官方默認(rèn)推薦的路線Docker 引擎跑在一個輕量級的 Linux 虛擬機里這個虛擬機由 WSL2 提供你在 PowerShell 里敲的 docker 命令是通過命名管道轉(zhuǎn)發(fā)進去的。第二條是老一點的 Hyper-V 后端Docker 自己拉起一臺 LinuxKit 虛擬機跟 WSL2 是平級的兩種方案。第三條是 Windows 容器模式跑的是基于 Windows 內(nèi)核的容器鏡像動輒幾個 G生態(tài)也窄得多日常開發(fā)基本用不上。這三條路的差別不在于能不能跑而在于啟動速度、內(nèi)存占用、文件系統(tǒng)互通程度。WSL2 后端冷啟動通常幾秒鐘Hyper-V 后端要慢一截WSL2 的 Linux 根文件系統(tǒng)是真實 ext4跑數(shù)據(jù)庫這類吃 IO 的容器明顯更穩(wěn)而 Windows 容器模式連 basic 鏡像都得拉好久。你如果只是本地跑個 MySQL、Redis、Nginx 驗證業(yè)務(wù)邏輯閉眼選 WSL2 就對了。1.2 為什么默認(rèn)推薦 WSL2 而不是 Hyper-VWSL2 勝出的核心原因在于文件系統(tǒng)層的設(shè)計。Hyper-V 后端下你把 Windows 的代碼目錄掛進容器走的是 SMB 那一套讀一個幾萬文件的前端項目能卡到懷疑人生。WSL2 雖然跨系統(tǒng)訪問也有損耗但它的 Linux 側(cè)的/home目錄是實打?qū)嵉?ext4把項目放進去再掛載熱更新速度能差出好幾倍。還有一個容易被忽略的點是內(nèi)存回收。Hyper-V 后端那臺虛擬機一旦把內(nèi)存吃上去Windows 側(cè)不一定能及時要回來時間一長整機就開始發(fā)沉。WSL2 的虛擬機雖然也會膨脹這個我后面單獨講怎么治但至少有一個.wslconfig能從外部給它劃死上限可控性強不少。我個人的判斷標(biāo)準(zhǔn)很簡單只要能開 WSL2就別碰 Hyper-V 后端。除非你處在某些限制比較死的公司電腦環(huán)境里WSL2 用不了那才退而求其次。這條經(jīng)驗在幫別人排查問題時屢試不爽——十個容器跑起來特別慢的案例七八個都是后端用錯了。2. 裝之前的硬性檢查這幾項不過關(guān)后面全是白折騰2.1 虛擬化開關(guān)與系統(tǒng)版本的對號入座安裝之前先花兩分鐘做三項體檢比事后折騰半小時管用。第一項打開任務(wù)管理器切到性能標(biāo)簽頁點 CPU右下角會顯示虛擬化已啟用或已禁用。如果顯示已禁用別急著裝先去 BIOS 里把虛擬化打開不同主板叫法不一樣常見的是 VT-x、SVM、AMD-V、Virtualization Technology 這幾種說法通常在 Advanced 或者 CPU Configuration 子菜單下。第二項確認(rèn)系統(tǒng)版本。WSL2 要求 Windows 10 版本 2004 及以上或者 Windows 11 任意版本。按 WinR 輸入winver就能看到具體版本號。版本太老的話先升級系統(tǒng)別想著繞過去后面一定會出問題。第三項看看有沒有裝過舊版本的 Docker Toolbox 或者遠(yuǎn)古的 Docker for Windows。這類殘留會占用命名管道和端口新版本裝上去可能起不來?？刂泼姘謇锓槐橛芯托陡蓛繇槺惆延脩裟夸浵碌?docker文件夾也清掉。2.2 WSL2 的安裝順序與內(nèi)核更新如果你用的是比較新的 Windows 11一條命令就夠以管理員身份打開 PowerShell敲wsl --install它會自動幫你開啟虛擬機平臺功能、下載 WSL 和默認(rèn)的 Linux 發(fā)行版。跑完重啟一次開機后會自動彈出一個窗口讓你設(shè)用戶名密碼。老一點的 Windows 10 需要手動兩步。先啟用兩個可選功能dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart重啟之后再把 WSL2 設(shè)為默認(rèn)版本wsl --set-default-version 2。這一步很容易漏漏了的話新裝的發(fā)行版還是跑在 WSL1 上Docker 后端會提示不兼容。內(nèi)核更新包這個環(huán)節(jié)值得單獨說一句。有些機器重啟完wsl --status顯示的版本號特別老這時候需要單獨裝一次 WSL2 的 Linux 內(nèi)核更新補丁或者直接wsl --update讓它自己下。我遇到過一臺機器系統(tǒng)自動更新關(guān)掉了內(nèi)核補丁怎么都裝不上最后是手動下載 msi 包雙擊解決的。所以如果wsl --status報錯別慌先看看內(nèi)核這行。2.3 Windows 家庭版與公司電腦的繞行方案家庭版沒有 Hyper-V這是很多人卡住的地方。但好消息是Docker Desktop 走 WSL2 后端并不需要 Hyper-V 完整功能只需要虛擬機平臺這一項。所以家庭版照樣能裝安裝 Docker Desktop 時會提示你走 WSL2 分支點同意就行別被那句需要 Hyper-V嚇退。公司電腦的坑更隱蔽一些。有些環(huán)境開了組策略普通用戶沒有管理員權(quán)限改不了可選功能還有些裝了終端安全軟件會把新建的網(wǎng)絡(luò)適配器當(dāng)成異常行為攔下來。這類情況我的建議是先找 IT 確認(rèn)能不能開虛擬機平臺如果不能就老老實實申請一臺開發(fā)機或者用遠(yuǎn)程容器環(huán)境別想著在限制機器上硬來裝上了也三天兩頭出故障。另外提一句Windows 上那套\\wsl$的訪問路徑在某些網(wǎng)絡(luò)驅(qū)動器映射場景下會失效如果你打算把項目放在網(wǎng)絡(luò)盤上再掛載進容器基本可以放棄這個念頭性能會很糟糕。3. Docker Desktop 的安裝與首啟動配置3.1 安裝向?qū)Ю锏膸讉€勾選項該不該取消拿到安裝包之后默認(rèn)路徑是 C 盤如果 C 盤空間緊張可以在安裝時改到別的盤但要注意這里改的只是程序本身的位置鏡像和數(shù)據(jù)默認(rèn)還是落在 C 盤后面單獨講怎么挪。安裝向?qū)Ю镉袀€勾選項是Use WSL 2 instead of Hyper-V默認(rèn)是勾上的保持就好。還有一個是Add shortcut to desktop純個人喜好。倒是有一項要注意安裝完成后它會提示你注銷重新登錄讓當(dāng)前用戶加入 docker-users 用戶組。這一步別跳過跳過之后你會遇到經(jīng)典的 permission denied while trying to connect to the Docker daemon socket很多人以為是權(quán)限配置出問題其實就是沒重新登錄。裝完第一次啟動會跳出服務(wù)條款和可選的數(shù)據(jù)收集提示。服務(wù)條款得接受數(shù)據(jù)收集那項看你自己的接受程度不影響功能。之后它會做一次初始化可能要一兩分鐘別以為卡死了去強殺進程強殺之后殘留的配置會讓下次啟動更麻煩。3.2 設(shè)置面板里真正需要改的只有幾項打開設(shè)置面板一堆選項看著嚇人實際需要動的就幾處。第一處是 Resources 里的 CPU 和內(nèi)存分配。默認(rèn)值通常給得比較保守比如 2 核 2G跑個 Node 項目編譯就喘。我的經(jīng)驗是給到物理內(nèi)存的一半左右比如 16G 的機器給 8G核心數(shù)給一半或者略少。給太多也不行Windows 側(cè)自己就沒得用了切個瀏覽器都卡。第二處是 WSL Integration。這里會列出你裝過的所有 Linux 發(fā)行版把你常用的那個開關(guān)打開這樣在那個發(fā)行版的終端里也能直接敲 docker 命令不用每次都切回 PowerShell。這個功能太方便了尤其做前端的時候直接在 Ubuntu 終端里跑 npm 和 docker路徑問題少一半。第三處是 Disk image location鏡像存儲位置。默認(rèn)在C:\Users\你的用戶名\AppData\Local\Docker\wsl這個目錄會隨著你拉鏡像、建容器一路膨脹幾十個 G 很常見。后面單獨一節(jié)講遷移。還有一處值得改的是 Docker Engine 的配置如果拉鏡像速度慢可以在這里加一個鏡像加速地址。注意寫法是 JSON加完之后點 Apply Restart 讓它生效格式寫錯會導(dǎo)致 Docker 起不來改之前最好把原內(nèi)容復(fù)制一份留著。{ registry-mirrors: [https://你的加速地址] }3.3 把鏡像存儲挪出系統(tǒng)盤C 盤告急是 Windows 用戶的通病而 Docker 又是那種默默吃掉幾十 G 的軟件。遷移方式在設(shè)置面板里就有Resources 下面的 Advanced 里有個 Browse 按鈕選一個新目錄點 Apply它會提示你重啟 Docker 并自動搬過去。這個過程可能要幾分鐘取決于你已有的數(shù)據(jù)量期間別斷電別強退。如果設(shè)置面板里搬不動還有個更土但更穩(wěn)的辦法先wsl --shutdown把虛擬機停掉然后用wsl --export docker-desktop-data D:\docker-data.tar導(dǎo)出注銷原來那個發(fā)行版再用wsl --import導(dǎo)到新位置。這套操作風(fēng)險高一點路徑寫錯容易把數(shù)據(jù)弄丟所以我一般優(yōu)先用面板里的功能。搬完之后建議順手在設(shè)置里開一個清理提醒或者自己養(yǎng)個習(xí)慣每個月跑一次docker system df看看占用。這個命令會告訴你鏡像、容器、卷、構(gòu)建緩存各占多少比瞎猜準(zhǔn)得多。4. 跑通驗證從 hello-world 到真正能干活的環(huán)境4.1 三層驗證引擎、網(wǎng)絡(luò)、掛載裝完之后別急著上項目按三層遞進驗證出問題好定位。第一層引擎是否活著。敲docker version正常會輸出 Client 和 Server 兩段信息。如果只有 Client 沒有 Server說明引擎沒起來去看托盤圖標(biāo)是不是紅的或者執(zhí)行wsl -l -v看 docker-desktop 這個發(fā)行版狀態(tài)是不是 Running。第二層網(wǎng)絡(luò)和鏡像拉取。docker run hello-world是最經(jīng)典的驗證能打印出那段歡迎語就說明拉取、解壓、運行鏈路全通了。如果卡在 pulling 很久基本是網(wǎng)絡(luò)問題回到上一節(jié)配鏡像加速。第三層掛載和端口。這一步最容易被跳過但恰恰是后面出問題最多的地方。開一個 nginx 試試docker run -d --name web -p 8080:80 nginx瀏覽器訪問localhost:8080能看到歡迎頁就說明端口映射正常。再驗證掛載docker run --rm -v ${PWD}:/app alpine ls /appPowerShell 里用${PWD}cmd 里用%cd%Git Bash 里則要注意路徑轉(zhuǎn)換必要時在前面加MSYS_NO_PATHCONV1。這個差異坑過我不止一次同一行命令換個終端就報路徑不存在。4.2 用 compose 起一組服務(wù)才算畢業(yè)單容器跑通只是入門真實項目一般要幾個服務(wù)配合。寫個最簡單的docker-compose.yml起一個 web 加一個 redisservices: web: image: nginx ports: - 8080:80 depends_on: - cache cache: image: redis:7-alpine在當(dāng)前目錄執(zhí)行docker compose up -d注意新版是docker compose中間是空格不是老的docker-compose然后用docker compose ps看狀態(tài)docker compose logs -f看日志。全部 Up 之后再docker compose down收工。這一步的意義在于驗證 Docker 的編排能力和網(wǎng)絡(luò)隔離。compose 會創(chuàng)建一個獨立的 bridge 網(wǎng)絡(luò)兩個容器之間用服務(wù)名互相訪問這也是實際項目里最常見的形態(tài)。如果這一步順了說明你的環(huán)境已經(jīng)能承接日常開發(fā)了。5. 踩坑記錄Windows 上最容易栽的幾個地方5.1 虛擬化沖突模擬器和虛擬機軟件搶資源這條坑我踩得最狠。裝了 Docker Desktop 之后某些安卓模擬器、老版本的虛擬機軟件會啟動失敗反過來它們先占著虛擬化層Docker 也起不來。本質(zhì)原因是 WSL2 和這些軟件都要用同一套虛擬化能力互相不兼容。解決辦法有兩個方向。一是錯峰使用不用模擬器的時候徹底退出不留在托盤里。二是把模擬器換成支持新虛擬化接口的版本或者干脆用手機真機調(diào)試。這事沒有完美的技術(shù)方案只能做取舍。順帶說個排查技巧如果 Docker 突然起不來而前一天還好好的先想想最近裝了什么軟件。任務(wù)管理器里看一眼有沒有可疑的虛擬化進程比一頭扎進日志里翻要快得多。5.2 WSL2 的內(nèi)存與磁盤無聲膨脹WSL2 有個著名的行為內(nèi)存只漲不跌。你編譯一次大項目它把內(nèi)存吃到 8G之后即使空閑也一直占著任務(wù)管理器里那個Vmmem進程能嚇?biāo)廊恕４疟P同理刪掉的鏡像和容器不一定立刻釋放空間虛擬磁盤文件只增不減。內(nèi)存的問題靠.wslconfig解決后面細(xì)講。磁盤的問題有兩個手段一是定期在 Docker 里執(zhí)行docker system prune -a把沒用的鏡像、停止的容器、懸空卷全清掉二是必要時手動壓縮虛擬磁盤文件。wsl --shutdown diskpart # 在 diskpart 里依次執(zhí)行 # select vdisk fileD:\Docker\ext4.vhdx # compact vdisk這個操作要謹(jǐn)慎路徑必須寫準(zhǔn)寫錯了可能傷到別的虛擬磁盤。執(zhí)行之前把 Docker 完全關(guān)掉wsl --shutdown一定要跑。我一般一個季度做一次能把虛擬磁盤從七八十 G 壓回三四十 G。5.3 掛載路徑、文件權(quán)限與換行符跨系統(tǒng)掛載是 Windows 上跑容器的重災(zāi)區(qū)。第一個問題是性能把 Windows 目錄掛進容器文件多了訪問會非常慢前端項目的 node_modules 尤其明顯。我的做法是把代碼放在 WSL 的/home下用 VS Code 的 Remote 功能直接在里面編輯這樣掛載路徑就是 Linux 原生路徑速度正常。第二個問題是權(quán)限。Windows 掛載進去的文件默認(rèn)是 777 或者 root 所屬跑一些對權(quán)限敏感的服務(wù)比如 SSH、某些數(shù)據(jù)庫會直接報錯。可以在 compose 里指定user或者干脆把數(shù)據(jù)卷單獨建一個 volume 而不是 bind mount。第三個是換行符。Windows 的 CRLF 進了 Linux 容器shell 腳本會報bad interpreter: /bin/bash^M。解決辦法是在項目里加.gitattributes強制*.sh text eollf編輯器里把默認(rèn)換行符設(shè)成 LF。這個小問題能讓新人卡一整天因為它報的錯跟真正的原因毫無關(guān)聯(lián)。5.4 端口占用與 localhost 的錯覺-p 8080:80起不來報port is already allocated多半是本機已經(jīng)有程序占了 8080。Windows 上查端口用netstat -ano | findstr :8080拿到 PID 再去任務(wù)管理器里對。有些系統(tǒng)服務(wù)會長期霸占特定端口比如某些版本里 5000 端口被系統(tǒng)占了你就得換個映射。另一個常見錯覺是關(guān)于 localhost。大部分情況下容器跑起來瀏覽器訪問localhost:端口是通的因為 Docker Desktop 做了轉(zhuǎn)發(fā)。但如果 WSL2 那邊網(wǎng)絡(luò)模式改了或者本機裝了某些防火墻這條轉(zhuǎn)發(fā)鏈可能斷掉。這時候可以在 WSL 里用hostname -I拿到虛擬機 IP用那個 IP 訪問試試能通就說明是轉(zhuǎn)發(fā)配置的問題。6. 長期維護讓這套環(huán)境半年后還不卡6.1 用 .wslconfig 給虛擬機劃上限這個是治內(nèi)存膨脹的正方子。在用戶目錄下建一個.wslconfig文件路徑是C:\Users\用戶名\.wslconfig注意文件名前面有個點內(nèi)容大概長這樣[wsl2] memory8GB processors4 swap2GB localhostForwardingtrue改完必須執(zhí)行wsl --shutdown讓它徹底重啟才生效光關(guān) Docker 沒用。這個配置是全局的對所有 WSL 發(fā)行版都起作用。內(nèi)存值建議按物理內(nèi)存的 50% 到 60% 給給太少容器會 OOM給太多 Windows 側(cè)吃緊。有個細(xì)節(jié)值得注意swap 別設(shè)得太大。有些人為了防 OOM 把 swap 設(shè)成 8G結(jié)果磁盤狂轉(zhuǎn)系統(tǒng)卡得像幻燈片還不如讓它老老實實報內(nèi)存不足然后你去調(diào)配置。6.2 定期清理與數(shù)據(jù)備份的正確姿勢清理這塊docker system prune是最常用的但它只清停止的容器、未使用的網(wǎng)絡(luò)和懸空鏡像。要連沒被引用的鏡像一起清得加-a。構(gòu)建緩存單獨用docker builder prune。備份的關(guān)鍵是數(shù)據(jù)卷。命名卷里的數(shù)據(jù)不會因為你刪容器就消失但也容易忘。備份方式起一個臨時容器把卷打包出來docker run --rm -v mydata:/data -v ${PWD}:/backup alpine tar czf /backup/mydata.tar.gz -C /data .鏡像想導(dǎo)出的話用docker save -o app.tar 鏡像名:標(biāo)簽換臺機器docker load -i app.tar就能還原。這套操作在沒有外網(wǎng)的機器之間搬東西特別有用。另外提醒一句別把重要的數(shù)據(jù)庫數(shù)據(jù)只存在容器里。容器本質(zhì)上是一次性的改配置、升級版本時刪掉重建是常態(tài)數(shù)據(jù)必須落在卷或者宿主機目錄上這是底線。6.3 和編輯器、終端的配合方式最后說說日常體驗。VS Code 裝個 Dev Containers 擴展可以直接把項目定義在一個容器里開發(fā)環(huán)境依賴寫進配置文件換臺機器一鍵還原這個對團隊協(xié)作幫助很大。Windows Terminal 里配一個 WSL 的配置文件默認(rèn)打開就是 Linux 終端敲 docker 命令跟原生一樣順。還有個習(xí)慣我保持了挺久把常用的 compose 命令寫成腳本或者 alias比如dcu對應(yīng)docker compose up -ddcl對應(yīng)docker compose logs -f。Windows 上可以寫在 PowerShell 的 profile 里也可以裝個輕量的命令別名工具。這些小優(yōu)化單看沒什么積累下來一天能省不少敲鍵盤的時間。我個人在實際操作中的體會是Windows 上跑 Docker 這件事七分靠前置準(zhǔn)備三分靠后續(xù)維護。裝之前把虛擬化、系統(tǒng)版本、WSL2 內(nèi)核這三關(guān)過了后面基本一路順裝完之后養(yǎng)成定期看docker system df、定期wsl --shutdown的習(xí)慣機器就不會越用越沉。真正難受的場景往往不是技術(shù)本身而是環(huán)境限制——公司電腦沒權(quán)限、老機器開不了虛擬化、C 盤實在騰不出空間這類問題提前想好繞行方案比裝完再返工省心得多。