Développement

Verdaccio

Verdaccio — registre npm/yarn privé self-hosted sur VPS.

Documentation officielle

À propos de Verdaccio

Hébergez votre propre registre npm/yarn/pnpm sur votre VPS : proxifiez npmjs.org, publiez vos packages privés et contrôlez les dépendances de vos projets JavaScript.

Ce qui est installé

Prêt au démarrage du VPS

OS compatibles
Distributions Linux au choix
Application
Verdaccio
Stack technique
DockerNode.js
RAM minimum
< 128 Mo
CPU minimum
1 vCPU
Port par défaut
4873
Accès
root par SSH

Fonctionnalités clés

  • Proxy de npmjs.org — mettez en cache les packages localement pour éviter les pannes de registre lors des builds CI.
  • Publication de packages privés — publiez et versionnez vos bibliothèques JavaScript internes sans les exposer au registre public.
  • Support multi-clients — fonctionne nativement avec npm, Yarn et pnpm sans aucune modification de la configuration cliente.
  • Déploiement en conteneur unique léger — moins de 128 Mo de RAM sur un VPS ServOrbit.
  • Contrôle d'accès par token — créez des comptes et des tokens API pour restreindre la lecture ou la publication par scope.
  • Mode hors ligne — sert les packages mis en cache sans connexion internet pour des builds reproductibles.

Quand utiliser cette solution ?

Registre privé pour votre équipe

Publiez vos bibliothèques JavaScript internes sous votre propre namespace. Chaque développeur les installe comme des packages publics — sans URL Git manuels ni copier-coller.

Cache fiable pour les pipelines CI

Proxifiez npmjs.org via Verdaccio et mettez en cache chaque package téléchargé. Si le registre public tombe pendant un build, Verdaccio sert la version en cache de manière transparente.

Environnements hors ligne

Préchauffez le cache avec une installation connectée, puis coupez l'accès internet. Verdaccio continue de servir tous les packages vus précédemment sans aucune connexion requise.

Guide

Déployer Verdaccio sur votre VPS

  1. Accéder au registre

    Verdaccio ne nécessite pas de nom de domaine. Ouvrez un tunnel SSH : ssh -L 4873:127.0.0.1:<port> root@<ip-vps>, puis pointez npm vers le tunnel : npm set registry http://localhost:4873. Pour un accès permanent à toute l'équipe, rattachez un domaine depuis votre espace client ServOrbit.

  2. Créer votre premier utilisateur

    Exécutez npm adduser --registry http://localhost:4873. Saisissez un nom d'utilisateur, un mot de passe et un e-mail. Ce premier utilisateur devient l'administrateur du registre.

  3. Publier un package privé

    Dans le répertoire de votre package, exécutez npm publish --registry http://localhost:4873. Le package est stocké sur le VPS et disponible pour tout développeur ou système CI authentifié.

  4. Configurer les règles de scope proxy (optionnel)

    Éditez config.yaml dans le volume du conteneur pour router les scopes spécifiques (ex. @acme/*) vers votre registre privé et tous les autres vers npmjs.org. Redémarrez le conteneur pour appliquer : docker compose restart verdaccio.

Questions fréquentes

Questions sur Verdaccio

← Retour à DéveloppementToutes les applications
Non. Verdaccio proxifie npmjs.org par défaut — les demandes de packages absents du registre local sont transmises au registre public, mises en cache puis servies. Vous pouvez continuer à utiliser tous les packages publics normalement.

Intégrer le bouton de déploiement

Vous maintenez un projet qui utilise Verdaccio ? Ce bouton permet à vos lecteurs de le déployer sur un VPS en un clic, sans lire de documentation Docker.

Deploy Verdaccio on ServOrbit
Markdown
[![Deploy Verdaccio on ServOrbit](https://servorbit.com/brand/deploy/button.svg)](https://servorbit.com/vps-cloud?template=verdaccio&utm_source=deploy-badge&utm_medium=referral&utm_campaign=verdaccio)
HTML
<a href="https://servorbit.com/vps-cloud?template=verdaccio&utm_source=deploy-badge&utm_medium=referral&utm_campaign=verdaccio"><img src="https://servorbit.com/brand/deploy/button.svg" alt="Deploy Verdaccio on ServOrbit" height="40"></a>

Le bouton pointe vers la commande d'un VPS avec le template présélectionné. L'image est servie depuis servorbit.com — rien à héberger de votre côté.

Solutions complémentaires

Développement

Gitea

Your own GitHub, self-hosted in minutes. Full Git platform with CI/CD (Gitea Actions), package registry and team permissions — without usage-based billing.

Développement

OneDev

Forge Git avec CI/CD visuel et Kanban intégrés dans un seul conteneur — sans abonnement par développeur ni service externe.

Déploiement Applicatif & DevOps

Semaphore UI

Interface web open source pour Ansible, Terraform et OpenTofu — exécutez, planifiez et suivez vos playbooks depuis un tableau de bord sans ligne de commande.

Besoin d'aide ?

Parcourez notre centre d'aide et notre FAQ, ou contactez notre équipe — rappel, WhatsApp ou e-mail.

Écrire sur WhatsApps'ouvre dans un nouvel onglet
ou nous écrire