Docker Hub 故障排除

如果您在使用 Docker Hub 時遇到問題,請參考以下解決方案。

您已達到拉取速率限制(429 響應程式碼)

錯誤資訊

當出現此問題時,您會在 Docker CLI 或 Docker Engine 日誌中收到以下錯誤訊息

You have reached your pull rate limit. You may increase the limit by authenticating and upgrading: https://www.docker.com/increase-rate-limits

可能的原因

  • 您已達到作為已認證 Docker 個人使用者的拉取速率限制。
  • 您已達到作為未認證使用者(基於您的 IPv4 地址或 IPv6 /64 子網)的拉取速率限制。

解決方案

您可以使用以下解決方案之一

請求過多(429 響應程式碼)

錯誤資訊

當出現此問題時,您會在 Docker CLI 或 Docker Engine 日誌中收到以下錯誤訊息

Too Many Requests

可能的原因

解決方案

  1. 檢查訪問 Docker Hub 的損壞的 CI/CD 管道並修復它們。
  2. 在您的自動化指令碼中實施帶有退避機制的重試解決方案,以確保您不會每分鐘傳送數千個請求。

500 響應程式碼

錯誤資訊

當出現此問題時,Docker CLI 或 Docker Engine 日誌中通常會出現以下錯誤訊息

Unexpected status code 500

可能的原因

  • Docker Hub 服務暫時出現問題。

解決方案

  1. 檢視Docker 系統狀態頁面並驗證所有服務均正常執行。
  2. 嘗試再次訪問 Docker Hub。這可能是一個暫時性問題。
  3. 聯絡 Docker 支援報告問題。