nx-cache-server
Servidor de caché remoto autoalojado para Nx basado en Deno, que implementa la especificación Nx Custom Self-Hosted Remote Cache utilizando almacenamiento S3 compatible (Amazon S3 o MinIO) con autenticación Bearer y soporte HTTPS.
Ficha actualizada 26 sept 2026, 10:49 · upstream 26 sept 2026, 10:28 · release v1.2.1
Qué es nx-cache-server
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este servidor es una implementación en Deno de la especificación Nx Custom Self-Hosted Remote Cache OpenAPI, diseñada para proporcionar una capa de caché para las salidas de compilación de Nx. Está orientado a entornos de producción autoalojados donde se requiere control total sobre el almacenamiento y la seguridad.
El backend de almacenamiento es compatible con Amazon S3, lo que permite utilizar infraestructura existente o servicios compatibles como MinIO. La autenticación se gestiona mediante tokens Bearer seguros, y el servidor soporta streaming eficiente de archivos para optimizar el rendimiento durante las operaciones de compilación distribuida.
Ofrece despliegue flexible a través de imágenes Docker oficiales en GHCR, artefactos OCI para Kubernetes con soporte de Helm, y opciones para desarrollo local utilizando un emulador S3 in-memory. La configuración se realiza principalmente mediante variables de entorno, incluyendo soporte para TLS directo o terminación en proxy inverso.
- Servir como caché remoto oficial para compilaciones distribuidas en entornos Nx autoalojados
- Integrar almacenamiento persistente S3 (Amazon S3 o MinIO) para retención de artefactos de build
- Desplegar en Kubernetes utilizando Helm charts con gestión de secretos externa
- Ejecutar en desarrollo local con emulador S3 in-memory sin necesidad de infraestructura externa
- Implementar seguridad mediante autenticación Bearer y certificados TLS/HTTPS
- Cumple estrictamente la especificación Nx Custom Remote Cache OpenAPI para compatibilidad garantizada
- Soporte nativo para HTTPS con configuración de certificados PEM (TLS_CERT_PATH y TLS_KEY_PATH)
- Imágenes Docker y OCI disponibles en ghcr.io/ikatsuba para despliegue rápido
- Streaming eficiente de archivos optimizado para grandes volúmenes de datos de compilación
- Configuración flexible mediante variables de entorno sin necesidad de reescribir código
- El cliente de Nx nativo no respeta NODE_EXTRA_CA_CERTS ni SSL_CERT_FILE; requiere certificados de CA pública o corporativa instalados en el store del sistema operativo
- No incluye Docker Compose, requiriendo gestión manual de contenedores o uso de Helm para orquestación
- Complejidad clasificada como HIGH debido a la configuración de entornos S3 y seguridad TLS
- Dependencia de backend S3 compatible; no es un servicio de almacenamiento autónomo
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Usar certificados de CA pública (ej. Let's Encrypt) o corporativa en el store del sistema operativo para HTTPS, ya que Nx no respeta variables de entorno de CA adicionales. Port 3000 por defecto. Para Kubernetes, preferir terminación TLS en Ingress. Helm charts disponibles en OCI ghcr.io/ikatsuba/charts/nx-cache-server.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.