gua.cx Container Registry Proxy

自用容器镜像代理服务。提供两种入口：多源路径代理 cr.gua.cx，以及 Docker Hub 专用 daemon mirror dhub.gua.cx。

Docker HubGHCRQuayHTTPSRegistry API v2

通用入口 cr.gua.cx

适合手动改镜像名、Compose、CI、K8s YAML。把上游 registry 放在路径第一段。

docker pull cr.gua.cx/docker.io/library/nginx:latest

docker pull cr.gua.cx/docker.io/library/redis:latest

docker pull cr.gua.cx/ghcr.io/owner/image:tag

docker pull cr.gua.cx/quay.io/org/image:tag

注意：这种路径代理不能直接写入 Docker daemon.json 做透明 mirror。

Docker Hub Mirror dhub.gua.cx

适合写入 Docker daemon，让 docker pull nginx 这类 Docker Hub 镜像自动走代理。

{
  "registry-mirrors": [
    "https://dhub.gua.cx"
  ]
}

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json >/dev/null <<'EOF'
{
  "registry-mirrors": ["https://dhub.gua.cx"]
}
EOF
sudo systemctl restart docker

验证命令

curl -I https://cr.gua.cx/v2/
curl -I https://dhub.gua.cx/v2/

docker pull cr.gua.cx/docker.io/library/busybox:latest

docker info | grep -A3 "Registry Mirrors"
docker pull hello-world:latest

使用边界

cr.gua.cx：支持多上游 registry，但需要改镜像地址。

dhub.gua.cx：可写入 Docker daemon.json，但只用于 Docker Hub。

提醒：这是自用代理服务，不建议大规模公开使用；Docker Hub 仍可能有上游限流。