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://docker.net.tw/increase-rate-limits

可能原因

  • 您作為已認證的 Docker Personal 使用者已達到拉取速率限制。
  • 您作為未認證使用者（基於您的 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 支援 以報告此問題。
頁面選項