2025-04-21-docker desktop Settings Docker Engine

2025-04-21-docker desktop Settings Docker Engine

docker desktop Settings
Docker Engine:

Docker Engine
V28.3.3
Configure the Docker daemon by typing a json Docker daemon configuration file.
!This can prevent Docker from starting. Use at your own risk.

{
  "builder":{
    "gc":{
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
 "experimental" : false
}

很好 👌 你現在看到的是 Docker Engine 設定,這裡直接編輯 Docker Daemon 的 JSON 設定檔。這部分要小心,因為設定錯誤會導致 Docker Desktop 無法啟動。


📄 你現在的設定解讀

1
2
3
4
5
6
7
8
9
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false
}
  1. builder.gc.enabled: true

    • 開啟「建置垃圾回收(Garbage Collection, GC)」功能。
    • Docker 在建置映像時會產生暫存層,這些會占空間。
    • 開啟 GC → 會自動清理不用的暫存層。
  2. builder.gc.defaultKeepStorage: “20GB”

    • 表示 Docker 至少會保留 20GB 的暫存檔空間。
    • 超過這個容量時,Docker 才會開始自動清理。
  3. experimental: false

    • 表示「實驗性功能」沒有開啟。
    • 一般情況建議保持 false(避免不穩定功能)。

🔧 建議你可以做什麼?

  1. 保持現狀(最安全)

    • 現在的設定已經很合理,不需要改。
  2. 如果你 C 槽很容易爆滿

    • 可以把 defaultKeepStorage 改小一點(例如 "10GB"),這樣 Docker 更快清理暫存檔。
    • 但這會讓建置映像時比較常需要重新下載或重建(時間較長)。
  3. 進階可調參數(常用的)

    • registry-mirrors(加速下載映像,特別是在台灣/中國區會很有用):

      1
      2
      3
      {
      "registry-mirrors": ["https://mirror.gcr.io"]
      }

      (也可以換成阿里雲、中國科大等加速器)

    • insecure-registries(如果你要連內網私有 Docker Registry 且沒 SSL):

      1
      2
      3
      {
      "insecure-registries": ["myregistry.local:5000"]
      }
    • data-root(指定 Docker 存放資料的資料夾,如果 C 槽快滿):

      1
      2
      3
      {
      "data-root": "D:\\DockerData"
      }

結論:
你的 JSON 配置很乾淨,現在不用改。
如果將來遇到 空間不足拉映像很慢,再來調整。


要不要我幫你寫一份「建議版 daemon.json」範例,適合一般開發用(有自動清理 + 加速下載),讓你未來可以直接用?

好 👍 我幫你準備一份 **建議版 daemon.json**(Docker Engine 設定),適合一般開發者用,包含:

  • 自動清理建置暫存檔
  • 設定最大暫存空間
  • 加速下載映像(使用官方 mirror,可換成台灣/中國加速器)

📄 建議版 daemon.json

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"builder": {
"gc": {
"enabled": true,
"defaultKeepStorage": "10GB"
}
},
"experimental": false,
"registry-mirrors": [
"https://mirror.gcr.io"
],
"features": {
"buildkit": true
}
}

⚙️ 設定說明

  1. builder.gc.enabled: true

    • 開啟建置垃圾回收,避免磁碟爆滿。
  2. builder.gc.defaultKeepStorage: “10GB”

    • 限制暫存最多 10GB。
    • 你 C 槽不大(常見情況),建議比預設 20GB 再小一些。
  3. experimental: false

    • 關閉實驗性功能(穩定為主)。
  4. registry-mirrors

    • 加速拉取 Docker Hub 的映像。
    • 這裡用 Google 提供的全球加速器 https://mirror.gcr.io
    • 如果速度還是慢,可以改成阿里雲 / DaoCloud / 中科大等中國區鏡像(需要帳號或 URL)。
  5. features.buildkit: true

    • 啟用 BuildKit,Docker 官方新一代建置引擎。
    • 優點:建置快、支援 cache、輸出更漂亮。

🚀 套用方法

  1. 在 Docker Desktop → Settings → Docker Engine 裡,貼上這份 JSON(取代原本的)。

  2. Apply & Restart

  3. 測試是否成功:

    1
    docker info

    會看到 Registry MirrorsBuildKit 設定。


要不要我幫你列幾個 常見中國/台灣的 Docker Hub 加速器鏡像網址,讓你可以替換 registry-mirrors,下載速度更快?