镜像拉取失败会不会扣流量？
本文适用于：
- • Docker 20+ / 24+
- • 使用轩辕镜像服务的用户
- • 遇到镜像拉取失败的情况
- • 需要了解流量计费规则
镜像拉取失败时，系统会按照实际产生的流量进行计费，不会因为拉取失败而全额扣除镜像大小的流量。
计费原则
按实际流量计费：只计算实际传输的数据量，不会因为拉取失败而扣除完整镜像大小的流量。
流量计算说明
1. Manifest 文件：
Docker 在拉取镜像时，每次都会先请求 manifest 文件（镜像清单），这个请求本身会产生少量流量，通常不超过 20KB。
2. Blob 文件（镜像层）：
对于 blob 文件（镜像的实际数据层），即使下载未完成，也只会计算已传输的部分。例如某个 blob 文件大小为 20MB，如果只下载了 10MB 就中断了，那么只会扣除这 10MB 的流量。
为什么按实际流量计费？
Docker 客户端在拉取镜像时，不会主动告知服务器端 blob 文件是否完整下载成功。服务端无法得知客户端最终是否成功拉取完整镜像，因此只能按照实际发生的网络传输流量进行统计和计费。
这种计费方式确保了公平性：无论拉取成功与否，您只需要为实际使用的流量付费。
💡 总结：
- ✅ 镜像拉取失败会扣流量，但只计算实际产生的流量
- ✅ Manifest 文件请求会产生少量流量（通常 20KB 以内）
- ✅ Blob 文件按实际下载的数据量计费，未下载的部分不扣费
- ✅ 这种计费方式公平合理，确保您只为实际使用的流量付费
你可能还会遇到：
本文由「xuanyuan.cloud」维护
专注国内 Docker / 镜像 / Registry 网络问题
内容基于真实用户环境与实测
📚 问题目录