Een Node.js-applicatie draaien naast je website

Werk je met Node.js, dan kun je je eigen applicatie op je hostingpakket laten draaien. Wij starten de opdracht die je opgeeft, houden hem in de lucht en sturen bezoekers van je domein ernaartoe. Dit is bedoeld voor wie zelf software bouwt; voor een gewone website of WordPress heb je het niet nodig.

Waar vind ik dit?

1. Zet je bestanden eerst op je webruimte, via Bestandsbeheer, FTP of SSH.
2. Ga naar Hosting in je klantportaal.
3. Klik op je hostingpakket, klik in de balk op Website en kies Geavanceerd.
4. Klik bij Node.js op Node.js-applicaties beheren en daarna op Applicatie toevoegen.
5. Vul de velden in en klik op Opslaan.

Wat vul ik in?

• Startwijze: kies Automatisch voor iets dat live staat. Je applicatie wordt dan gestart en herstart vanzelf als hij vastloopt. Kies Handmatig als je zelf wilt bepalen wanneer hij draait; je start hem dan via SSH.
• Startopdracht: de opdracht die je normaal zelf zou intypen, bijvoorbeeld npm start.
• Node-versie: stable volgt vanzelf de nieuwste stabiele versie. Heeft je applicatie een bepaalde versie nodig, kies die dan uit de lijst. Staat die versie nog niet klaar, dan wordt hij bij het opslaan geïnstalleerd; dat duurt een paar minuten.
• Werkmap: de map waarin de opdracht wordt uitgevoerd, bijvoorbeeld httpdocs/app. Leeg laten betekent je hoofdmap.
• Pad: laat je dit leeg, dan gaat al het verkeer van je domein naar je applicatie. Vul je bijvoorbeeld /api in, dan alleen dat deel en blijft de rest van je website gewoon werken.
• Poort: de poort waarop je applicatie luistert. Kies iets boven 1024, bijvoorbeeld 3000.

Je applicatie moet op 0.0.0.0 luisteren

Dit is het punt waar het bijna altijd op misgaat. Veel voorbeeldcode laat een applicatie luisteren op 127.0.0.1 (ook wel localhost). Dat betekent: alleen bereikbaar vanuit de applicatie zelf. Onze webserver komt daar dan niet bij en je bezoekers krijgen een foutmelding.

Laat je applicatie luisteren op 0.0.0.0 en op dezelfde poort die je in het formulier hebt ingevuld. In een Express-applicatie ziet dat er zo uit:

app.listen(3000, '0.0.0.0')

Wij starten alleen jouw opdracht. Of er daarna iets op die poort antwoordt, bepaalt je eigen code.

Mijn website doet het niet meer

Heb je het pad leeg gelaten, dan gaat álles naar je applicatie, ook je gewone pagina's. Wil je dat niet, vul dan een pad in of zet Verkeer doorsturen naar je applicatie uit.

Hoe zie ik wat er misgaat?

Klik bij je applicatie op Logboek. Daar staat wat je applicatie zelf naar de uitvoer schrijft, inclusief foutmeldingen bij het opstarten. Staat er niets, dan is je applicatie nog niet aan schrijven toegekomen.

Live verbindingen (websockets)

Gebruikt je applicatie websockets, bijvoorbeeld voor een chat of live meldingen, zet dan Websockets toestaan aan. Zonder dat vinkje wordt zo'n verbinding geweigerd.

Weer weghalen

Klik op Verwijderen bij de applicatie. Hij wordt gestopt en de doorverwijzing vanaf je domein verdwijnt; je bestanden blijven gewoon staan.