簡(jiǎn)介Kitematic 0.17.11 是面向 Mac 平臺(tái)的 Docker 圖形化管理工具采用一鍵式安裝方式幫助不熟悉命令行的開(kāi)發(fā)者快速在 Mac 上運(yùn)行 Docker 并管理容器同時(shí)為資深用戶保留命令行無(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)行所需的底層依賴安裝后即可獲得完整的圖形用戶界面目錄安排也便于按需查看組件。功能方面工具允許在圖形界面直接搜索并拉取 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 用戶具有直接實(shí)用價(jià)值。1. Kitematic 0.17.11Mac 上把 Docker 裝進(jìn)圖形窗口的老牌解方Kitematic 0.17.11 是 Docker 官方在 macOS 上做“一鍵式安裝并運(yùn)行 Docker”的初代圖形客戶端它把 docker-machine、VirtualBox 虛擬機(jī)和 Docker CLI 全部收進(jìn) Kitematic.app 這一個(gè)窗口里用戶不需要敲 docker run點(diǎn)幾下鼠標(biāo)就能把 Nginx、MySQL、Redis 這類常用容器跑起來(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 客戶端默認(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圖形客戶端包含核心主程序docker-machine創(chuàng)建和管理 default 虛擬機(jī)不打包通常隨 Docker Toolbox 提供Docker CLI命令行客戶端GUI 背后依賴它下發(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。這樣既能滿足 Kitematic 的依賴又保留了命令行的更新自由度。2.3 為什么 Kitematic 比 Docker Desktop 輕Docker Desktop for Mac 走的是 Apple Virtualization.framework 或 HyperKit 這類輕虛擬化框架內(nèi)核更貼近 macOS用戶態(tài)更流暢但它額外集成了 Kubernetes、構(gòu)建擴(kuò)展、登錄認(rèn)證、自動(dòng)更新等模塊安裝包超過(guò) 1GB常駐進(jìn)程多啟動(dòng)后內(nèi)存占用明顯。Kitematic 0.17.11 只是一個(gè)瘦客戶端Docker daemon 運(yùn)行在 VirtualBox VM 中VM 的資源配額由用戶自行控制默認(rèn)只分配 2GB 內(nèi)存。在 4GB 內(nèi)存的老 Mac 上這種“按需啟動(dòng)虛擬機(jī)”的方式要比 Docker Desktop 的常駐方案現(xiàn)實(shí)得多。缺點(diǎn)是容器與宿主機(jī)的文件交互、端口轉(zhuǎn)發(fā)都依賴 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ǔ)控制器的名稱不是 SATA先用 VBoxManage showvminfo default 查看實(shí)際名稱再替換。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 之類的隨機(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)行瀏覽器訪問(wèn) VM IP 加端口即可看到 Nginx 默認(rèn)頁(yè)。這里有一個(gè)容易誤導(dǎo)的地方Kitematic 界面顯示的訪問(wèn)地址可能是 localhost:8080但在 VirtualBox NAT 端口轉(zhuǎn)發(fā)尚未完全配置好的情況下更可靠的是使用 VM 的 IPdocker-machine ip default通常是 192.168.99.100瀏覽器訪問(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)單兩條配置容易翻車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)程直接改端口重試# 查詢 VM 當(dāng)前 IP用于訪問(wèn)容器服務(wù) docker-machine ip default另一個(gè)常見(jiàn)問(wèn)題容器之間互相訪問(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 訪問(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è)置成功這條日志是找回密碼的唯一線索。Terminal 按鈕等效于 docker exec -it 容器名 /bin/shFiles 按鈕則相當(dāng)于把容器文件系統(tǒng)可視化出來(lái)適合看 /etc/nginx/conf.d 這類配置文件。這三個(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)入連接階段不再嘗試下載。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 客戶端 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 客戶端版本較舊如果后續(xù)容器鏡像用到比較新的 API 特性建議從 Docker 官方獲取較新 CLI 二進(jìn)制替換。避免用舊客戶端操作新 daemon 時(shí)出現(xiàn)低價(jià) API 版本不兼容。5.4 MySQL 容器被刪后數(shù)據(jù)消失現(xiàn)象mysql:8.0 容器刪除后重新創(chuàng)建之前建立的庫(kù)和表全沒(méi)了。原因容器層是可寫(xiě)臨時(shí)層容器刪除即銷毀沒(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。這類配置在 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í)翻車的地方。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)境類的玄學(xué)坑希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取