Mirrors disponibles

Comprobación de API y almacenamiento

Datos entregados

Enviados a los usuarios desde el reinicio

Datos desde caché

Reutilizados desde el almacenamiento local

Actividad de los mirrors

Los contadores se acumulan desde el último reinicio de cada mirror.

Se actualiza cada 60 segundos
Registro Estado Tiempo activo Uso de caché Solicitudes totales Atendidas localmente Datos entregados
Cargando datos de los mirrors…

La disponibilidad comprueba la API y el almacenamiento del mirror, pero no los registros externos de origen. El uso de caché es el porcentaje de solicitudes de manifiestos y blobs atendidas localmente. Cada contador se reinicia de forma independiente cuando se reinicia su mirror.

Usar un mirror

Configura los mirrors automáticos en Docker o Podman, o usa directamente el dominio de un mirror.

Descargas automáticas de Docker Hub

Configurar Docker Engine

En una instalación normal de Linux, integra la opción registry-mirrors en /etc/docker/daemon.json. Si el archivo ya contiene otras opciones, consérvalas y agrega esta clave al objeto JSON existente.

Esta opción del servicio de Docker solo se aplica a Docker Hub. Para imágenes de GCR, MCR, Quay y Kubernetes, usa los dominios de los mirrors que aparecen abajo.

/etc/docker/daemon.json
{
  "registry-mirrors": [
    "https://docker-io.cuza.dev"
  ]
}

Reinicia Docker y verifica la configuración:

sudo systemctl restart docker docker info | grep -A 2 'Registry Mirrors'

Reiniciar Docker puede interrumpir brevemente los contenedores en ejecución, a menos que la restauración en vivo esté activada. En Docker Desktop, agrega el mismo JSON en Settings → Docker Engine, aplica los cambios y reinicia.

Mirrors automáticos por registro

Configurar Podman

Podman permite asignar un mirror diferente a cada registro. Guarda este archivo en /etc/containers/registries.conf.d/ para aplicarlo a todos los usuarios.

Podrás seguir usando los nombres originales, como quay.io/prometheus/busybox:latest. También podrás usar nombres cortos de Docker Hub, como alpine. Podman enviará la descarga al mirror correspondiente de cuza.dev.

Esta configuración redirige cada registro directamente a su mirror y no intenta conectarse al registro público si el mirror no está disponible. Para un solo usuario, guarda el archivo en ~/.config/containers/registries.conf.d/.

/etc/containers/registries.conf.d/10-cuza-mirrors.conf
unqualified-search-registries = ["docker.io"]

[[registry]]
prefix = "docker.io"
location = "docker-io.cuza.dev"

[[registry]]
prefix = "gcr.io"
location = "gcr-io.cuza.dev"

[[registry]]
prefix = "mcr.microsoft.com"
location = "mcr-microsoft-com.cuza.dev"

[[registry]]
prefix = "quay.io"
location = "quay-io.cuza.dev"

[[registry]]
prefix = "registry.k8s.io"
location = "registry-k8s-io.cuza.dev"

No necesitas reiniciar Podman. Comprueba la configuración con una descarga:

podman pull quay.io/prometheus/busybox:latest

La redirección se aplica a descargas de imágenes, no a publicaciones ni búsquedas. Usa nombres completos de imágenes para seleccionar el registro correcto.

docker.iodocker-io.cuza.dev
docker pull docker-io.cuza.dev/library/alpine:latest
gcr.iogcr-io.cuza.dev
docker pull gcr-io.cuza.dev/distroless/static-debian12:nonroot
mcr.microsoft.commcr-microsoft-com.cuza.dev
docker pull mcr-microsoft-com.cuza.dev/dotnet/runtime:8.0
quay.ioquay-io.cuza.dev
docker pull quay-io.cuza.dev/prometheus/busybox:latest
registry.k8s.ioregistry-k8s-io.cuza.dev
docker pull registry-k8s-io.cuza.dev/pause:3.10