01
Comment Node.js fonctionne-t-il dans cPanel ?
Un site PHP réexécute ses fichiers depuis le début à chaque requête. Une application Node.js, elle, est un processus démarré une seule fois, qui répond aux requêtes entrantes avec le code chargé en mémoire. C'est pourquoi il ne suffit pas d'envoyer les fichiers : vous devez définir avec quelle version de Node.js et à partir de quel fichier le processus démarre. Cette définition se fait dans le gestionnaire d'applications, et le serveur web transmet à votre application les requêtes qui arrivent sur votre nom de domaine.
Côté serveur, vous disposez du serveur web LiteSpeed, de la couche de sécurité Imunify360 et de disques NVMe ; grâce au SSL gratuit, votre application s'ouvre en https. Chaque compte fonctionne dans son propre espace de ressources grâce à CloudLinux : la RAM et le processeur dont vous disposez sont les valeurs indiquées sur la ligne de votre offre dans le tableau. Vous exécutez les commandes dans l'écran cPanel → « Terminal », depuis le navigateur ; cette session est isolée par CageFS et ne donne pas d'accès root. Pour une connexion SSH directe depuis votre propre ordinateur, adressez-vous à l'équipe d'assistance.
02
Déployer une application Express : étape par étape
La procédure ci-dessous est décrite pour une API Express en un seul fichier ; vous procédez de la même façon avec Fastify, Koa ou tout autre framework Node.js.
- Préparez le code : au lieu d'écrire le port d'écoute en dur dans le code, lisez-le depuis une variable d'environnement (
app.listen(process.env.PORT || 3000)) ; chaque paquet que vous utilisez doit figurer dans package.json. - Envoyez les fichiers : récupérez le projet depuis votre dépôt avec Git dans l'écran cPanel → « Terminal », ou envoyez-le sous forme d'archive dans le gestionnaire de fichiers de cPanel (« File Manager ») et décompressez-le. N'envoyez pas le dossier
node_modules. - Créez l'application : dans l'écran « Setup Node.js App », choisissez la version de Node.js, le dossier de l'application, l'adresse de publication et le fichier de démarrage (par exemple
app.js ou server.js). - Installez les dépendances : cliquez sur le bouton « Run NPM Install », ou placez-vous dans le dossier de l'application dans l'écran cPanel → « Terminal » et exécutez
npm install --production. - Fournissez les réglages : placez
NODE_ENV=production, les informations de base de données et les clés d'API dans des variables d'environnement, pas dans le code. - Redémarrez et testez : redémarrez l'application et ouvrez l'adresse dans votre navigateur ; vérifiez la réponse en appelant un point de terminaison de votre API avec
curl.
03
Fichier de démarrage, variables d'environnement et redémarrage
Le fichier de démarrage est celui à partir duquel le processus est lancé. Dans les projets qui ont une étape de compilation, comme TypeScript, ce fichier n'est pas le code source mais la sortie compilée (par ex. dist/index.js) ; compilez d'abord avec npm run build, puis indiquez la sortie comme fichier de démarrage. Dans la plupart des projets, le compilateur (par ex. typescript) est une dépendance de développement ; il est souvent plus simple de compiler sur votre propre ordinateur et d'envoyer la sortie.
Les variables d'environnement permettent au même code de fonctionner avec des réglages différents sur votre ordinateur et sur le serveur. Lorsque NODE_ENV vaut production, Express met les templates en cache et n'affiche pas le détail des erreurs aux visiteurs. Ne placez pas de mots de passe dans votre dépôt Git ; utilisez un fichier .env qui reste hors du dépôt, ou une variable d'environnement.
Le code est chargé en mémoire au démarrage du processus. Une modification de votre code, un paquet que vous venez d'installer ou un réglage modifié ne sont pas pris en compte tant que vous n'avez pas redémarré l'application ; si votre modification n'apparaît pas, c'est la première chose à vérifier.
04
npm install --production et modules à compiler
L'option --production n'installe que les paquets nécessaires à l'exécution de l'application ; les outils de test et de développement ne sont pas téléchargés sur le serveur. Dans les versions récentes de npm, l'option --omit=dev fait la même chose.
Certains paquets compilent du code C/C++ à l'installation (node-gyp) ; bcrypt, sqlite3 et canvas en sont des exemples. La plupart de ces paquets téléchargent des fichiers précompilés pour les systèmes courants ; si aucun fichier adapté n'est trouvé, l'installation peut échouer à l'étape de compilation. Dans ce cas, essayez l'équivalent en JavaScript pur du paquet (par exemple, à la place de bcrypt, bcryptjs) ou adressez-vous à l'équipe d'assistance.
Ne transférez pas sur le serveur un dossier node_modules créé sous Windows : les fichiers compilés sont propres au système d'exploitation, et les offres d'hébergement reposent sur Linux. Installez toujours les dépendances sur le serveur.
05
Hébergement Next.js et sites statiques
Un site Next.js qui utilise le rendu côté serveur (SSR) ou des routes d'API a besoin d'un processus Node.js : les pages dynamiques sont générées dans ce processus au fil des requêtes ; le processus occupe donc de la mémoire en permanence et consomme du processeur à chaque requête dynamique. Dans le fichier next.config, le réglage output: 'standalone' produit un dossier qui ne contient que les paquets nécessaires, ainsi que, pour remplacer next start, un petit server.js exécutable ; les dossiers public et .next/static ne sont pas copiés automatiquement dans cette sortie et doivent être ajoutés à la main. Si vous ne savez pas comment relier cette structure au gestionnaire d'applications, adressez-vous à l'équipe d'assistance.
next build demande beaucoup plus de mémoire que le site en fonctionnement et peut buter sur la limite de RAM du compte. Il est plus confortable de compiler en dehors du serveur, de préférence dans un environnement Linux, par exemple dans un pipeline d'intégration continue (CI), puis d'envoyer la sortie. Les besoins d'un site en SSR variant selon le nombre de pages et le trafic, nous ne pouvons pas donner de chiffre précis ; si vous attendez un trafic important, HAN-DEV-3 ou HAN-DEV-4, mieux dotées en RAM, vous offrent une marge plus confortable.
Les sites sans code serveur (React avec Vite, Vue, Astro ou la sortie output: 'export' de Next.js) ne sont que des fichiers une fois compilés. Vous envoyez le contenu du dossier dist ou out dans le dossier public_html de votre domaine principal ; LiteSpeed sert directement les fichiers, et aucun processus Node.js n'est nécessaire. Pour un tel site, les offres d'hébergement web suffisent.
06
Quels projets conviennent, et lesquels nécessitent un VDS ?
Le critère est simple : si votre application répond à une requête web puis termine son travail, l'hébergement convient ; si elle doit fonctionner en continu, indépendamment des requêtes, il vous faut un VDS.
- Adapté : les API REST ou GraphQL écrites avec Express et Fastify, les back-ends d'applications mobiles, les services qui reçoivent des webhooks (notifications d'événements).
- Adapté : les petites applications web et les interfaces d'administration ; les sites Next.js en SSR, en tenant compte de leurs besoins en ressources.
- Non adapté : les bots Discord, car un bot maintient en permanence une connexion ouverte avec Discord. Utilisez un serveur pour bot Discord ou un VDS.
- Non adapté : les services de chat en direct, de jeu et de notification qui reposent sur des connexions WebSocket ouvertes en permanence ; les longues tâches d'arrière-plan comme les workers de file d'attente, le traitement vidéo et le scraping de données.
- Non adapté : les projets qui fonctionnent avec Docker ; Docker et l'accès root nécessitent un serveur VDS. Si vous voulez un outil basé sur Node.js, comme n8n, sur un serveur où il est préinstallé, consultez la page serveur n8n.
07
Choisir l'offre : RAM, limite CPU et base de données
La limite CPU du tableau est une mesure de CloudLinux : 200 % correspond à une puissance de calcul de deux cœurs de processeur, 800 % à celle de huit cœurs. La limite de RAM est commune à tous les processus du compte ; votre application en cours d'exécution, les installations npm et, le cas échéant, votre site PHP puisent dans la même réserve. Pour une seule API, HAN-DEV-1 est un point de départ suffisant ; si vous comptez publier plusieurs applications ou domaines, regardez la RAM et la colonne « Sites supplémentaires ».
Les offres comprennent MySQL et phpMyAdmin ; vous vous y connectez depuis Node.js avec un pilote comme mysql2 ou un ORM comme Sequelize. PHP (jusqu'à 8.5), Python (3.11–3.13), Composer 2 et Git sont aussi utilisables sur le même compte. Si vous avez besoin d'un autre moteur de base de données, interrogez l'équipe d'assistance avant de commander.
08
Sauvegarde, paiement et migration
Les comptes d'hébergement sont sauvegardés automatiquement chaque nuit, et les sauvegardes des 3 derniers jours sont conservées. C'est une facilité ; conservez aussi votre propre copie : votre code dans votre dépôt Git, votre dump de base de données sur votre propre ordinateur.
Vous pouvez payer par carte (iyzico), par virement bancaire ou avec le solde du compte ; une fois le paiement confirmé, votre compte est créé automatiquement. Aucun remboursement n'est effectué ; un compte échu est suspendu et, s'il n'est pas payé sous 2 jours, il est résilié et supprimé avec ses données (politique de remboursement et de résiliation). Pour un compte d'hébergement que vous avez chez un autre hébergeur, vous pouvez faire une demande via le formulaire de migration gratuite.