Cloudflare Pages 容器镜像代理使用指南

本服务提供 GHCR 与 Quay 的拉取代理（仅支持 GET/HEAD）。请为项目绑定两个子域名：

• GHCR代理： ghcr.<你的域名>
• Quay代理： quay.<你的域名>

Docker 使用示例

GHCR 拉取：

docker pull ghcr.<你的域名>/OWNER/IMAGE:TAG

Quay 拉取：

docker pull quay.<你的域名>/NAMESPACE/IMAGE:TAG

说明：镜像引用中的主机名替换为对应代理子域，路径保持与上游一致（客户端将请求 /v2/...）。

Podman 使用示例

podman pull ghcr.<你的域名>/OWNER/IMAGE:TAG
podman pull quay.<你的域名>/NAMESPACE/IMAGE:TAG

鉴权与私有仓库

• 请对上游域登录（例如：docker login ghcr.io 或 docker login quay.io），令牌将透传到上游。
• 首次拉取可能返回 401 并包含 WWW-Authenticate，按提示完成登录后重试。

范围请求与稳定性

• 本代理支持范围请求与3xx内跟随，适配大层与断点续传。
• 为降低封锁风险，未启用边缘缓存，仅拉取直通。

快速验证

• 访问 https://ghcr.<你的域名>/v2/ 与 https://quay.<你的域名>/v2/，通常返回 401 且包含 WWW-Authenticate。

如需调整使用方式（例如改回单域名前缀或增加R2缓存），可在后续迭代中升级。