Poner en marcha rápidamente un proyecto de software.

Verdaccio

Verdaccio — registro npm/yarn/pnpm privado autoalojado en VPS.

< 128 MB RAM 1 vCPU Puerto 4873 En validación

En validación

La instalación automática de esta solución está lista y ahora mismo está pasando nuestras pruebas en un servidor real. El pedido se abrirá en cuanto termine la validación.

Stack técnico

DockerNode.js
RAM mínima< 128 MB
CPU mínima1 vCPU
Puerto por defecto4873
SO compatiblesDistribuciones Linux a elegir

Verdaccio es un registro npm privado ligero de código abierto (MIT), escrito en Node.js, que actúa tanto como proxy como capa de alojamiento para tus paquetes JavaScript.

Como proxy, reenvía de forma transparente las solicitudes de paquetes públicos a npmjs.org y los almacena en caché localmente — tus pipelines de CI siguen funcionando incluso cuando el registro público cae, y las instalaciones repetidas se sirven instantáneamente desde disco. Como registro privado, permite publicar paquetes internos bajo cualquier scope (`@company/...`) y mantenerlos completamente fuera de internet.

Verdaccio se despliega en un único contenedor Docker sin dependencias de base de datos externas. Habla el protocolo npm completo, por lo que npm, Yarn y pnpm funcionan sin modificaciones: simplemente apunta la URL del registro a tu VPS.

Funcionalidades clave

Proxy de npmjs.org — almacena paquetes en caché para que las builds de CI nunca fallen por cortes del registro.
Publicación de paquetes privados — publica y versiona tus librerías internas sin exponerlas al registro público.
Soporte multicliente — funciona con npm, Yarn y pnpm sin ningún cambio en la configuración del cliente.
Despliegue en contenedor único ligero — funciona con menos de 128 MB de RAM en un VPS ServOrbit.
Control de acceso por token — crea cuentas y tokens API para restringir quién puede leer o publicar en cada scope.
Modo sin conexión — sirve paquetes en caché sin internet para builds reproducibles en entornos aislados.

¿Cuándo usar esta solución?

1

Registro privado para tu equipo

Publica librerías JavaScript internas bajo tu propio namespace. Cualquier desarrollador las instala igual que los paquetes públicos — sin URLs Git manuales ni copiar y pegar.

2

Caché fiable para CI

Proxifica npmjs.org a través de Verdaccio y almacena en caché cada paquete descargado. Si el registro público cae durante una build, Verdaccio sirve la versión en caché de forma transparente.

3

Entornos sin conexión

Precarga la caché con una instalación con internet y luego desconéctala. Verdaccio sigue sirviendo todos los paquetes vistos previamente sin necesidad de internet.

Desplegar Verdaccio en su VPS

Guía optimizada para los VPS Cloud ServOrbit.

01

Conectar al registro

Verdaccio no necesita dominio. Abre un túnel SSH: ssh -L 4873:127.0.0.1:<port> root@<vps-ip>, luego apunta npm al túnel: npm set registry http://localhost:4873. Para acceso permanente del equipo, adjunta un dominio desde el panel de ServOrbit.

02

Crear tu primer usuario

Ejecuta npm adduser --registry http://localhost:4873. Introduce un nombre de usuario, contraseña y correo. Este primer usuario se convierte en administrador del registro.

03

Publicar un paquete privado

En el directorio de tu paquete, ejecuta npm publish --registry http://localhost:4873. El paquete se almacena en el VPS y queda disponible para cualquier desarrollador o sistema CI autenticado.

04

Configurar reglas de scope proxy (opcional)

Edita config.yaml dentro del volumen del contenedor para enrutar scopes específicos a tu registro privado y el resto a npmjs.org. Reinicia el contenedor para aplicar los cambios.

Preguntas frecuentes

No. Verdaccio proxifica npmjs.org por defecto — las solicitudes de paquetes no presentes en el registro local se reenvían al registro público, se almacenan en caché y se sirven. Puedes seguir usando todos los paquetes públicos con normalidad.

Poner en marcha rápidamente un proyecto de software.

Verdaccio todavía no se puede pedir.

La instalación automática de esta solución está lista y ahora mismo está pasando nuestras pruebas en un servidor real. El pedido se abrirá en cuanto termine la validación.

¿Necesita ayuda?

Consulte nuestro centro de ayuda y nuestra FAQ, o contacte con nuestro equipo: llamada, WhatsApp o correo electrónico. Soporte en francés, inglés y árabe.

Escribir por WhatsAppse abre en una pestaña nueva