簡(jiǎn)介Kitematic 0.17.11 是面向 Mac 平臺(tái)的 Docker 圖形化管理工具采用一鍵式安裝方式幫助不熟悉命令行的開(kāi)發(fā)者快速在 Mac 上運(yùn)行 Docker 并管理容器同時(shí)為資深用戶(hù)保留命令行無(wú)縫切換能力。資源包為 zip 壓縮共包含 182 個(gè)文件內(nèi)有 70 個(gè) C 語(yǔ)言頭文件、55 個(gè)資源數(shù)據(jù)文件、Electron 框架組件、二進(jìn)制動(dòng)態(tài)庫(kù)、plist 配置文件、日志及內(nèi)核數(shù)據(jù)文件等整體大小約 56.37MB這些文件覆蓋應(yīng)用運(yùn)行所需的底層依賴(lài)安裝后即可獲得完整的圖形用戶(hù)界面目錄安排也便于按需查看組件。功能方面工具允許在圖形界面直接搜索并拉取 Docker Hub 鏡像快速創(chuàng)建與運(yùn)行應(yīng)用容器自動(dòng)映射主機(jī)端口、直觀修改環(huán)境變量、配置數(shù)據(jù)卷還能一鍵打開(kāi)容器終端、簡(jiǎn)化日志輸出通過(guò)圖形界面即可完成原本需要輸入多行命令的操作同時(shí)支持與 Docker CLI 無(wú)縫切換便于腳本化自動(dòng)化。從適用人群看它既適合初學(xué)者借助可視化方式落地容器技術(shù)也適合日常開(kāi)發(fā)者更高效地管理多個(gè)應(yīng)用容器。當(dāng)前已有 294 人學(xué)習(xí)下載對(duì)于希望降低 Docker 使用門(mén)檻的 Mac 用戶(hù)具有直接實(shí)用價(jià)值。1. Kitematic 0.17.11Mac 上把 Docker 裝進(jìn)圖形窗口的老牌解方Kitematic 0.17.11 是 Docker 官方在 macOS 上做“一鍵式安裝并運(yùn)行 Docker”的初代圖形客戶(hù)端它把 docker-machine、VirtualBox 虛擬機(jī)和 Docker CLI 全部收進(jìn) Kitematic.app 這一個(gè)窗口里用戶(hù)不需要敲 docker run點(diǎn)幾下鼠標(biāo)就能把 Nginx、MySQL、Redis 這類(lèi)常用容器跑起來(lái)。這個(gè)版本在 2018 年之后停止更新但我最近在幾臺(tái)老款 Intel Mac 上做本地開(kāi)發(fā)環(huán)境時(shí)反而把它翻了出來(lái)——原因很直接Docker Desktop 在這些機(jī)器上啟動(dòng)就要吃掉 2GB 左右內(nèi)存而 Kitematic 管理的是一個(gè)由 VirtualBox 承載的輕量 Linux 虛擬機(jī)只在需要時(shí)拉起來(lái)界面直觀、資源占用克制。它特別適合完全不想碰命令行的入門(mén)者也適合在培訓(xùn)或演示環(huán)境里用鼠標(biāo)點(diǎn)給同事看“容器到底是什么”。當(dāng)然它在 macOS 新版本上有不少讓人撓頭的坑下面我把原理、安裝步驟和踩坑記錄一次講透。2. Mac 上的 Docker 引擎為什么“住”在虛擬機(jī)里Kitematic 的選型邏輯2.1 macOS 原生跑不了容器這一條決定了 Kitematic 的所有設(shè)計(jì)Docker 的底層是 Linux 內(nèi)核的 namespaces 和 cgroups前者隔離進(jìn)程、網(wǎng)絡(luò)、掛載點(diǎn)等視圖后者限制 CPU、內(nèi)存和 IO。macOS 的 Darwin 內(nèi)核雖然也是 Unix 系但沒(méi)有這兩套機(jī)制所以在 Mac 上跑 Docker 容器必須先在本地運(yùn)行一個(gè) Linux 虛擬機(jī)再由虛擬機(jī)里的 Docker daemon 承載容器。這是所有 Mac 版 Docker 方案繞不開(kāi)的底層現(xiàn)實(shí)。Kitematic 0.17.11 選擇的承載者是 VirtualBox。它沒(méi)有像后來(lái)的 Docker Desktop 那樣直接使用 macOS 的 Hypervisor.framework而是繼承了 Docker Toolbox 時(shí)代的老思路用 docker-machine 創(chuàng)建一個(gè)名為 default 的 VirtualBox 虛擬機(jī)虛擬機(jī)里跑一個(gè)裁剪過(guò)的 Linux 發(fā)行版boot2docker基于 Tiny Core Linux里面只預(yù)裝 Docker daemon。Kitematic 主界面連接的就是這個(gè)虛擬機(jī)里的 daemon?！耙绘I式安裝”這個(gè)說(shuō)法的本質(zhì)是把以下五個(gè)動(dòng)作打包成一次自動(dòng)流程檢查本機(jī)是否已安裝 VirtualBox 和 docker-machine檢查是否存在名為 default 的虛擬機(jī)不存在則調(diào)用 VBoxManage 創(chuàng)建虛擬機(jī)分配內(nèi)存、CPU、磁盤(pán)并掛載 boot2docker ISO 啟動(dòng)等待 VM 內(nèi) Docker daemon 就緒Kitematic 客戶(hù)端默認(rèn)通過(guò) tcp://192.168.99.100:2375 連接 daemon然后羅列鏡像和容器。我一開(kāi)始以為 Kitematic 是個(gè)簡(jiǎn)單的“容器管理工具”后來(lái)看日志才明白它同時(shí)承擔(dān)了“Docker 引擎托管器”的角色。窗口里點(diǎn)擊重置、重啟重啟的是 VirtualBox 里那臺(tái) Linux VM而不只是某個(gè)容器進(jìn)程。這個(gè)區(qū)分非常重要因?yàn)橛龅蕉丝诓煌ā⑷萜飨?、pull 很慢等故障時(shí)排查范圍直接決定了效率。2.2 Kitematic 0.17.11 的組件拆解我習(xí)慣把 Kitematic 0.17.11 理解成“三件套的圖形外殼”Kitematic.app 只是最外面那一層真正的干活組件是 docker-machine、VirtualBox 和 Docker CLI。下面的表列清了哪些文件需要安裝時(shí)單獨(dú)準(zhǔn)備組件角色是否包含在 Kitematic zip 內(nèi)Kitematic.app圖形客戶(hù)端包含核心主程序docker-machine創(chuàng)建和管理 default 虛擬機(jī)不打包通常隨 Docker Toolbox 提供Docker CLI命令行客戶(hù)端GUI 背后依賴(lài)它下發(fā)指令不打包需自行準(zhǔn)備VirtualBox虛擬機(jī)承載層不包含必須提前安裝boot2docker ISO虛擬機(jī)鏡像內(nèi)部運(yùn)行 Docker daemon不包含首次創(chuàng)建 VM 時(shí)自動(dòng)下載實(shí)際部署時(shí)很多人只拿到了 Kitematic-0.17.11-Mac.zip 這個(gè)獨(dú)立包說(shuō)明下載方已經(jīng)假定 VirtualBox 和 Docker CLI 由使用者自己搞定。我的做法是不裝完整的 Docker Toolbox因?yàn)?Toolbox 攜帶的 docker-machine、docker-compose 版本非常舊后面升級(jí)麻煩只裝 VirtualBox再單獨(dú)準(zhǔn)備一份較新的 Docker CLI 二進(jìn)制放到 /usr/local/bin。這樣既能滿(mǎn)足 Kitematic 的依賴(lài)又保留了命令行的更新自由度。2.3 為什么 Kitematic 比 Docker Desktop 輕Docker Desktop for Mac 走的是 Apple Virtualization.framework 或 HyperKit 這類(lèi)輕虛擬化框架內(nèi)核更貼近 macOS用戶(hù)態(tài)更流暢但它額外集成了 Kubernetes、構(gòu)建擴(kuò)展、登錄認(rèn)證、自動(dòng)更新等模塊安裝包超過(guò) 1GB常駐進(jìn)程多啟動(dòng)后內(nèi)存占用明顯。Kitematic 0.17.11 只是一個(gè)瘦客戶(hù)端Docker daemon 運(yùn)行在 VirtualBox VM 中VM 的資源配額由用戶(hù)自行控制默認(rèn)只分配 2GB 內(nèi)存。在 4GB 內(nèi)存的老 Mac 上這種“按需啟動(dòng)虛擬機(jī)”的方式要比 Docker Desktop 的常駐方案現(xiàn)實(shí)得多。缺點(diǎn)是容器與宿主機(jī)的文件交互、端口轉(zhuǎn)發(fā)都依賴(lài) VirtualBox性能和兼容性都比較“有年代感”。2.4 與 Docker Desktop 的對(duì)比選型清單我沒(méi)法斷言“Kitematic 一定比 Docker Desktop 好”因?yàn)閮烧吒揪筒皇峭淮a(chǎn)品。下面這張表是我根據(jù)實(shí)際使用體驗(yàn)整理出的判斷依據(jù)對(duì)比項(xiàng)目Kitematic 0.17.11Docker Desktop for Mac虛擬化承載VirtualBox 5.x/6.xApple Virtualization / HyperKit安裝體積僅 GUI 很小仍需 VirtualBox安裝包約 1GB附加組件多對(duì)老 macOS 的支持支持 macOS 10.10 及以上新版本要求 macOS 11容器編排無(wú) Kubernetescompose 支持有限內(nèi)置 Kubernetes 與 Compose資源占用僅 VM 開(kāi)機(jī)時(shí)占用可手動(dòng)限制內(nèi)存常駐進(jìn)程多內(nèi)存占用高更新頻率2018 年停止維護(hù)持續(xù)迭代結(jié)論是新 Mac 上我不會(huì)推薦 Kitematic但如果你手頭是一臺(tái) 2015 年前后的 Intel Mac且只做本地開(kāi)發(fā)驗(yàn)證Kitematic 0.17.11 依然是一個(gè)值得留著的“輕量應(yīng)急方案”。3. 安裝與首跑從 Kitematic-0.17.11-Mac.zip 到第一個(gè)容器3.1 安裝前先檢查硬件虛擬化VirtualBox 要運(yùn)行 boot2dockerCPU 必須支持并啟用 VT-xIntel 平臺(tái)。2012 年以后的 Mac 默認(rèn)開(kāi)啟但某些老機(jī)器可能在固件層面被關(guān)掉。我會(huì)先跑兩條命令確認(rèn)# 查看 macOS 是否支持 Hypervisor.framework返回 1 表示支持 sysctl kern.hv_support # 查看 CPU 型號(hào)判斷是否具備虛擬化擴(kuò)展 sysctl -n machdep.cpu.brand_string如果 kern.hv_support 返回 0VirtualBox 仍然可以運(yùn)行但只能走軟件虛擬化性能斷崖式下跌。此時(shí)需要進(jìn)入 macOS 恢復(fù)模式或使用啟動(dòng)鍵進(jìn)入 EFI 設(shè)置確認(rèn)固件里 VMX/VT-x 被啟用。這一步檢查花不到一分鐘能避免后續(xù)創(chuàng)建 VM 時(shí)一直卡在 VirtualBox 報(bào)錯(cuò)“VT-x is not available”這種黑匣子問(wèn)題。3.2 解壓安裝把 Kitematic.app 放入應(yīng)用程序目錄Kitematic 0.17.11 的安裝過(guò)程并不需要 dmg 掛載或安裝器本質(zhì)上就是解壓。建議用命令行解壓方便觀察歸檔內(nèi)部?jī)?nèi)容也方便確認(rèn)文件完整性# 解壓到當(dāng)前目錄 unzip Kitematic-0.17.11-Mac.zip # 把應(yīng)用放進(jìn) /Applications mv Kitematic.app /Applications/解壓得到的 Kitematic.app 內(nèi)部帶有與 0.17.11 版本匹配的 docker 相關(guān)組件但路徑隱藏在 Contents 目錄下不適合直接暴露給系統(tǒng)命令行。移動(dòng)完成后從 Launchpad 或 Finder 雙擊打開(kāi)macOS 首次運(yùn)行會(huì)彈出“來(lái)自互聯(lián)網(wǎng)的 App”警告。此時(shí)右鍵點(diǎn)擊圖標(biāo)選擇“打開(kāi)”即可不需要修改安全策略。3.3 首次啟動(dòng)自動(dòng)創(chuàng)建 default 虛擬機(jī)打開(kāi) Kitematic 后如果本機(jī)不存在 default 虛擬機(jī)程序會(huì)自動(dòng)觸發(fā) docker-machine create 流程。這一步在我的 2015 款 Intel i5 Mac 上大約需要 3 到 5 分鐘最耗時(shí)的是下載 boot2docker ISO。當(dāng)窗口左下角出現(xiàn) Docker Hub 搜索區(qū)域并且容器列表區(qū)域不再轉(zhuǎn)圈說(shuō)明 daemon 已就緒。如果公司網(wǎng)絡(luò)限制了 GitHub 下載界面會(huì)一直停在“Downloading Docker ISO”。這種情況我一般不干等而是手動(dòng)下載 boot2docker.iso 后用 VBoxManage 給 VM 掛載VBoxManage storageattach default \ --storagectl SATA \ --port 0 \ --device 0 \ --type dvddrive \ --medium $HOME/Downloads/boot2docker.iso docker-machine restart default docker-machine regenerate-certs default回到 Kitematic 窗口程序檢測(cè)到 default 虛擬機(jī)已存在會(huì)自動(dòng)跳過(guò)創(chuàng)建步驟進(jìn)入連接狀態(tài)。注意這里的 storageattach 命令不要照抄如果你的 VM 存儲(chǔ)控制器的名稱(chēng)不是 SATA先用 VBoxManage showvminfo default 查看實(shí)際名稱(chēng)再替換。3.4 偏好設(shè)置內(nèi)存、CPU 與鏡像加速Kitematic 右上角 Preferences 里有幾個(gè)關(guān)鍵參數(shù)對(duì)應(yīng) VirtualBox VM 的資源配額。我在這臺(tái)老 Mac 上的做法是CPU 核數(shù)設(shè)置為 2不讓 VM 和宿主機(jī)搶核心內(nèi)存設(shè)為 2048 MB跑 MySQL 和 Redis 單容器足夠Registry Mirror 填入公司內(nèi)網(wǎng)鏡像倉(cāng)庫(kù)地址或公共鏡像加速地址如果有。Kitematic 會(huì)把配置寫(xiě)入 VM 內(nèi) daemon 的參數(shù)中并觸發(fā) reload約 10 秒后生效。需要注意模塊里的內(nèi)存、CPU 修改實(shí)際是通過(guò) VBoxManage modifyvm 執(zhí)行必須重啟 VM 才生效。我習(xí)慣改完內(nèi)存后用 docker-machine ls 驗(yàn)證看 MEMORY 列是否變成預(yù)期值docker-machine ls3.5 首次拉取并運(yùn)行 Nginx 容器Kitematic 的 Docker Hub 頁(yè)面自帶搜索框輸入 nginx選中官方鏡像右側(cè)創(chuàng)建表單出現(xiàn)容器名和端口配置。默認(rèn) Hub 頁(yè)會(huì)把容器端口 80 映射到宿主機(jī) 1080 之類(lèi)的隨機(jī)端口我手動(dòng)改為 8080然后點(diǎn) Create。背后等效執(zhí)行的命令大致是docker run -d -p 8080:80 --name my-nginx nginx:latest點(diǎn) Create 后Kitematic 容器列表出現(xiàn) my-nginx狀態(tài)運(yùn)行瀏覽器訪(fǎng)問(wèn) VM IP 加端口即可看到 Nginx 默認(rèn)頁(yè)。這里有一個(gè)容易誤導(dǎo)的地方Kitematic 界面顯示的訪(fǎng)問(wèn)地址可能是 localhost:8080但在 VirtualBox NAT 端口轉(zhuǎn)發(fā)尚未完全配置好的情況下更可靠的是使用 VM 的 IPdocker-machine ip default通常是 192.168.99.100瀏覽器訪(fǎng)問(wèn) http://192.168.99.100:8080。如果這個(gè)地址能打開(kāi) Nginx 頁(yè)面說(shuō)明整個(gè)“GUI → daemon → 容器 → 端口轉(zhuǎn)發(fā)”鏈路已經(jīng)打通。4. 日常操作鏡像、容器、端口與日志的管理路徑Kitematic 的 GUI 把容器操作壓縮成了四個(gè)高頻動(dòng)作搜索鏡像、創(chuàng)建容器、看日志、進(jìn)終端。我在這臺(tái) Mac 上連續(xù)用了一周把所有日常操作都映射到對(duì)應(yīng)位置歸納如下。4.1 鏡像管理的正確姿勢(shì)在 Kitematic 的 Docker Hub 頁(yè)面搜索鏡像選中后點(diǎn) Create就會(huì)自動(dòng)拉取并啟動(dòng)容器。但鏡像管理還有幾個(gè)隱藏入口鏡像列表在左側(cè) “My Repos” 中顯示本機(jī)已 pull 的鏡像刪除鏡像需要先刪除對(duì)應(yīng)容器Kitematic 會(huì)在容器詳情頁(yè)提供刪除鏡像刪除則要在鏡像列表頁(yè)操作手動(dòng) pull 不存在的鏡像時(shí)Kitematic 可能不顯示進(jìn)度只會(huì)在創(chuàng)建容器時(shí)卡住。遇到這種情況我會(huì)切到命令行 docker pull 查看真實(shí)進(jìn)度。# 從命令行手動(dòng)拉取鏡像便于看到分層下載進(jìn)度 docker pull mysql:8.0為什么 GUI 會(huì)卡住因?yàn)?Kitematic 的創(chuàng)建流程會(huì)同時(shí)執(zhí)行“拉鏡像→建容器→起容器”三個(gè)動(dòng)作任何一步?jīng)]有返回界面都不給中間態(tài)。這是 Kitematic 用起來(lái)最隱晦的地方進(jìn)度條不告訴你卡在哪一步只能通過(guò) CLI 交叉驗(yàn)證。4.2 MySQL 容器環(huán)境變量和數(shù)據(jù)卷是關(guān)鍵數(shù)據(jù)庫(kù)容器不像 Nginx 那么簡(jiǎn)單兩條配置容易翻車(chē)root 密碼必須在首次啟動(dòng)前通過(guò)環(huán)境變量注入數(shù)據(jù)目錄必須掛載到宿主機(jī)。Kitematic 創(chuàng)建 mysql:8.0 時(shí)表單會(huì)自動(dòng)識(shí)別鏡像可能需要的環(huán)境變量并渲染出 MYSQL_ROOT_PASSWORD 字段這是一個(gè)很容易被忽視的“帶智能化”的設(shè)計(jì)。我在創(chuàng)建 MySQL 容器時(shí)通常會(huì)做三件事設(shè)置強(qiáng)密碼并勾選記住環(huán)境變量在 Folders 區(qū)域把容器內(nèi) /var/lib/mysql 掛到宿主機(jī) ~/Kitematic/mysql-data 目錄設(shè)置宿主端口 3306并固定使用 VM IP 連接。對(duì)應(yīng)命令行版本是docker run -d --name my-mysql \ -p 3306:3306 \ -v $HOME/Kitematic/mysql-data:/var/lib/mysql \ -e MYSQL_ROOT_PASSWORD你的密碼 \ mysql:8.0注意 Kitematic 的 Folders 掛載路徑默認(rèn)會(huì)寫(xiě)入 VirtualBox 的共享文件夾宿主目錄在 ~/Kitematic 下容器內(nèi)的數(shù)據(jù)實(shí)際寫(xiě)入 VM 磁盤(pán)再通過(guò)共享目錄映射回宿主機(jī)。這個(gè)鏈路容易讓人誤以為數(shù)據(jù)直接在宿主機(jī)一旦 VirtualBox 的共享目錄失效數(shù)據(jù)恢復(fù)會(huì)很費(fèi)勁。所以重要數(shù)據(jù)我還會(huì)額外用 mysqldump 做備份。4.3 端口映射、網(wǎng)絡(luò)與 VM IPKitematic 的容器詳情頁(yè)有 Ports 配置能看到容器端口和宿主機(jī)端口的對(duì)應(yīng)關(guān)系。我建議把宿主端口統(tǒng)一使用高位端口比如 13306、18080避免和本機(jī)已有進(jìn)程沖突。當(dāng) GUI 提示 “port is already allocated”不要?dú)e的進(jìn)程直接改端口重試# 查詢(xún) VM 當(dāng)前 IP用于訪(fǎng)問(wèn)容器服務(wù) docker-machine ip default另一個(gè)常見(jiàn)問(wèn)題容器之間互相訪(fǎng)問(wèn)。VirtualBox VM 默認(rèn)使用 host-only 網(wǎng)絡(luò)容器之間的網(wǎng)絡(luò)橋接由 VM 內(nèi)的 Docker bridge 承擔(dān)。Kitematic 不提供可視化網(wǎng)絡(luò)管理容器互聯(lián)需要通過(guò)共享 network 實(shí)現(xiàn)這屬于 CLI 能力我在第 6 章會(huì)講到怎么配合 GUI 使用。網(wǎng)絡(luò)不同時(shí)最常見(jiàn)的現(xiàn)象是容器 A 用 localhost 訪(fǎng)問(wèn)容器 B這是 Mac 宿主機(jī)視角容器視角的 IP 要查容器的實(shí)際地址docker inspect -f {{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}} my-mysql4.4 日志、終端與文件查看Kitematic 對(duì)每個(gè)容器提供三個(gè)快捷按鈕Logs 實(shí)時(shí)顯示 stdout/stderrTerminal 進(jìn)入容器 shellFiles 瀏覽容器文件系統(tǒng)。Logs 里最值得關(guān)注的是 MySQL 首次啟動(dòng)日志初始化時(shí)會(huì)在日志中打印 root 臨時(shí)密碼[Entrypoint] GENERATED ROOT PASSWORD: xxxxx如果你的 MYSQL_ROOT_PASSWORD 環(huán)境變量沒(méi)有設(shè)置成功這條日志是找回密碼的唯一線(xiàn)索。Terminal 按鈕等效于 docker exec -it 容器名 /bin/shFiles 按鈕則相當(dāng)于把容器文件系統(tǒng)可視化出來(lái)適合看 /etc/nginx/conf.d 這類(lèi)配置文件。這三個(gè)入口排布在容器詳情頁(yè)頂部是 Kitematic 相比命令行的優(yōu)勢(shì)不用記 exec 參數(shù)點(diǎn)按鈕即可。5. Kitematic 在 Mac 上的五個(gè)典型坑與排查路徑5.1 創(chuàng)建 VM 卡在 Downloading Docker ISO現(xiàn)象首次啟動(dòng) Kitematic界面長(zhǎng)時(shí)間停在 Downloading Docker ISO進(jìn)度條不推進(jìn)。原因boot2docker 鏡像托管在 GitHub Release 上公司網(wǎng)絡(luò)或校園網(wǎng)攔截了該域名也可能是 Kitematic 自動(dòng)下載時(shí)鏈路中斷程序沒(méi)有重試機(jī)制。解決手動(dòng)下載 boot2docker ISO用 VBoxManage 替換虛擬機(jī)的 ISO 光驅(qū)掛載再重啟 VMVBoxManage storageattach default \ --storagectl SATA \ --port 0 \ --device 0 \ --type dvddrive \ --medium $HOME/Downloads/boot2docker.iso docker-machine restart default docker-machine regenerate-certs default之后回到 Kitematic它發(fā)現(xiàn) VM 已存在會(huì)直接進(jìn)入連接階段不再?lài)L試下載。5.2 與 Docker Desktop 互相沖突現(xiàn)象安裝了 Docker Desktop 的 Mac 上再打開(kāi) Kitematic窗口一直轉(zhuǎn)圈或者出現(xiàn) Error creating machine: exit status 1。原因Docker Desktop 使用的虛擬化框架和 VirtualBox 同時(shí)搶占硬件虛擬化資源兩個(gè) hypervisor 不能同時(shí)正常運(yùn)轉(zhuǎn)。Kitematic 連接的是 VirtualBox 里的 VM而 Docker Desktop 常駐后臺(tái)導(dǎo)致 VM 無(wú)法正常創(chuàng)建。解決兩者二選一。用 Kitematic 時(shí)徹底退出 Docker Desktop并確認(rèn)后臺(tái)進(jìn)程已經(jīng)結(jié)束# 查看 Docker Desktop 后臺(tái)殘留進(jìn)程 ps aux | grep com.docker.backend # 徹底退出 Docker Desktop osascript -e quit app Docker如果長(zhǎng)期用 Kitematic建議卸載 Docker Desktop反之則移除 VirtualBox避免沖突復(fù)發(fā)。5.3 系統(tǒng) Terminal 里 docker 命令找不到現(xiàn)象Kitematic 內(nèi)能創(chuàng)建容器但打開(kāi) macOS Terminal 執(zhí)行 docker ps 提示 command not found。原因Kitematic 自帶的 Docker CLI 路徑只在它的 App 環(huán)境內(nèi)有效沒(méi)有寫(xiě)入系統(tǒng) PATH也可能這臺(tái)機(jī)器從未安裝獨(dú)立的 Docker CLI。解決把 Docker CLI 放進(jìn) /usr/local/bin# 找到 Kitematic 內(nèi)置的 docker 客戶(hù)端 find /Applications/Kitematic.app -name docker -type f # 復(fù)制到系統(tǒng)命令目錄 sudo cp /Applications/Kitematic.app/Contents/Resources/docker /usr/local/bin/這里要提醒Kitematic 內(nèi)置 docker 客戶(hù)端版本較舊如果后續(xù)容器鏡像用到比較新的 API 特性建議從 Docker 官方獲取較新 CLI 二進(jìn)制替換。避免用舊客戶(hù)端操作新 daemon 時(shí)出現(xiàn)低價(jià) API 版本不兼容。5.4 MySQL 容器被刪后數(shù)據(jù)消失現(xiàn)象mysql:8.0 容器刪除后重新創(chuàng)建之前建立的庫(kù)和表全沒(méi)了。原因容器層是可寫(xiě)臨時(shí)層容器刪除即銷(xiāo)毀沒(méi)有把 /var/lib/mysql 掛載到宿主機(jī)目錄。Kitematic 的 Folders 綁定只在創(chuàng)建容器時(shí)提供創(chuàng)建完成后補(bǔ)綁卷比較麻煩容易讓人誤以為容器天然持久化。解決如果容器還在運(yùn)行先停止并 commit 成新鏡像再用新鏡像建立帶卷容器docker stop my-mysql docker commit my-mysql my-mysql-bak:latest # 掛載卷后重建容器 docker run -d -p 3306:3306 \ -v $HOME/Kitematic/mysql-data:/var/lib/mysql \ -e MYSQL_ROOT_PASSWORD你的密碼 \ my-mysql-bak:latest這份代碼里的 commit 會(huì)把當(dāng)前容量作為新鏡像保存但 volume 數(shù)據(jù)不在鏡像層內(nèi)如果 commit 前 /var/lib/mysql 沒(méi)掛宿主機(jī)則 container 內(nèi)的數(shù)據(jù)仍然可能在刪除后丟失。最可靠的做法是從一開(kāi)始就綁卷而不是事后搶救。5.5 鏡像加速地址不生效現(xiàn)象在 Kitematic Preferences 中填了鏡像加速地址docker pull 依然從 Docker Hub 直接拉取速度很慢。原因加速地址寫(xiě)入的是 VM 內(nèi) Docker daemon 的啟動(dòng)參數(shù)但如果 boot2docker 的 init 腳本沒(méi)有重讀配置daemon 不會(huì)自動(dòng)加載新的 --registry-mirror。解決改完 Preferences 后手動(dòng)重啟 VM 內(nèi) Docker 服務(wù)docker-machine ssh default sudo /etc/init.d/docker restart如果配置還是無(wú)效檢查 daemon 實(shí)際啟動(dòng)參數(shù)docker-machine ssh default ps aux | grep dockerd看到?jīng)]有 --registry-mirror 參數(shù)時(shí)就只能用命令把配置寫(xiě)到 boot2docker 的 profile 文件后重啟虛擬機(jī)docker-machine ssh default echo EXTRA_ARGS--registry-mirror你的鏡像加速地址 | sudo tee -a /var/lib/boot2docker/profile然后 docker-machine restart default。這類(lèi)配置在 GUI 界面里顯示為已寫(xiě)入但底層生效與否完全取決于 daemon 是否重讀配置不能只看界面靜態(tài)展示。6. 進(jìn)階用法讓 Kitematic 的 VM 同時(shí)接受 CLI 與 Compose再遷移到新工具6.1 用 CLI 補(bǔ)足 GUI 的信息盲區(qū)Kitematic 的圖形界面能顯示容器運(yùn)行狀態(tài)、日志和端口但容器重啟次數(shù)、健康檢查狀態(tài)、掛載詳情、環(huán)境變量具體值這些信息它在界面上不展示。我在日常調(diào)試時(shí)會(huì)讓 Terminal 直接接管這個(gè) VM# 讓 shell 環(huán)境指向 Kitematic 管理的 default VM eval $(docker-machine env default) # 查看完整容器狀態(tài)和重啟次數(shù) docker ps -a # 檢查容器掛載與網(wǎng)絡(luò)配置 docker inspect my-nginxeval 只需要一次之后的 docker pull、docker run、docker logs 都會(huì)作用在 Kitematic 創(chuàng)建的 VirtualBox VM 上。GUI 用來(lái)看全局CLI 用來(lái)鉆細(xì)節(jié)兩者連的是同一個(gè) daemon不會(huì)出現(xiàn)“GUI 一個(gè)世界、CLI 另一個(gè)世界”的割裂。這個(gè)配合讓我在這臺(tái)老 Mac 上不再盲改參數(shù)、反復(fù)點(diǎn)重啟效率提升非常明顯。6.2 用 docker-compose 編排多容器用 Kitematic 看狀態(tài)Kitematic 本身不支持 docker-compose 編排但因?yàn)樗B接的是標(biāo)準(zhǔn) Docker daemonCLI 能做的事它底層也能做。我處理多容器項(xiàng)目時(shí)會(huì)在項(xiàng)目目錄放一個(gè) docker-compose.ymlversion: 3 services: web: image: nginx:latest ports: - 8080:80 db: image: mysql:8.0 environment: MYSQL_ROOT_PASSWORD: example volumes: - /Users/yourname/Kitematic/compose-mysql:/var/lib/mysql然后使用 docker-compose 啟動(dòng)docker-compose up -d這里有一個(gè)很值得注意的點(diǎn)compose 文件里如果寫(xiě)相對(duì)路徑./mysql-datadaemon 會(huì)把路徑解析在 VM 內(nèi)部而 VM 中并不存在這個(gè)目錄最終導(dǎo)致掛載到空目錄。用 Kitematic 承載 daemon 時(shí)卷的絕對(duì)路徑應(yīng)該指向宿主機(jī)路徑并且保證該路徑在 VM 啟動(dòng)前已經(jīng)存在。這個(gè)“路徑在宿主機(jī)還是在 VM 內(nèi)”的區(qū)分是很多人在 Mac 上第一次用 compose 時(shí)翻車(chē)的地方。6.3 驗(yàn)證工具一條命令判斷 Docker 環(huán)境是否健康無(wú)論用 Kitematic 還是 Docker Desktop我都會(huì)在切換工具后先跑一段最小自檢。保存為 docker-check.sh#!/bin/bash set -e docker info /dev/null 21 || { echo docker daemon 未連接; exit 1; } docker run --rm hello-world echo 容器啟動(dòng)成功這段腳本驗(yàn)證兩條鏈路docker info 判斷 daemon 是否可連接hello-world 容器驗(yàn)證能夠拉取鏡像并成功創(chuàng)建運(yùn)行容器。如果 Kitematic 在界面上表現(xiàn)異常腳本能直接告訴你到底是 daemon 沒(méi)起來(lái)還是鏡像拉取環(huán)節(jié)出問(wèn)題省去很多盲猜。6.4 清理與維護(hù)給 VM 留出呼吸空間Kitematic 用久了VirtualBox VM 的磁盤(pán)會(huì)越來(lái)越大因?yàn)殓R像、容器層、日志都堆積在 VM 內(nèi)。我平時(shí)會(huì)做兩層清理# 刪除所有停止的容器和無(wú)主鏡像保留正在運(yùn)行的 docker system prune -f # 查看 VM 磁盤(pán)占用 docker-machine ssh default df -h /var/lib/docker如果 df 顯示磁盤(pán)使用率超過(guò) 80%我會(huì)在 VirtualBox 里備份 VM 后重置磁盤(pán)。Kitematic 0.17.11 的 GUI 不提供鏡像清理快捷鍵但在它背后跑 CLI 完全可行。從那以后我每次切到一臺(tái)新 Mac都強(qiáng)制自己先把 docker-check.sh 放進(jìn)項(xiàng)目根目錄跑一遍再?zèng)Q定用 GUI 還是直接上 CLI。圖形界面再友好也只負(fù)責(zé)“看著順眼”真正判斷環(huán)境健康的還得是這條從 docker info 到 hello-world 的鏈路。這套“GUI 觀察 CLI 驗(yàn)證 腳本兜底”的習(xí)慣幫我少踩了很多環(huán)境類(lèi)的玄學(xué)坑希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取