curl与wget查询Docker Hub速率的行为差异及速率消耗疑问

我想了解curl与wget在查询Docker Hub下载速率时的行为差异。根据Docker官方文档，可使用以下curl脚本获取剩余速率：

docker_hub_rate() {
  local IMAGE=${1:-ratelimitpreview/test}
  local RESPONSE=$(wget -qO- "https://auth.docker.io/token?service=registry.docker.io&scope=repository:${IMAGE}:pull")
  local TOKEN=$(echo ${RESPONSE} | sed 's/.*"token":"([^"]*)".*/\1/')
  local HEADER="Authorization: Bearer ${TOKEN}"
  local URL="https://registry-1.docker.io/v2/${IMAGE}/manifests/latest"
  RESPONSE=$(curl --head -H "${HEADER}" "${URL}" 2>&1)
  echo ${RESPONSE}
}

由于我的环境没有curl，只有wget可用，因此将脚本修改为：

docker_hub_rate() {
  local IMAGE=${1:-ratelimitpreview/test}
  local RESPONSE=$(wget -qO- "https://auth.docker.io/token?service=registry.docker.io&scope=repository:${IMAGE}:pull")
  local TOKEN=$(echo ${RESPONSE} | sed 's/.*"token":"([^"]*)".*/\1/')
  local HEADER="Authorization: Bearer ${TOKEN}"
  local URL="https://registry-1.docker.io/v2/${IMAGE}/manifests/latest"
  RESPONSE=$(wget -qS --header="${HEADER}" -O /dev/null "${URL}" 2>&1)
  echo ${RESPONSE}
}

修改后仍能获取速率，但我曾误以为wget会消耗一次Docker Hub速率，而curl不会，后来发现两者均不会消耗速率。想请教是什么导致了curl与wget的行为差异？

解答 #

首先明确Docker Hub的速率限制核心规则：只有成功完成镜像层（blob）或完整镜像清单（manifest）的拉取操作才会消耗下载配额，单纯查询速率相关的元数据不会触发计数。

再看curl和wget的具体行为差异：

• curl：使用--head参数时，会发送HTTP HEAD请求，服务器仅返回响应头信息（包含RateLimit相关字段），不会传输manifest的实际内容，全程没有触发镜像拉取的核心操作，自然不会消耗配额。
• wget：你使用的-qS --header="${HEADER}" -O /dev/null组合，是发送HTTP GET请求，但将响应体（manifest内容）直接丢弃。虽然请求方法是GET，但Docker Hub不会将这种仅获取元数据、未实际拉取镜像资源的请求计入配额消耗——本质上这和curl的HEAD请求一样，都是查询速率的元数据操作。

你之前的误解源于对wget请求方法的担忧，但核心原因是Docker Hub的配额统计逻辑只针对实际的镜像拉取行为，和HTTP请求方法（HEAD/GET）无关，只要没有真正获取镜像层或完整用于拉取的manifest，就不会消耗速率。

内容的提问来源于stack exchange，提问作者Shizun Ge