# 来自守护进程的错误响应：toomanyrequests：您已达到拉取速率限制。您可以通过身份验证和升级来提高限制：https://www.docker.com/increase-rate-limit

- **ID:** `policy/docker-hub-pull-rate-limit-exceeded`
- **领域:** policy
- **类别:** resource_error
- **验证级别:** ai_generated
- **修复率:** 85%

## 根因

Docker Hub 对匿名拉取（每 6 小时每 IP 100 次）和经过身份验证的免费用户（每 6 小时 200 次）实施拉取速率限制；超出限制后会阻止拉取。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| Docker Engine 24.0 | active | — | — |
| Docker Desktop 4.25 | active | — | — |
| Docker Hub rate limit policy Nov 2020 | active | — | — |

## 解决方案

1. ```
   使用 docker login 通过 Docker Hub 账户进行身份验证（免费用户限制提高到每 6 小时 200 次拉取）。
   ```
2. ```
   升级到 Docker Pro/Team 订阅以获得无限拉取，或使用镜像注册表如 mirror.gcr.io。
   ```

## 无效尝试

- **Restart Docker daemon to reset rate limit counter** — Rate limit is enforced server-side by Docker Hub based on IP address and user account; restarting the daemon does not change the client IP or authentication status. (95% 失败率)
- **Use a VPN to get a different IP address** — While a new IP may reset anonymous limits temporarily, many corporate VPNs share IPs, causing the same limit to be hit again quickly; also violates many corporate security policies. (70% 失败率)