Apple Silicon 雲 Mac Docker 生產排障：arm64/amd64、bind mount 與構建快取

本文要點

以 docker buildx imagetools inspect 與顯式 --platform 固定「拉什麼、跑什麼」，避免 silent amd64。
bind mount 在 macOS 上與 Linux 不同：留意宿主機路徑、預設使用者與大量小檔案的 I/O 特徵。
BuildKit 快取與懸空鏡像會擠佔套餐內 SSD；把清理寫進值班 Runbook，並預留系統與日誌空間。
與 CI／Runner 併發與快取策略一併審視時，請把記憶體尖峰與磁碟預算列在同一份檢核表。

筆記型電腦與程式開發環境示意，象徵雲端構建與容器化工作流 — 封面為氛圍示意；排障請以實際 `docker info`、鏡像 manifest 與磁碟用量為準。

1. 架構：arm64 預設與 amd64 混用

Apple Silicon 上 Docker Desktop（或相容執行時）拉取未標註平台的鏡像時，往往優先解析到 arm64 變體；若 Dockerfile 或 Helm 值裡仍寫 FROM --platform=linux/amd64，或第三方只發佈 amd64，就會在執行期遇到 exec format error 或 QEMU 模擬下的效能懸崖。生產建議：在 CI 與 compose 裡寫死平台三元組（例如 linux/arm64），並對上游鏡像做 manifest 校驗；需要 x86 依賴時，明確是否接受模擬、抑或改為多階段構建在 arm64 上原生編譯。

與流水線選型一併討論時，建議把「併發上限、佇列尾延遲與本機 I/O」與 Docker 資源規劃放在同一套財務語言裡審視；繁體站內若後續補上 Runner 對照文，可再從列表頁互連補強內鏈。

2. bind mount：路徑、權限與 I/O

把宿主機目錄掛進容器時，常見坑有三類：路徑不存在或相對路徑在 systemd／launchd 下解析錯；容器內 uid／gid 與宿主機檔案屬主不一致導致唯讀或間歇寫失敗；海量小檔案（前端 node_modules、語言伺服器索引）經綁定掛載放大 I/O，拖垮互動式開發體驗。雲上長期跑服務時，把「必須可 grep 的日誌卷」與「可丟的臨時構建目錄」分開掛載，並在變更單裡寫清宿主機絕對路徑，能顯著減少責任不清的往返。

3. 構建快取與套餐磁碟邊界

BuildKit 層快取、docker builder prune 之前的懸空 build 快取，以及多架構並行構建，都會佔用本機 SSD。kvmboot 公開套餐中，入門款為 16 GB 統一記憶體 + 256 GB SSD，高配為 24 GB + 512 GB（詳見套餐與規格）。經驗上：鏡像與快取建議控制在「系統 + 應用 + 兩週捲動日誌」之後仍餘下約 15%–20% 閒置空間，避免 Docker 在磁碟將滿時出現怪異逾時。把 docker system df -v 與宿主機磁碟告警接到同一值班頻道，比單純限制容器記憶體更有效。

# 生產巡檢範例（在宿主機執行）
docker buildx du
docker system df
df -h /

4. 症狀—根因—動作（速查）

症狀	高機率根因	首選動作
`exec format error`	鏡像／二進位架構與宿主不一致	檢查 manifest；compose 寫 `platform:`；避免無意混用 amd64 底包
掛載目錄空或權限 denied	路徑、屬主或命名卷未初始化	核對宿主機路徑與 uid；必要時以命名卷承載狀態資料
構建越來越慢、磁碟告警	快取膨脹、舊鏡像未回收	`docker builder prune` + 鏡像 tag 治理；大快取遷外置碟策略（若合約允許）

5. 結語

在雲 Mac 上把 Docker 當「小 Linux」用會吃虧：要把 平台、掛載語意與磁碟預算寫進同一頁 Runbook，並與套餐的記憶體／SSD 檔位對齊預期。做完架構與快取策略後，再用一次全量構建驗收「冷啟動時間 + 尖峰記憶體」，比事後擴容更省成本。