Déployer une application Node.js sur un VPS

Pourquoi déployer Node.js sur un VPS plutôt que sur une plateforme managée ?

Ce que vous gagnez avec un VPS pour Node.js

• Process Node.js persistant, idéal pour WebSocket, SSE et tâches longues sans cold start
• Redémarrage automatique en cas de crash et au reboot du serveur grâce à PM2
• Mode cluster pour exploiter tous les cœurs CPU du VPS sans changer votre code
• Reverse proxy Nginx devant Node pour le HTTPS, la compression et les fichiers statiques
• Workers de files d'attente (BullMQ, Agenda) et tâches planifiées qui tournent à côté de l'API, sur la même machine
• Plusieurs applications sur un seul VPS, chacune sur son port interne (3000, 3001…) et son sous-domaine derrière Nginx
• Rendu serveur de frameworks comme Nuxt ou Next.js, servis par le même socle Node.js et PM2
• Coût fixe et prévisible, sans facturation à la requête ni surprise de scaling
• Contrôle total de la version de Node.js et des dépendances système

Prérequis

Partir du template Node.js Stack

Déployer une application Node.js en production

1. 01

   Préparer le VPS et installer Node.js

   Sur un VPS Ubuntu 24.04, mettez le système à jour et installez une version LTS de Node via nvm (nvm install --lts) ou le dépôt NodeSource. Vérifiez : node -v et npm -v. Créez un utilisateur non-root dédié à l'application plutôt que de tout exécuter en root : c'est lui qui possédera le code, le fichier .env et les processus PM2. Avec le template Node.js Stack, Node.js, npm et PM2 sont déjà installés : ne gardez que la création de l'utilisateur.

2. 02

   Récupérer le code et builder

   Clonez votre dépôt sur le VPS, installez les dépendances de production (npm ci --omit=dev) et lancez le build si nécessaire (npm run build).

   Placez les variables sensibles dans un fichier .env non commité, lisible par le seul utilisateur de l'application (chmod 600 .env). Inutile d'ajouter une bibliothèque pour le lire : depuis Node.js 20.6, l'option --env-file charge ce fichier dans process.env au démarrage.

3. 03

   Préparer la base PostgreSQL

   Si l'application a besoin d'une base, créez un rôle et une base dédiés plutôt que de travailler avec le superutilisateur :

   sudo -u postgres createuser --pwprompt monapp
   sudo -u postgres createdb --owner=monapp monapp

   Renseignez ensuite DATABASE_URL=postgres://monapp:<mot-de-passe>@127.0.0.1:5432/monapp dans le .env. Comme PostgreSQL n'écoute qu'en local, aucun port de base de données n'est à ouvrir dans le pare-feu.

4. 04

   Lancer l'application avec PM2

   Installez PM2 globalement (npm install -g pm2, déjà fait sur le template) puis démarrez l'app depuis le dossier du projet, en demandant à Node de charger le .env :

   pm2 start app.js --name monapp -i max --node-args="--env-file=.env"

   Le flag -i max active le mode cluster sur tous les cœurs. PM2 relance automatiquement le process en cas de crash.

5. 05

   Activer le démarrage automatique au boot

   Générez le script systemd avec pm2 startup, lancé par l'utilisateur de l'application, exécutez avec sudo la commande affichée, puis figez l'état actuel avec pm2 save. Au prochain redémarrage du VPS, votre application sera relancée automatiquement, sans intervention.

6. 06

   Configurer Nginx en reverse proxy

   Installez Nginx s'il n'est pas déjà présent et créez /etc/nginx/sites-available/monapp, un virtual host qui proxifie vers le port local de Node. Les en-têtes Upgrade et Connection servent aux WebSocket, X-Forwarded-Proto indique à l'application que le client est en HTTPS :

   server {
       listen 80;
       server_name votre-domaine.com;
   
       location / {
           proxy_pass http://127.0.0.1:3000;
           proxy_http_version 1.1;
           proxy_set_header Upgrade $http_upgrade;
           proxy_set_header Connection 'upgrade';
           proxy_set_header Host $host;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
       }
   }

   Activez le site, retirez la page par défaut, testez la configuration puis rechargez :

   ln -s /etc/nginx/sites-available/monapp /etc/nginx/sites-enabled/
   rm /etc/nginx/sites-enabled/default
   nginx -t && systemctl reload nginx

7. 07

   Sécuriser en HTTPS avec Let's Encrypt

   Installez Certbot et son plugin Nginx, puis demandez le certificat :

   apt install certbot python3-certbot-nginx
   certbot --nginx -d votre-domaine.com

   Certbot obtient le certificat, configure la redirection HTTP→HTTPS et programme le renouvellement automatique. Votre application Node est désormais servie en HTTPS.

Centraliser la configuration dans ecosystem.config.js

module.exports = {
  apps: [
    {
      name: 'api',
      cwd: '/home/monapp/app',
      script: 'app.js',
      instances: 'max',
      exec_mode: 'cluster',
      node_args: '--env-file=.env',
      max_memory_restart: '500M',
      env: { NODE_ENV: 'production', PORT: 3000 }
    },
    {
      name: 'worker',
      cwd: '/home/monapp/app',
      script: 'worker.js',
      node_args: '--env-file=.env'
    }
  ]
}

Journaux : les lire, puis les faire tourner

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 50M
pm2 set pm2-logrotate:retain 7