Cómo dejar de esperar eternamente a que se descarguen las dependencias e imágenes

Una historia conocida: ejecutas npm install, docker pull, o intentas descargar un modelo pesado desde Hugging Face, y... ve por un café. O quizás incluso por almuerzo. Se pone especialmente "divertido" cuando trabajas en una red corporativa con proxies estrictos, o simplemente en una región donde llegar a los servidores de GitHub o Docker Hub es toda una aventura.

Hace poco me encontré con un proyecto llamado Xget. No es solo otro "wrapper de espejo" — es un motor de aceleración completo para recursos de desarrollo. Puede acelerar la entrega de código, modelos, paquetes e incluso inferencia de redes neuronales a través de API. Se ejecuta en Cloudflare Workers, lo que significa que el contenido llega desde el nodo CDN más cercano a tu casa u oficina.

Qué puede hacer esta herramienta

Xget funciona como un único punto de entrada. En lugar de configurar una docena de proxies diferentes para cada herramienta, usas un dominio.

El proyecto soporta una cantidad absurda de plataformas:

• Repositorios: GitHub, GitLab, Gitea, Codeberg.
• Gestores de paquetes: npm, PyPI, Conda, Maven, Homebrew, Crates.io (Rust), Go Modules.
• Recursos de IA: Hugging Face, Civitai.
• Contenedores: Docker Hub, Quay, GCR, GHCR.
• Distribuciones de Linux: Debian, Ubuntu, Arch, Fedora.
• Incluso APIs de redes neuronales: OpenAI, Anthropic, Gemini y otras.

La idea es simple: toma el enlace original, añade el prefijo de la plataforma al dominio de Xget, y la magia del caché en tiempo real comienza a funcionar.

Cómo funciona internamente

El autor no reinventó la rueda y construyó la solución sobre un stack moderno. La base es Cloudflare Workers. Esto proporciona dos beneficios principales: latencia mínima gracias a los nodos distribuidos y protección contra caídas de servidores — si un centro de datos se cae, otro recoge la solicitud.

Así es como se ve el procesamiento de solicitudes:

El motor analiza lo que estás solicitando. Si es tráfico Git, entran en acción adaptadores específicos para el protocolo Git (incluso se soportan git push y LFS). Si es una solicitud a un registro de Docker — entra en acción la lógica de autorización y la transferencia de capas de imágenes.

El almacenamiento en caché está implementado de manera interesante. Xget no solo hace proxy de bytes. Entiende la diferencia entre metadatos (que cambian frecuentemente) y artefactos como archivos .zip o .tar.gz (que son inmutables). Los primeros se actualizan con más frecuencia, los segundos permanecen en caché por mucho tiempo.

La seguridad no es solo palabras vacías

Usualmente hay preguntas sobre los servidores proxy públicos: ¿quién ve mi tráfico? ¿Cambiarán mi binario? Xget tiene varias capas de protección integradas:

1. Encabezados de seguridad estrictos (HSTS, CSP, X-Frame-Options). Esto es lo básico, pero muchos lo olvidan.
2. Validación de rutas. No puedes pasar una URL demasiado larga ni intentar escapar más allá de los directorios permitidos (protección contra path traversal).
3. Lista blanca de métodos. Solo GET y HEAD están permitidos para descargas regulares. POST y otros solo se abren donde realmente se necesitan (por ejemplo, para Git LFS o APIs de IA).

Por cierto, el proyecto es completamente Open Source. Si no confías en la instancia pública xget.xi-xu.me, puedes desplegar tu propia instancia personal en tu cuenta de Cloudflare en cinco minutos, o incluso en Docker en tu propio servidor.

Ejemplos prácticos

La parte más útil es cómo Xget se integra en tu rutina diaria.

Acelerando Git

Si git clone va a paso de tortuga, puedes configurar un reemplazo global de dominio:

git config --global url."https://xget.xi-xu.me/gh/".insteadOf "https://github.com/"

Ahora cualquier solicitud a GitHub pasará automáticamente por el acelerador. Transparente y conveniente.

Trabajando con Docker sin dolor

En lugar de luchar con la configuración de daemon.json, simplemente puedes especificar el prefijo al hacer pull:

docker pull xget.xi-xu.me/cr/ghcr/nginxinc/nginx-unprivileged:latest

Desarrollo de IA

Para quienes trabajan con modelos, hay una gran función para Hugging Face. Solo pasa una variable de entorno a tu script de Python:

import os
os.environ['HF_ENDPOINT'] = 'https://xget.xi-xu.me/hf'

Después de eso, la biblioteca transformers comenzará a descargar los pesos del modelo a través del espejo.

¿Vale la pena adoptarlo

Xget es un excelente "cuchillo suizo" para quienes están hartos de los problemas de red.

Quién definitivamente lo encontrará útil:

• Desarrolladores en regiones con acceso inestable a recursos extranjeros.
• Ingenieros de DevOps para acelerar builds de imágenes en pipelines de CI/CD.
• Especialistas en Ciencia de Datos que descargan pesos de modelos por gigabyte.

Algunos matices: la instancia pública gratuita tiene sus límites, así que para proyectos serios es mejor dedicar 10 minutos y desplegar tu propia worker en Cloudflare. Afortunadamente, el repositorio tiene acciones listas para usar para despliegue automático.

El proyecto está vivo y está ganando estrellas activamente (ya más de 8,000) y soporte para nuevas plataformas. Si necesitas una solución para todos tus problemas de descarga de recursos — Xget definitivamente merece un lugar en tus marcadores.