Docker Hub 使用量和速率限制

重要
Docker 正在推出增強的訂閱方案。我們的新方案包含更多功能、更高的使用量限制和簡化的定價。新的訂閱方案將於 2024 年 12 月 10 日或之後的下一個續約日期生效。在 2025 年 2 月 28 日之前，Docker Hub 映像檔提取或儲存不會產生任何費用。請參閱Docker 方案升級公告
使用量是指
提取：從 Docker Hub 傳輸的資料量
儲存：儲存在 Docker Hub 上的資料量
合理使用
使用 Docker 平台時，使用者應注意過量的資料傳輸、提取速率或資料儲存可能會導致限制或額外費用。為了確保公平的資源使用並維持服務品質，我們保留對展現過量資料和儲存消耗的帳戶施加限制或收取額外費用的權利。
檢視 Docker Hub 使用量
登入 Docker Hub
您可以下載您或您組織的 Docker Hub 使用量的 CSV 檔案。要下載檔案，請執行下列操作
登入 Docker Hub
CSV 欄位定義使用量指引
datehour 導致資料傳輸的提取的日期和小時 (yyyy/mm/dd/hh)。這有助於識別尖峰使用量時間和模式。
user_name 提取映像檔的用户的 Docker ID 這可讓組織擁有者追蹤每位使用者的資料消耗量，並有效地管理資源。
repository 被提取的映像檔的儲存庫名稱。這可讓您識別哪些儲存庫的存取頻率最高，以及消耗最多的資料傳輸量。
access_token_name 用於 Docker CLI 驗證的存取權杖的名稱。當使用者登入時，Docker 用戶端會自動產生 `generated` 權杖。個人存取權杖通常用於驗證自動化工具 (Docker Desktop、CI/CD 工具等)。這對於識別哪個自動化系統發出提取請求很有用。
ips 用於提取映像檔的 IP 位址。此欄位是彙總的，因此可能會出現多個 IP 位址，代表在同一天和同一小時內用於提取映像檔的所有 IP。這有助於您了解資料傳輸的來源，這對於診斷和識別自動或手動提取的模式很有用。
repository_privacy（映像檔儲存庫隱私） 被提取的映像檔儲存庫的隱私狀態。可以是 `public`（公開）或 `private`（私有）。這區分了公開和私有儲存庫，以識別提取影響哪個資料傳輸閾值。
tag（標籤） 映像檔的標籤。僅當提取請求包含標籤時，標籤才可用。這有助於識別映像檔。標籤通常用於識別映像檔的特定版本或變體。
digest（摘要） 映像檔的唯一映像檔摘要。這有助於識別映像檔。
version_checks（版本檢查） 每個映像檔儲存庫在日期和小時內累積的版本檢查次數。根據客戶端的不同，提取請求可以執行版本檢查以驗證映像檔或標籤是否存在，而無需下載它。這有助於識別版本檢查的頻率，您可以使用它來分析使用趨勢和潛在的異常行為。
pulls（提取次數） 每個映像檔儲存庫在日期和小時內累積的提取次數。這有助於識別儲存庫提取的頻率，您可以使用它來分析使用趨勢和潛在的異常行為。

CSV 欄位	定義	使用量指引
`datehour`	導致資料傳輸的提取的日期和小時 (`yyyy/mm/dd/hh`)。	這有助於識別尖峰使用量時間和模式。
`user_name`	提取映像檔的用户的 Docker ID	這可讓組織擁有者追蹤每位使用者的資料消耗量，並有效地管理資源。
`repository`	被提取的映像檔的儲存庫名稱。	這可讓您識別哪些儲存庫的存取頻率最高，以及消耗最多的資料傳輸量。
`access_token_name`	用於 Docker CLI 驗證的存取權杖的名稱。當使用者登入時，Docker 用戶端會自動產生 `generated` 權杖。	個人存取權杖通常用於驗證自動化工具 (Docker Desktop、CI/CD 工具等)。這對於識別哪個自動化系統發出提取請求很有用。
`ips`	用於提取映像檔的 IP 位址。此欄位是彙總的，因此可能會出現多個 IP 位址，代表在同一天和同一小時內用於提取映像檔的所有 IP。	這有助於您了解資料傳輸的來源，這對於診斷和識別自動或手動提取的模式很有用。
`repository_privacy（映像檔儲存庫隱私）`	被提取的映像檔儲存庫的隱私狀態。可以是 `public`（公開）或 `private`（私有）。	這區分了公開和私有儲存庫，以識別提取影響哪個資料傳輸閾值。
`tag（標籤）`	映像檔的標籤。僅當提取請求包含標籤時，標籤才可用。	這有助於識別映像檔。標籤通常用於識別映像檔的特定版本或變體。
`digest（摘要）`	映像檔的唯一映像檔摘要。	這有助於識別映像檔。
`version_checks（版本檢查）`	每個映像檔儲存庫在日期和小時內累積的版本檢查次數。根據客戶端的不同，提取請求可以執行版本檢查以驗證映像檔或標籤是否存在，而無需下載它。	這有助於識別版本檢查的頻率，您可以使用它來分析使用趨勢和潛在的異常行為。
`pulls（提取次數）`	每個映像檔儲存庫在日期和小時內累積的提取次數。	這有助於識別儲存庫提取的頻率，您可以使用它來分析使用趨勢和潛在的異常行為。

最佳化和管理 Docker Hub 使用量

使用以下步驟來幫助優化和管理個人和組織的 Docker Hub 使用情況。

檢視您的 Docker Hub 使用情況.
使用 Docker Hub 使用資料來識別哪些帳戶消耗的資料最多，確定尖峰使用時間，並識別哪些映像檔與最多的資料使用量相關。此外，尋找使用趨勢，例如以下：
- 低效的提取行為：識別經常存取的儲存庫，以評估是否可以優化快取策略或整合使用以減少提取次數。
- 低效的自動化系統：檢查哪些自動化工具（例如 CI/CD 管道）可能導致較高的提取率，並將其配置為避免不必要的映像檔提取。
透過執行以下操作來優化映像檔提取：
- 使用快取：透過鏡像或在 CI/CD 管道中實作本地映像檔快取，以減少冗餘提取。
- 自動化手動工作流程：透過將自動化系統配置為僅在有新版本的映像檔可用時才提取，來避免不必要的提取。
透過定期稽核和移除未標記、未使用或過時的映像檔來優化儲存庫的大小。
透過升級或購買附加元件來提高您的限制。詳情請參閱Docker 價格以監控使用情況。
強制登入以確保您可以監控使用者的使用情況，並且使用者可以獲得更高的使用限制。

提取歸因

提取可以歸因於個人或組織命名空間

私有儲存庫的提取將歸因於儲存庫的命名空間所有者。

公開提取

從公開儲存庫提取映像檔時，歸因將根據網域隸屬關係和組織成員資格來確定。

已驗證的網域所有權

從連結到已驗證網域的帳戶提取映像檔時，歸因將設定為該網域

如果已驗證網域的所有者是一間公司，並且該使用者僅是該公司
如果使用者是公司旗下多個組織的成員，則提取將歸因於使用者的個人命名空間。
速率限制
提取使用情況會套用速率限制。使用者的速率限制等於其個人帳戶或其所屬任何組織的最高權限。要利用此優勢，您必須以已驗證使用者的身分登入Docker Hub。未經驗證（匿名使用者）的使用者將透過 IP 執行限制。
- 提取次數將計入執行提取的使用者，而不是映像檔的所有者。
- 提取請求定義為對 registry manifest URL (`/v2/*/manifests/*`) 的最多兩個 `GET` 請求。
- 正常的映像檔提取會發出單個 manifest 請求。
- 多架構映像檔的提取請求會發出兩個 manifest 請求。
- `HEAD` 請求不計入在內。
- 某些映像檔透過Docker 贊助的開源
  重要
  Docker 正在推出增強的訂閱方案。我們的新方案包含更多功能、更高的使用量限制和簡化的定價。新的訂閱方案將於 2024 年 12 月 10 日或之後的下一個續約日期生效。在 2025 年 2 月 28 日之前，Docker Hub 映像檔提取或儲存不會產生任何費用。請參閱 Docker 方案升級公告
  重要
  2025 年 3 月 3 日之後，透過 Docker 增強的訂閱方案，具有付費訂閱的使用者或自動化系統將沒有映像檔提取速率限制。
  使用 Docker Hub 的匿名使用者和 Docker 個人使用者將會遇到映像檔提取請求的速率限制。對於已驗證的使用者，每位使用者每小時將有 40 次提取的速率限制；對於未經驗證的使用，每個 IP 地址每小時將有 10 次提取的速率限制。
  Docker Hub 根據提取映像檔的使用者帳戶類型來限制 Docker 映像檔下載或提取的次數。提取速率限制基於個別 IP 地址。下表反映了 Docker 目前的速率限制：
  使用者類型速率限制
  匿名使用者每個 IP 地址每 6 小時 100 次提取
  已驗證使用者每 6 小時 200 次提取
  具有付費Docker 訂閱
  如果您需要更多提取次數，您也可以購買增強型服務帳戶附加元件。
  如何知道我的提取請求受到限制？
  當您發出提取請求且超過限制時，Docker Hub 會在請求 manifest 時傳回 `429` 回應程式碼，並包含以下主體：
  You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://docker.dev.org.tw/increase-rate-limits
  此錯誤訊息會顯示在 Docker CLI 或 Docker Engine 的記錄中。
  如何檢查我目前的速率？
  對 Hub 的有效 API 請求通常會在回應中包含以下速率限制標頭
  ratelimit-limit ratelimit-remaining docker-ratelimit-source
  這些標頭會在 GET 和 HEAD 請求中傳回。
  注意事項
  使用 GET 模擬實際的提取並計入限制。使用 HEAD 則不會。要檢查您的限制，您需要安裝 curl、grep 和 jq。
  如果您以匿名方式提取，請以匿名方式取得權杖
  $ TOKEN=$(curl "https://auth.docker.io/token?service=registry.docker.io&scope=repository:ratelimitpreview/test:pull" | jq -r .token)
  如果您已通過驗證，請使用使用者帳戶取得權杖（請在以下指令中插入您的使用者名稱和密碼）
  $ TOKEN=$(curl --user 'username:password' "https://auth.docker.io/token?service=registry.docker.io&scope=repository:ratelimitpreview/test:pull" | jq -r .token)
  然後，若要取得顯示您限制的標頭，請執行以下指令
  $ curl --head -H "Authorization: Bearer $TOKEN" https://registry-1.docker.io/v2/ratelimitpreview/test/manifests/latest
  應該會傳回以下標頭
  ratelimit-limit: 100;w=21600 ratelimit-remaining: 76;w=21600 docker-ratelimit-source: 192.0.2.1
  在前面的範例中，提取限制為每 21600 秒（6 小時）100 次提取，且剩餘 76 次提取。
  我沒有看到任何 RateLimit 標頭
  如果您沒有看到任何 RateLimit 標頭，可能是因為映像或您的 IP 與發佈者、提供者或開放原始碼組織合作而沒有限制。也可能表示您提取所使用的使用者是付費 Docker 方案的一部分。如果您沒有看到這些標頭，則提取該映像將不會計入提取限制。但是，每日提取次數超過 5000 次的付費 Docker 訂閱使用者需要服務帳戶訂閱。
  即使我已付費訂閱 Docker，我的速率仍被限制在較低水準
  若要利用付費 Docker 訂閱中包含的較高限制，您必須使用您的使用者帳戶驗證提取。
  專業版、團隊版或商業版方案並不會提高其他使用者對您映像的限制。請參閱 Docker 的開放原始碼、發佈者或大型組織方案。
  其他限制
  Docker Hub 也有整體速率限制，以保護應用程式和基礎架構。此限制適用於所有對 Hub 屬性的請求，包括網頁、API 和映像提取。限制是依每個 IP اعمال،且限制會隨著時間推移而變化，具體取決於負載和其他因素，但大約是每分鐘數千個請求。整體速率限制平等地適用於所有使用者，不論帳戶級別為何。
  您可以透過查看錯誤碼來區分這些限制。「整體限制」會傳回簡單的 429 Too Many Requests 回應。提取限制會傳回包含此頁面連結的較長錯誤訊息。
  如何驗證提取請求？
  以下章節包含有關如何登入 Docker Hub 以驗證提取請求的資訊。
  Docker Desktop
  如果您使用的是 Docker Desktop，您可以從 Docker Desktop 選單登入 Docker Hub。
  從 Docker Desktop 選單中選取**登入 / 建立 Docker ID**，然後按照螢幕上的指示完成登入流程。
  Docker 引擎
  如果您使用的是 Docker Engine 的獨立版本，請從終端機執行 docker login 指令以向 Docker Hub 進行驗證。有關如何使用此指令的資訊，請參閱docker login。
  Docker Swarm
  如果您正在執行 Docker Swarm，則必須使用 --with-registry-auth 旗標向 Docker Hub 進行驗證。如需詳細資訊，請參閱建立服務。如果您使用 Docker Compose 檔案來部署應用程式堆疊，請參閱docker stack deploy。
  GitHub Actions
  如果您使用 GitHub Actions 來建置 Docker 映像並將其推送至 Docker Hub，請參閱登入動作。如果您使用其他動作，則必須以類似的方式新增您的使用者名稱和存取權杖以進行驗證。
  Kubernetes
  如果您正在執行 Kubernetes，請按照從私有倉庫提取映像中的指示進行驗證。
  第三方平台
  如果您使用任何協力廠商平台，請按照您的提供者有關使用倉庫驗證的指示進行操作。
  編輯此頁面
  請求變更
  目錄
  用法
  合理使用
  檢視 Docker Hub 使用量
  下載 Docker Hub 使用量
  最佳化和管理 Docker Hub 使用量
  提取歸因
  私人提取
  公開提取
  已驗證的網域所有權
  單一組織成員資格
  多個組織成員資格
  速率限制
  Docker Hub 的下載速率限制是多少？
  如何知道我的提取請求受到限制？
  如何檢查我目前的速率？
  即使我已付費訂閱 Docker，我的速率仍被限制在較低水準
  其他限制
  如何驗證提取請求？
  Docker Desktop
  Docker 引擎
  Docker Swarm
  GitHub Actions
  Kubernetes
  第三方平台

使用者類型	速率限制
匿名使用者	每個 IP 地址每 6 小時 100 次提取
已驗證使用者	每 6 小時 200 次提取
具有付費Docker 訂閱