Peering 免费流量

SparkCR 为来自 Peering 直连网络的登录用户提供公共容器镜像免费不限量拉取。本文介绍这项政策的具体内容、背后原因，以及如何确认你是否在覆盖范围内。

政策说明

同时满足以下两个条件时，公共镜像拉取不消耗任何付费配额，且没有流量上限：

1. 出口 IP 位于 Peering 直连网络 — 你的请求从 SparkCR 已建立 Peering 互联的云网络或 ISP 发出。
2. 已登录 — 请求附带了有效的 Access Token（通过 docker login 或等效方式）。

不满足条件时的行为：

该政策仅适用于公共镜像。私有镜像始终按账号套餐配额计量。

为什么能做到

Peering 直连网络的流量成本结构与公网截然不同。

Peering vs Transit

网络互联有两种基本模式：Peering（对等互联）和 Transit（转接）。Peering 是两个网络直接交换流量，通常互免结算；Transit 则需要向上游运营商购买带宽，流量经过多跳中转，按量计费。

SparkCR 与主要云网络建立了 Peering 互联。经过这条路径的流量成本比 Transit 低一到两个数量级——这是免费政策的基础。

缓存放大效应

公共镜像的热门层缓存命中率很高，一次回源可以服务大量后续拉取：

这三个因素——带宽互免结算、缓存放大、路由效率——叠加后，Peering 来源的登录流量在商业上可以按零成本建模，因此 SparkCR 选择将这部分流量免费开放。

确认你是否在覆盖范围

网页检测

访问 网络检测页，页面会自动检测当前 IP 的 Peering 状态。你也可以手动输入其他 IP（如 CI Runner、Kubernetes 节点的出口 IP）进行检测。

CLI 检测

在服务器或 CI 环境中直接运行：

curl -fsSL https://sparkcr.cn/network/check.sh | sh

强制使用 IPv4 或 IPv6：

curl -fsSL https://sparkcr.cn/network/check.sh | sh -s -- -4
curl -fsSL https://sparkcr.cn/network/check.sh | sh -s -- -6

输出会显示 Peering 状态、IP、ASN 等信息。

当前覆盖的云网络

以下公有云可能与 SparkCR 存在 Peering 直连路径，具体是否覆盖取决于地域和实际出口 IP：

覆盖范围可能随时调整，以检测结果为准。

常见问题

私有镜像也免费吗？

不是。免费不限量仅适用于公共镜像。私有镜像拉取始终按账号配额计量，无论是否来自 Peering 网络。

为什么未登录不能享受免费？

登录是确认用户身份的必要手段。匿名请求无法区分正常使用和滥用，因此需要通过配额进行保护。登录后 SparkCR 可以准确识别来源，从而安全地放开限制。

我在覆盖的云上，但检测显示非 Peering？

Peering 覆盖与出口 IP 相关，而非云厂商整体。以下情况可能导致未覆盖：

• 出口 IP 所在地域的网络尚未与 SparkCR 建立 Peering 互联。
• 出口 IP 经过了非直连的 NAT 网关或代理。
• 云厂商的部分 IP 段尚未被路由到 Peering 路径。

可以在 网络检测页 带上具体 IP 确认，或联系 SparkCR 反馈。

CI/CD 环境怎么配置？

在 CI 中使用 docker login 配置 Access Token 即可。确保：

• 为每个项目或 Runner 创建独立的 Access Token。
• Token 只授予 pull:public 权限。
• 确认 Runner 的出口 IP 在 Peering 范围内。

详细配置参考 CI/CD 集成。

这个政策会取消吗？

我们预期此政策将长期提供。Peering 流量的成本结构决定了这项福利在商业上是可持续的。SparkCR 保留调整政策的权利，但不会在无预告的情况下变更，如有调整会提前通知。