# 清理 Mac 上的 Docker 而不丟失資料 > 修剪前先檢查映像、容器、建置快取與有狀態 volume，再另行量測稀疏磁碟配置。 Published: 2026-06-26 | Updated: 2026-09-05 Docker Desktop 的映像檔、容器可寫層、建置快取和資料卷都放在 Linux 虛擬磁碟中，很容易佔用幾十 GB。建置快取通常能重建，資料庫卷卻可能是重要資料的唯一副本，因此 Docker 自己的清單比範圍最大的 prune 指令更適合作為起點。 ## 為什麼空間沒有立刻回來 Docker Desktop 在 macOS 上執行 Linux 虛擬機，資料通常保存在疏鬆虛擬磁碟 `Docker.raw` 中。它的 [Mac 儲存空間說明](https://docs.docker.com/desktop/troubleshoot-and-support/faqs/macfaqs/#where-does-docker-desktop-store-linux-containers-and-images)給出了入口：「Docker Desktop > Settings > Resources > Advanced」。這裡能看到位置、上限和實際佔用，也能安全移動虛擬磁碟，直接用 Finder 搬移可能破壞設定。 疏鬆檔案的邏輯上限可能很大，實際配置卻小得多，所以 `ls -lh` 不能代表真實佔用，Docker 內部統計更接近各類物件的實際情況： ``` docker system df -v ``` 詳細檢視會分開列出映像檔、容器、資料卷和建置快取。「Reclaimable」只表示 Docker 沒發現目前參照，並不能判斷之後是否還會用到已停止的容器、舊映像檔或資料卷，`docker ps -a` 和 `docker volume ls` 可以補上這部分背景。 ## 從範圍最小的清理開始 直接刪除虛擬磁碟檔案等同於丟掉整個 Docker 環境，依類別從 Docker 內部回收更容易控制範圍： ``` docker builder prune --filter until=168h docker image prune docker container prune ``` 第一條移除符合篩選條件的七天前未使用建置快取，可依自己的工作週期調整。後兩條會在刪除懸空映像檔和已停止容器前確認。prune 不經過垃圾桶，也無法復原；停止的容器仍可能有唯一的可寫層資料，懸空映像檔也未必能重新取得，確認不再需要或已有可驗證的備份後再繼續。每一步後重新執行 `docker system df -v`，看實際回收了什麼。 Docker 的[清理說明](https://docs.docker.com/engine/manage-resources/pruning/)把 `docker system prune` 定義為範圍更廣的便捷指令。加入 `-a` 會刪除所有未使用的映像檔，不只是懸空層，加入 `--volumes` 還會處理未使用的匿名資料卷，其中可能有資料庫和其他狀態。 `docker system prune -a --volumes` 的範圍很廣，尤其會觸及可能保存資料庫的資料卷。卷名、標籤和歸屬可以先這樣查看： ``` docker volume ls docker volume inspect ``` Compose 資料卷通常帶有專案與服務標籤。確認所屬專案後，優先用資料庫本身的工具匯出資料；做檔案層級備份前先停止寫入，並檢查備份能否還原，再刪除存有不可重建資料的資料卷。 ## 讓虛擬磁碟歸還實體空間 prune 會先在 Linux 檔案系統內部釋放區塊，macOS 不一定同時拿回空間。目前 Docker 文件說明，`Docker.raw` 通常會在數秒內歸還符合條件的區塊，舊式 `Docker.qcow2` 依賴背景行程，可能要幾分鐘。 這裡更有意義的是重新測量實體佔用，而不是看邏輯上限。回復原廠設定也不是壓縮，它會銷毀本機容器、映像檔、資料卷和設定，只適合已經決定丟棄整個環境、並匯出重要資料的情況。 ## Docker.raw 為什麼只增不減 `Docker.raw` 是 Linux 虛擬機的疏鬆磁碟。客體系統寫入時它會增長，刪除物件時則先把客體檔案系統中的區塊標為空閒。只有客體發出 TRIM 或 discard，Docker Desktop 再執行相應回收，macOS 才能拿回符合條件的實體區塊。時間取決於 Docker Desktop 版本和磁碟映像實作。 因此，要分別測量 Docker 內部邏輯空間和 macOS 實體容量。直接刪除 `Docker.raw` 等同於銷毀整個 Docker 環境。
疏鬆 Docker.raw 檔案隨客體虛擬機寫入而增長，並透過 discard 與壓縮把符合條件的區塊歸還給 macOS。
刪除 Docker 物件先釋放虛擬機內部空間，之後才可能把實體空間歸還 macOS。
## 磁碟地圖能幫上什麼 [Mole](https://mole.fit/tw/) 的「分析」頁可以找出虛擬磁碟及其實體佔用，Docker 命令列則負責判斷內部物件的參照關係。前者回答空間在哪裡，後者回答裡面是什麼。 ## 安全的操作順序 一個較容易複核的順序是執行 `docker system df -v`，確認舊專案和有狀態的資料卷，匯出唯一資料，再逐類清理，並在每一步複查 Docker 統計和 macOS 容量。最容易安全回收的通常是舊建置快取，不是身分不明的資料卷。 --- Canonical HTML page: https://mole.fit/tw/blog/how-to-clean-up-docker-mac Blog index for agents: https://mole.fit/tw/blog/llms.txt Site index for agents: https://mole.fit/llms.txt