疑難排解 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 Personal 用戶，已達到您的提取速率限制。
- 您作為未驗證的用戶，根據您的 IPv4 位址或 IPv6 /64 子網，已達到您的提取速率限制。
解決方案
您可以採用以下任一解決方案
- 進行驗證或升級您的 Docker 帳號。
- 查看您的提取速率限制，等待提取速率限制降低後再試。
請求過多 (429 回應代碼)
錯誤訊息
當發生此問題時，您會在 Docker CLI 或 Docker Engine 日誌中收到以下錯誤訊息
Too Many Requests可能原因
解決方案
- 檢查是否有損壞的 CI/CD 管線在存取 Docker Hub 並修復它們。
- 在您的自動化腳本中實作具有退避機制 (back-off) 的重試解決方案，以確保您不會每分鐘發送數千次請求。
500 回應代碼
錯誤訊息
當發生此問題時，Docker CLI 或 Docker Engine 日誌中常會出現以下錯誤訊息
Unexpected status code 500可能原因
- 存在臨時的 Docker Hub 服務問題。
解決方案
- 查看 Docker 系統狀態頁面，確認所有服務均正常運作。
- 請稍後嘗試再次存取 Docker Hub。這可能是一個臨時問題。
- 聯絡 Docker 支援以回報此問題。