Docker Mirror

HubProxy implements Docker Registry API v2 and can accelerate Docker Hub and multiple third-party registries.

Configure Docker Client

Edit /etc/docker/daemon.json (or Docker Desktop settings on Windows):

{
  "registry-mirrors": ["https://example.com"]
}

Restart Docker:

sudo systemctl restart docker

Supported Registries

Registry	Notes
Docker Hub	Default `registry-1.docker.io`, no path prefix needed
ghcr.io	GitHub Container Registry
gcr.io	Google Container Registry
quay.io	Red Hat Quay
registry.k8s.io	Kubernetes official images

Extend or disable in [registries] — see Registry Sources.

Pull Examples

# Docker Hub official image (no library prefix needed)
docker pull example.com/nginx

# Docker Hub user image
docker pull example.com/user/app:tag

# Third-party registry (path includes registry domain)
docker pull example.com/ghcr.io/owner/image:tag

The library/ namespace is added automatically for official images, and latest is used when no tag is given — example.com/nginx is equivalent to example.com/library/nginx:latest.

Image Search

The web UI (enableFrontend = true) provides Docker Hub search and tag browsing. API access:

curl "https://example.com/api/search?q=nginx"
curl "https://example.com/api/tags/library/nginx"

Notes

Each layer counts against rate limits
Configure [access].whiteList for public deployments
Ensure correct client IP behind reverse proxy — see Reverse Proxy
Anonymous upstream pulls — private authenticated images cannot be pulled through HubProxy