Déployer une app Node.js sur un VPS - systemd + Nginx, sans…

Pas à pas : Node.js 22 via NodeSource, utilisateur dédié, redémarrage auto avec systemd, reverse proxy Nginx et HTTPS. Commandes réelles, déploiement en 15 minutes.

Pas de Docker, pas de PaaS, pas de magie. Node.js plus systemd et Nginx : une pile qui survit aux redémarrages, aux plantages et au trafic - et que vous pouvez lire de bout en bout.

1. Installez Node.js

apt update && apt install -y curl
curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
apt install -y nodejs
node --version

2. Créez un utilisateur pour l’application

N’exécutez jamais une application web en root. Un utilisateur distinct limite les dégâts si l’application est un jour compromise.

adduser --system --group --home /opt/myapp app
mkdir -p /opt/myapp
chown app:app /opt/myapp

3. Envoyez l’application

Depuis votre ordinateur, avec rsync via SSH - pas besoin de serveur Git :

rsync -avz --exclude node_modules ./app/ root@YOUR_SERVER_IP:/opt/myapp/

Sur le serveur, installez les dépendances et testez une fois au premier plan :

cd /opt/myapp
sudo -u app npm ci --omit=dev
sudo -u app PORT=3000 node server.js

L’application doit écouter sur `127.0.0.1:3000` - pas sur l’interface publique. C’est Nginx qui fera face à Internet.

4. systemd la maintient en vie

cat > /etc/systemd/system/myapp.service <<'EOF'
[Unit]
Description=My Node.js app
After=network-online.target
[Service]
User=app
WorkingDirectory=/opt/myapp
Environment=NODE_ENV=production
Environment=PORT=3000
ExecStart=/usr/bin/node server.js
Restart=always
RestartSec=3
[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now myapp
systemctl status myapp

Plantage ? Elle redémarre en trois secondes. Redémarrage du serveur ? Elle démarre automatiquement. Nouvelle version à déployer ? `rsync`, puis `systemctl restart myapp`.

5. Nginx en frontal

apt install -y nginx
cat > /etc/nginx/sites-available/myapp <<'EOF'
server {
    listen 80;
    server_name example.com;
    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
EOF
ln -s /etc/nginx/sites-available/myapp /etc/nginx/sites-enabled/myapp
nginx -t && systemctl reload nginx

Faites ensuite pointer l’enregistrement A de votre domaine vers le serveur et ajoutez HTTPS - le pas à pas complet est dans le guide Nginx et HTTPS.

6. Consultez les journaux

journalctl -u myapp -f --no-pager
tail -f /var/log/nginx/error.log

La sortie console de votre application arrive automatiquement dans journald - aucun fichier de log à configurer.

Réponses rapides

Ai-je besoin de PM2 ?

Pas vraiment. systemd fait tout ce que PM2 fait pour un seul serveur - redémarrage automatique, démarrage au boot, journaux - sans dépendance supplémentaire. PM2 a surtout du sens si vous lancez plusieurs processus Node en cluster.

De combien de RAM une application Node a-t-elle besoin ?

Une application Express typique consomme environ 80 à 150 Mo au repos. Un serveur de 2 Go la fait tourner confortablement à côté de Nginx et PostgreSQL ; les étapes de build comme webpack sont gourmandes en mémoire, donc buildez en CI ou sur votre ordinateur.

Comment déployer une nouvelle version sans interruption ?

Faites un rsync du nouveau code, puis redémarrez - l’interruption est inférieure à une seconde, car systemd relance le processus immédiatement. Pour zéro interruption, il faudrait deux ports et basculer l’upstream Nginx, mais la plupart des projets n’en ont jamais besoin.

Cette pile tient confortablement sur un Core VPS 4 à 12 €/mois.

À lire aussi

Voir les offresGuidesFAQ