Héberger une application Node.js : Sites, Projects ou VPS

Une application Node.js a besoin d’un processus actif sur un serveur. Déposer ses fichiers sur un hébergement statique ne démarre pas ce processus. Avant de choisir un produit, vérifiez comment l’application démarre, quels services externes elle utilise et quelle part du serveur vous souhaitez administrer.

Hostbrid propose trois parcours distincts : Sites pour gérer une application Node.js associée à un domaine, Projects pour déployer des services depuis Git et un VPS pour administrer le système et ses conteneurs. Les workflows et les responsabilités diffèrent.

Examinez le projet avant de choisir

À la racine du dépôt, repérez package.json, le fichier d’entrée et la commande de démarrage. Vérifiez aussi si l’application a besoin de PostgreSQL, Redis, d’un stockage persistant, de tâches planifiées ou de variables secrètes. Le nom du framework ne prouve pas à lui seul que l’application est statique et ne détermine pas la taille du serveur.

Le processus doit écouter sur le port fourni par son environnement (PORT). Ne prenez pas le port de développement pour celui de production. Après le déploiement, testez l’URL publique et consultez les logs si l’application ne démarre pas. Une application qui fonctionne sur votre ordinateur peut encore échouer à l’installation des dépendances de production, à la résolution des routes ou à la connexion à une base de données.

Si vous utilisez Express

Express est un serveur Node : déposer ses fichiers comme site statique n’exécute pas ses routes. Cet extrait suppose que app est l’instance Express créée plus haut ; il exige PORT en production et n’utilise 3000 qu’en développement local :

const port = process.env.PORT ?? (process.env.NODE_ENV === 'development' ? 3000 : undefined);
if (!port) throw new Error('PORT must be configured');
app.listen(port);

Le guide Node Apps explique comment préparer le fichier d’entrée et utiliser PORT dans Sites. Ne supposez pas que le processus, le proxy ou le stockage se configurent de la même façon dans Projects et sur un VPS.

Choisissez le workflow adapté

Besoin	Produit à examiner	Points à vérifier
Envoyer des fichiers et gérer une application Node liée à un site	Sites	Le guide Node Apps demande un site existant, `package.json` et un fichier d’entrée. L’application utilise le domaine et, tant qu’elle est active, remplace le site précédent servi sur ce domaine. Une application est autorisée par domaine.
Déployer depuis Git à chaque envoi et connecter un service backend	Projects	Vérifiez l’offre en vigueur : les processus backend nécessitent une offre de service payante. Examinez les variables, les logs et toute base de données gérée ou externe utilisée.
Administrer Docker Compose, des paquets système ou toute la machine	VPS	Vous prenez en charge la configuration, les mises à jour, la sécurité, les sauvegardes et l’exploitation du système. Mesurez la charge avant de choisir les ressources.

Si le dépôt ne produit que du HTML, du CSS et du JavaScript statiques, il n’a peut-être pas besoin d’un processus Node en production. Distinguez le serveur de compilation (build) de celui qui doit répondre aux requêtes (start). Le guide pour choisir un hébergement pour un site créé avec l’IA traite cette décision d’architecture.

Déployez sur Sites et vérifiez le domaine

La documentation Node Apps décrit le workflow Sites : créez d’abord le site, préparez package.json et le fichier d’entrée, puis gérez l’application depuis la section Node.js. L’installation des dépendances de production, le port, l’état d’exécution et les logs sont gérés dans ce parcours ; suivez les instructions actuelles du panneau pour votre application.

Avant de l’activer, confirmez le domaine sélectionné et ce qui y est déjà publié. L’application Node prend le domaine tant qu’elle est active ; si le site actuel doit rester accessible, utilisez un domaine de test séparé. Un chemin sur le même domaine n’empêche pas l’application de remplacer le site précédent. Après le démarrage, ouvrez l’URL publique dans une fenêtre privée, vérifiez les routes principales et consultez les logs. Vérifiez séparément si les données de l’application survivent aux redémarrages : ne supposez pas que le disque est persistant ou qu’une base de données est incluse sans confirmation du produit.

Évitez trois erreurs fréquentes

Le processus ne démarre pas : vérifiez le fichier d’entrée, la commande attendue et les dépendances de production.
Le déploiement démarre mais ne répond pas : faites écouter le serveur sur PORT et examinez les logs du processus.
Le site précédent disparaît : l’application peut occuper le domaine pendant son activité ; vérifiez-le avant de l’activer.

Si vous avez besoin de Git, de plusieurs services ou de ressources système, comparez Projects et VPS avant de déplacer le domaine. Pour diagnostiquer localement un processus Node avec Docker, consultez le guide sur le port, la santé et l’état ; ce diagnostic ne remplace pas les étapes de déploiement Sites.