Hoe host je Node.js op shared hosting? – (Stapsgewijze handleiding)

Node.js hosten op gedeelde hostingKies een provider die Node ondersteunt (meestal via de applicatiebeheerder van cPanel).CloudLinux Passenger), upload je app, installeer de afhankelijkheden met npm, stel het opstartbestand en de omgevingsvariabelen in en koppel een domein of subdomein.

Als je hostingprovider geen native Node-ondersteuning biedt, gebruik dan een extern Node-platform of upgrade naar een VPS. Het hosten van Node.js op shared hosting is mogelijk als je provider dit ondersteunt, maar dit brengt wel beperkingen met zich mee.

In deze handleiding laat ik je stap voor stap zien hoe je Node.js host op shared hosting met cPanel + Passenger, wat je moet doen als je host Node niet ondersteunt, en wanneer het slimmer is om een ​​VPS te gebruiken voor productieworkloads.

Kun je Node.js hosten op shared hosting?

Ja, als je shared hosting toepassingen CloudLinux en onthult De Node.js-app instellen in cPanel (Passagier). Het laat toe Apache Proxyverkeer naar je Node-app zonder aangepaste poorten te hoeven openen. Niet alle shared hostingproviders bieden dit aan. Zonder Passenger is het draaien van een publiekelijk toegankelijke Node-app lastig. server op gedeelde hosting is zelden haalbaar.

Wanneer gedeelde hosting werkt

Kies voor shared hosting als je app licht is of nog in ontwikkeling, weinig verkeer genereert, geen achtergrondprocessen nodig heeft en geen zware WebSocket-belastingen vereist. Het is prima geschikt voor kleine API's, dashboards, beheertools of leerprojecten.

Wanneer je een VPS nodig hebt

Kies voor een VPS als je PM2, aangepaste poorten, WebSockets op grote schaal, langlopende achtergrondtaken, native modules (buildtools) of voorspelbare prestaties nodig hebt. CPU/RAMVPS is ook geschikt CI / CD-pijpleidingen en microservices. Als gedeelde hosting te klein wordt, kunt u migreren naar een managed VPS is eenvoudig.

Voorwaarden en checklist

• Shared hosting met Node.js-ondersteuning (cPanel Application Manager/CloudLinux Node.js Selector/Passenger).
• SSH toegang Of gebruik de cPanel Terminal om npm install uit te voeren.
• Compatibiliteit met Node.js-versies (bijv. Node 18/20 LTS).
• Het opstartbestand van de app (bijv. app.js/server.js) en een package.json-bestand met een startscript.
• Domein/subdomein gereed (bijv. api.example.com) en DNS toegang.
• Optioneel: Git-repository voor Vlotte implementaties via Git-versiebeheer van cPanel.

Methode 1: Node.js hosten op gedeelde hosting met cPanel + Passenger

Dit is de meest betrouwbare manier om Node.js te hosten op shared hosting. Passenger voert je app achter de schermen uit. Apache/Nginx en koppelt het aan uw domein zonder aangepaste poorten te openen.

1. Bereid een minimale Express-app voor.

Je app moet zich binden aan process.env.PORT als dit is ingesteld. Passenger stelt dit automatisch in. Hier is een minimaal voorbeeld:

// server.js
const express = require('express');
const app = express();

const PORT = process.env.PORT || 3000;

app.get('/', (req, res) => {
  res.send('Hello from Node.js on shared hosting via Passenger!');
});

app.listen(PORT, '127.0.0.1', () => {
  console.log(`Server listening on port ${PORT}`);
});

Zorg ervoor dat uw package.json een startscript bevat:

{
  "name": "shared-node",
  "version": "1.0.0",
  "main": "server.js",
  "type": "module",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "express": "^4.19.0"
  }
}

2. Maak de app aan in cPanel

• Log in bij cPanel.
• Open “Node.js-app instellen” of “Applicatiebeheer”.
• Klik op "Aanvraag aanmaken".
• Kies een Node.js-versie (bij voorkeur LTS zoals 18 of 20).
• Toepassingsmodus: Production.
• Applicatiehoofdmap: De map waarin uw app zich bevindt (bijvoorbeeld /home/user/apps/shared-node).
• Applicatie-URL/domein: Selecteer een domein of subdomein (bijvoorbeeld api.example.com).
• Opstartbestand van de applicatie: server.js (of het door u gekozen toegangspunt).
• Opslaan/Implementeren om de omgeving te creëren.

Na het aanmaken toont cPanel het pad naar de virtuele omgeving en de optie "NPM Installeren uitvoeren" of SSH Instructies. Gebruik ze om afhankelijkheden in de hoofdmap van de app te installeren.

3. Code uploaden en afhankelijkheden installeren

• Via bestand Manager: Upload een ZIP-bestand en pak het uit in de hoofdmap van de applicatie.
• Via Git: Gebruik "Git Version Control" in cPanel om uw repository naar de applicatiemap te klonen en updates op te halen.
• Via SSH/Terminal: Navigeer naar de hoofdmap van de applicatie en voer `npm install` uit.

# In cPanel Terminal or SSH
cd ~/apps/shared-node
npm ci --only=production
# or
npm install --production

4. Omgevingsvariabelen configureren (optioneel)

Voeg in de Node.js-appinterface sleutel/waarde-paren toe zoals NODE_ENV=production, API-sleutels en database-URL's. Commit geen geheimen naar Git; bewaar ze waar mogelijk in omgevingsvariabelen.

5. Opnieuw opstarten en testen

• Klik na elke wijziging op "Applicatie opnieuw starten" in cPanel.
• Bezoek je domein/subdomein. Je zou de reactie van je app moeten zien.
• Als je 503-fouten ziet, controleer dan de Passenger-logboeken en het pad naar het opstartbestand.

# Useful checks
node -v
cat ~/logs/<domain>.error.log
cat ~/apps/shared-node/passenger.log

Methode 2: Als uw shared hostingprovider geen Node.js ondersteunt

Sommige shared hostingproviders blokkeren aangepaste poorten en bieden Passenger niet aan. In dat geval kunt u geen openbare Node-server rechtstreeks beschikbaar stellen. Gebruik een van deze oplossingen.

Optie A: Extern Node-platform + uw domein

• Implementeer je Node-app op een platform zoals Render, Railway, Fly.io of iets dergelijks.
• Maak een subdomein aan (bijvoorbeeld api.example.com) in je shared hosting. DNS en verwijs het via CNAME naar je externe app.
• Bewaar statische bestanden (front-end) op gedeelde hosting; verwijs API-aanroepen door naar het subdomein.
• Stel CORS correct in en schakel HTTPS in. Veel platformen bieden gratis TLS aan.

Optie B: Upgraden naar een beheerde VPS

Een VPS geeft je volledige controle: kies de Node-versie, voer PM2 uit, schakel WebSockets in en schaal de resources. Als je project klantgericht is of cruciaal voor je omzet, dan is een VPS wellicht een betere optie. managed VPS is veiliger en sneller dan het buigen van gedeelde beperkingen.

At YouStable, wij adviseren NVMe-aangedreven managed VPS voor Node.jsJe krijgt root-toegang, geïsoleerde resources en hulp bij de installatie en migraties – ideaal wanneer je shared hosting ontgroeit.

Aanbevolen werkwijzen voor Node.js op gedeelde hosting

• Gebruik LTS: Kies knooppunt 18 of 20 voor veiligheid en stabiliteit.
• POORTafhandeling: Bind altijd aan process.env.PORT indien aanwezig.
• Productiemodus: Stel NODE_ENV=production in om prestatieoptimalisaties in te schakelen.
• Lichtgewicht afhankelijkheden: Vermijd zware native modules die buildtools vereisen.
• Logboekregistratie: Log naar bestanden of een eenvoudige externe service; vermijd uitgebreide consolelogs in een productieomgeving.
• Beveiliging: Bewaar geheimen in omgevingsvariabelen; valideer invoer; valideer gegevens; beperk het aantal verzoeken aan gevoelige routes.
• Statische caching: Statische assets serveren met caching-headers (front-end via Apache/LiteSpeed cache).
• Gezondheidscontroles: Voeg het /health-eindpunt toe voor uptime-controles.
• Vlotte herstarts: Gebruik de herstartfunctie van cPanel voor wijzigingen; vertrouw niet op langlopende achtergrondtaken op gedeelde servers.

Veelvoorkomende fouten oplossen

• 503-service niet beschikbaar: Het pad naar het opstartbestand is onjuist, de app is vastgelopen of er ontbreken afhankelijkheden. Controleer het opstartbestand in cPanel, voer npm ci uit en controleer passenger.log.
• De app stopt willekeurig: Gedeelde processen kunnen hergebruikt worden. Vermijd achtergrondtaken; houd de applicatie compact; overweeg een VPS voor daemons/wachtrijen.
• Kan geen native modules installeren: Gedeelde omgevingen missen vaak de benodigde buildtools. Vervang deze door pure JavaScript-alternatieven of stap over naar een VPS.
• Versie-inconsistentie van Node: Wijzig de Node-versie in cPanel zodat deze overeenkomt met het veld 'engines' van uw app; installeer de map 'node_modules' opnieuw.
• WebSockets werken niet: Sommige gedeelde stacks beperken upgradeverbindingen. Test met een eenvoudige WS-server; als deze onbetrouwbaar is, gebruik dan een VPS of een managed Knooppunthost.

Realistische verwachtingen en upgrademogelijkheden

Shared hosting is een kosteneffectieve manier om een ​​Node.js-app online te krijgen, maar het is niet ontworpen voor zware, stateful of latency-gevoelige services. Begin klein, valideer je app en monitor het gebruik. Wanneer je autoscaling, achtergrondprocessen of volledige controle nodig hebt, kun je overstappen naar shared hosting. managed VPS.

Als je het niet zeker weet, vraag dan specifiek aan je hostingprovider of ze "cPanel Node.js App" of "CloudLinux Passagier.” Als ze dat niet doen, verwijs dan je API naar een extern Node-platform of migreer naar een VPS. YouStable Wij kunnen u helpen bij het kiezen van het juiste plan en de migratie met minimale downtime te realiseren.

Stapsgewijze handleiding (cPanel + Passenger)

• Bereid je app voor met een opstartbestand en een startscript.
• Maak een Node.js-applicatie aan in cPanel, stel de Node-versie, de applicatiemap en het opstartbestand in.
• Code uploaden (file Manager of Git) in de toepassingsmap.
• Installeer de benodigde afhankelijkheden via npm in de virtuele omgeving van de app.
• Stel omgevingsvariabelen in (productie, API-sleutels, DB-URL).
• Koppel een domein of subdomein aan de app in cPanel.
• Start de app opnieuw op en controleer de logbestanden als er problemen optreden.

FAQ's