Registry Proxy Cache

Usage

Quick Start

export REGISTRY_PROXIES=(
    docker.io+https://${DOCKER_USERNAME}:${DOCKER_PASSWORD}@registry-1.docker.io
    quay.io+https://quay.io
    ghcr.io+https://ghcr.io
    gcr.io+https://gcr.io
    k8s.gcr.io+https://k8s.gcr.io
)

docker run \
    -p 5000:5000 \
    -v /data/registry-cache:/data/registry-cache \
    -e REGISTRY_PROXIES="${REGISTRY_PROXIES}" \
    docker.io/octohelm/registry-proxy-cache:master    
    
registry_proxy_cache_endpoint=http://${registry_proxy_cache_ip}:5000   

Pull Directly

docker pull ${registry_proxy_cache_ip}:5000/docker.io/library/nginx

Use as Registry Mirrors

docker daemon registry-mirrors only support docker.io

containerd

configure registry endpoint of containerd

# /etc/containerd/config.toml
# /var/run/docker/containerd/containerd.toml
version = 2

[plugins."io.containerd.grpc.v1.cri".registry]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
endpoint = ["${registry_proxy_cache_endpoint}/mirrors/docker.io/"]
# if have pull like `docker pull myhub/docker.io/library/busybox`
# should use `/hub-prefix-mirrors/{hub}`
# endpoint = ["${registry_proxy_cache_endpoint}/hub-prefix-mirrors/docker.io/"]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors."quay.io"]
endpoint = ["${registry_proxy_cache_endpoint}/mirrors/quay.io/"]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors."gcr.io"]
endpoint = ["${registry_proxy_cache_endpoint}/mirrors/gcr.io/"]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors."ghcr.io"]
endpoint = ["${registry_proxy_cache_endpoint}/mirrors/ghcr.io/"]
[plugins."io.containerd.grpc.v1.cri".registry.mirrors."k8s.gcr.io"]
endpoint = ["${registry_proxy_cache_endpoint}/mirrors/k8s.gcr.io/"]

k3s

see more https://rancher.com/docs/k3s/latest/en/installation/private-registry/

# /etc/rancher/k3s/registries.yaml
mirrors:
  docker.io:
    endpoint:
      - "${registry_proxy_cache_endpoint}/mirrors/docker.io"
  quay.io:
    endpoint:
      - "${registry_proxy_cache_endpoint}/mirrors/quay.io"
  gcr.io:
    endpoint:
      - "${registry_proxy_cache_endpoint}/mirrors/gcr.io"
  k8s.gcr.io:
    endpoint:
      - "${registry_proxy_cache_endpoint}/mirrors/k8s.gcr.io"
  ghcr.io:
    endpoint:
      - "${registry_proxy_cache_endpoint}/mirrors/ghcr.io"