已淘汰的 Docker Engine 功能

此頁面概述了 Engine 中已淘汰的功能。 不包含包裝和支援的 (Linux) 發行版本的變更。 若要瞭解 Linux 發行版本的支援終止，請參閱版本資訊。

功能淘汰政策

隨著 Docker 的變更，有時可能需要移除現有功能或以新功能取代。 在移除現有功能之前，它會在文件中標示為「已淘汰」，並至少會在一個穩定版本中保留，除非另有明確說明。 之後可能會將其移除。

使用者應注意每個版本的已淘汰功能清單，並盡快規劃從這些功能遷移，以及（如果適用）遷移到替代功能。

已淘汰的引擎功能

下表概述了已淘汰功能的目前狀態

• **已淘汰**: 此功能標示為「已淘汰」，不應再使用。

  此功能可能會在未來的版本中被移除、停用或更改行為。「已棄用」欄位包含該功能被標記為已棄用的版本，而「移除」欄位則包含預計移除該功能的版本。如果「移除」欄位中未包含版本，則表示尚未決定移除的版本。

• 已移除：該功能已被移除、停用或隱藏。

  詳細資訊請參閱連結的章節。某些功能是「軟性」棄用，這表示它們為了向後相容性以及允許使用者遷移到替代方案而仍然保持功能。在這種情況下，可能會顯示警告，使用者不應依賴此功能。

映像檔檢查中的非標準欄位

在 v27.0 版中已棄用 目標移除版本：v28.0

在 docker image inspect 中顯示（以及由 GET /images/{name}/json API 端點返回）的 Config 欄位返回了額外的欄位，這些欄位不屬於映像檔的設定，也不屬於 Docker 映像檔規格 和 OCI 映像檔規格

在 v27.0 版中已棄用 在 v27.0 版中預設停用 目標移除版本：v28.0

Graphdriver 外掛程式 是一個實驗性功能，允許使用自定義儲存驅動程式擴展 Docker 引擎，用於儲存映像檔和容器。此功能自推出以來就沒有維護，並且在未來的版本中將不再支援。

在 v27.0 中，預設停用對 graphdriver 外掛程式的支援，並將在 v28.0 中移除。v27.0 中提供了一個 DOCKERD_DEPRECATED_GRAPHDRIVER_PLUGINS 環境變數來重新啟用此功能。必須在守護行程式的環境中將此環境變數設定為非空值。

DOCKERD_DEPRECATED_GRAPHDRIVER_PLUGINS 環境變數以及對 graphdriver 外掛程式的支援將在 v28.0 中移除。建議此功能的使用者改為將 Docker 引擎設定為使用 containerd 映像檔儲存

在 v27.0 版中已棄用 目標移除版本：v28.0

Docker 守護行程式的 api-cors-header 設定選項不安全，因此已棄用並排定移除。錯誤地設定此選項可能會讓未經身份驗證的跨來源請求被守護行程式接受。

從 Docker Engine v27.0 開始，仍然可以設定此旗標，但除非環境變數 DOCKERD_DEPRECATED_CORS_HEADER 也設定為非空值，否則它沒有作用。

此旗標將在 v28.0 中完全移除。

這對於依賴此選項從瀏覽器存取 Docker API 的授權外掛程式和其他程式來說是一個重大變更。如果您需要透過瀏覽器存取 API，請使用反向代理。

未經驗證的 TCP 連線

在 v26.0 版中已棄用 目標移除版本：v28.0

將 Docker 守護行程式設定為監聽 TCP 位址將需要強制執行 TLS 驗證。此變更旨在透過防止未經授權的使用者透過潛在不安全的網路存取 Docker 守護行程式來確保通訊安全。此強制性 TLS 要求適用於除 tcp://localhost 之外的所有 TCP 位址。

在 27.0 版及更高版本中，如果還將守護行程式設定為接受透過 TCP 的遠端連線，則指定 --tls=false 或 --tlsverify=false CLI 旗標將導致守護行程式無法啟動。這也適用於 daemon.json 中的等效設定選項。

為了方便透過 TCP 遠端存取 Docker 守護行程式，您需要實作 TLS 驗證。這可透過加密傳輸中的資料並提供相互驗證機制來保護連線安全。

對於不需要遠端守護行程存取的環境，我們建議將 Docker 守護行程綁定到 Unix 通訊端。對於需要遠端存取且無法使用 TLS 加密的守護行程，您可以考慮使用 SSH 作為替代方案。

如需更多資訊、協助以及設定 Docker 守護行程 TLS（或 SSH）的步驟說明，請參閱 保護 Docker 守護行程通訊端。

映像檔檢查中的 `Container` 和 `ContainerConfig` 欄位

**已於版本 v25.0 棄用** **預計於版本 v26.0 移除**

由 docker inspect 返回的 Container 和 ContainerConfig 欄位大多是傳統（非 BuildKit）映像檔建構器的實作細節。這些欄位不具可攜性，且在使用基於 BuildKit 的建構器（自 v23.0 起預設啟用）時為空。這些欄位已於 v25.0 棄用，並將從 v26.0 開始省略。如果需要映像檔的設定，您可以從 Config 欄位取得。

淘汰舊版 API

**已於版本 v25.0 棄用** **預計於版本 v26.0 移除**

Docker 守護行程提供版本化的 API，以向後相容舊用戶端。Docker 用戶端可以執行 API 版本協商，以選擇守護行程支援的最新 API 版本（必要時降級到舊版 API）。API 版本協商是在 Docker v1.12.0（API 1.24）中引入的，在此之前的用戶端使用固定的 API 版本。

直到 v25.0 的 Docker Engine 版本都支援所有 API 版本，包含給定平台穩定版本中的所有 API 版本。對於 Linux 上的 Docker 守護行程，最早支援的 API 版本為 1.12（對應 Docker Engine v1.0.0），而對於 Windows 上的 Docker 守護行程，最早支援的 API 版本為 1.24（對應 Docker Engine v1.12.0）。

支援舊版 API 版本（在目前版本的 Docker Engine 上提供舊版 API 版本）主要目的是為了與最新但仍支援的用戶端版本相容，這是一種常見的情況（Docker 守護行程可能會更新到最新版本，但並非所有用戶端都可能已更新，反之亦然）。對於在此之前的 API 版本（由 Docker 守護行程的 EOL 版本提供的 API 版本）的支援，我們將盡力而為。

使用舊版 API 版本的情況很少見，而且支援舊版 API 版本會導致相當大的複雜性（Docker 1.0.0 已於 10 年前發布）。因此，我們將開始棄用對舊版 API 版本的支援。

Docker Engine v25.0 預設會停用早於 1.24 的 API 版本（使 Linux 和 Windows 守護行程之間支援的最低 API 版本一致）。當與使用早於 1.24 的 API 版本的用戶端連線時，守護行程會傳回錯誤。以下範例將 Docker CLI 設定為使用 API 版本 1.23，這會產生錯誤

DOCKER_API_VERSION=1.23 docker version
Error response from daemon: client version 1.23 is too old. Minimum supported API version is 1.24,
upgrade your client to a newer version

引入了一個環境變數 (DOCKER_MIN_API_VERSION)，允許在守護行程中重新啟用舊版 API 版本。此環境變數必須設定在守護行程的環境中（例如，透過 systemd 覆寫檔案），且指定的 API 版本必須受守護行程支援（Linux 上為 1.12 或更高版本，Windows 上為 1.24 或更高版本）。

對低於 1.24 的 API 版本的支援將在 Docker Engine v26 中永久移除，後續版本中支援的最低 API 版本將會逐步提高。

除非在無法更新舊用戶端且必須支援這些用戶端的特殊情況下，否則我們不建議依賴 DOCKER_MIN_API_VERSION 環境變數。

網路別名欄位中的容器簡短 ID

**已於版本 v25.0 棄用** **將於版本 v26.0 移除**

由 docker inspect 返回的 Aliases 欄位在容器啟動後包含容器的簡短 ID。此行為已於 v25.0 棄用，但會保留到下一個版本 v26.0。從該版本開始，Aliases 欄位將僅包含透過 docker container create 和 docker run 旗標 --network-alias 設定的別名。

v25.0 中已引入一個新的欄位 DNSNames，其中包含容器名稱（如果已指定）、主機名稱、網路別名以及容器簡短 ID，應該使用它來代替 Aliases 欄位。

`docker search` 上的 `IsAutomated` 欄位和 `is-automated` 篩選器

**已於版本 v25.0 棄用** **預計於版本 v26.0 移除**

Docker Hub 的搜尋 API 已棄用 is_automated 欄位。因此，映像檔搜尋中的 IsAutomated 欄位在未來將一律設定為 false，搜尋 "is-automated=true" 將不會產生任何結果。

在 v25.0 中，AUTOMATED 欄位已從預設的 docker search 和 docker image search 輸出中移除，對應的 IsAutomated 樣板選項將在 v26.0 中移除。

Logentries 記錄驅動程式

**已於版本 v24.0 棄用** **已於版本 v25.0 移除**

logentries 服務 SaaS 已於 2022 年 11 月 15 日關閉，導致此記錄檔驅動程式無法運作。使用者不應再使用此記錄檔驅動程式，且該驅動程式已在 Docker 25.0 中移除。升級後，使用此記錄檔驅動程式的現有容器會遷移為使用「local」記錄檔驅動程式。

守護行程的 OOM 分數調整

**已於版本 v24.0 棄用** **已於版本 v25.0 移除**

新增了 oom-score-adjust 選項，以防止守護行程在其他行程之前被 OOM 終止。新增此選項主要是為了方便起見，因為將守護行程作為 systemd 單元執行尚未普及。

讓守護行程自行設定限制並非最佳做法，最好由啟動守護行程的行程管理員來處理。

Docker v20.10 和更新版本不再預設調整守護行程的 OOM 分數，而是將 OOM 分數設定為套件隨附的 systemd 單元 (OOMScoreAdjust)。

目前依賴此功能的使用者，建議在啟動守護行程時使用 systemd 或其他方法調整守護行程的 OOM 分數。

BuildKit 建置資訊

**已於版本 v23.0 棄用** **已於版本 v24.0 移除**

建構資訊 結構已在 BuildKit v0.10.0 中引入，並使用建構中繼資料產生，讓您可以查看建構所使用的所有來源（映像檔、Git 儲存庫），以及它們的確切版本和傳遞給建構的配置。如果產生了映像檔配置，則此資訊也會嵌入到映像檔配置中。

Linux 映像檔的舊版建置器

已於版本 v23.0 中棄用

Docker v23.0 現在預設使用 BuildKit 來建構 Linux 映像檔，並使用 Buildx CLI 元件來執行 docker build。透過此變更，docker build 現在公開了 BuildKit 提供的所有進階功能，而這些功能先前只能透過 docker buildx 子命令使用。

使用我們的 .deb 或 .rpm 套件安裝 docker CLI 時，會自動安裝 Buildx 元件，並且在 download.docker.com 和 Docker Hub 上的 docker/buildx-bin 映像檔

用於建構 Windows 映像檔的傳統建構器

BuildKit（尚）不支援建構 Windows 映像檔，docker build 繼續使用傳統建構器在 Windows 惡魔程式上建構原生 Windows 映像檔。

舊版建置器備援

已於版本 v23.0 中棄用

Docker v23.0 現在預設使用 BuildKit 來建構 Linux 映像檔，這需要 Buildx 元件才能使用 BuildKit 建構映像檔。在某些情況下，Buildx 元件可能無法使用，因此無法使用 BuildKit。

為了順利過渡到 BuildKit 作為預設建構器，Docker v23.0 在某些情況下會自動回退，或者產生錯誤以協助使用者解決問題。

如果使用者未明確選擇使用 BuildKit（即未設定 DOCKER_BUILDKIT=1），CLI 會自動回退到傳統建構器，但會印出棄用警告。

DEPRECATED: The legacy builder is deprecated and will be removed in a future release.
            Install the buildx component to build images with BuildKit:
            https://docker-docs.dev.org.tw/go/buildx/

如果使用靜態二進制檔案安裝 docker CLI，並且未安裝或未正確安裝 Buildx 元件，則可能會發生這種情況。此回退機制將在未來的版本中移除，因此我們建議您 安裝 Buildx 元件

ERROR: BuildKit is enabled but the buildx component is missing or broken.
       Install the buildx component to build images with BuildKit:
       https://docker-docs.dev.org.tw/go/buildx/