Aloita
Kaikki kirjoituksetOPAS · 6 MIN LUKUAIKA

Julkaise Node.js-sovelluksesi Rivervon webhotellissa (Next.js ja Nuxt).

RT
Rivervo Team · Rivervo
·
29. huhtikuuta 2026
·
Päivitetty 13. marraskuuta 2026
Node
ON SHARED HOSTING

Moni olettaa, että Node.js-sovellusten pitää asua VPS-palvelimella. Ei tarvitse – jokaisessa Rivervon webhotellipaketissa sivuston valikossa on Node.js ja Python, joka käynnistää sovelluksellesi Phusion Passenger -prosessin saman Apache-palvelimen taakse, joka palvelee muitakin sivustojasi.

Tämä opas käy läpi koko prosessin kahdelle yleisimmälle sovelluskehykselle: Next.js ja Nuxt 3. Lopputulos: sovelluksesi osoitteessa https://yritys.fi (tai missä tahansa aliverkkotunnuksessa) oikeassa Node.js-prosessissa, joka selviää uudelleenkäynnistyksistä ja jonka voi käynnistää uudelleen yhdellä napsautuksella.

Jos et ole ennen julkaissut Node-sovellusta webhotelliin, kohta, johon kaikki jäävät jumiin, on käynnistystiedosto – Passenger tarvitsee yhden aloitusskriptin, joka käynnistää sovelluskehyksesi. Annamme alla sellaisen kummallekin kehykselle; kopioi ja liitä, muokkauksia ei tarvita.

Mitä tarvitset ennen aloittamista

  • Rivervon webhotellipaketti (mikä tahansa taso – Node.js-sovellukset toimivat kaikissa paketeissa)
  • Node.js v20 tai uudempi omalla koneellasi sovelluksen kääntämiseen
  • Käännetty sovellus valmiina ladattavaksi (käymme tämän läpi kehyskohtaisesti)
  • Tiedostonhallinnan tai SFTP:n käyttöoikeus tiliisi (kumpi tahansa käy)

Et tarvitse root-oikeuksia, sudoa, systemd:tä tai käänteisvälityspalvelimen asetuksia. Passenger hoitaa kaiken tämän.

Vaihe 1 – käännä sovellus omalla koneellasi

Lataat palvelimelle käännetyn sovelluksen, et lähdekoodia. Paneeli asentaa riippuvuudet, mutta se ei käännä Reactia eikä aja Vite-käännöstä. Tee se ensin omalla koneellasi.

Next.js:

npm ci
npm run build

Tämä tuottaa hakemiston .next/ (käännetty tulos). Älä aja next start tässä – käynnistämme sen hetken päästä käynnistystiedostosta.

Nuxt 3:

npm ci
npm run build

Tämä tuottaa hakemiston .output/ (Nuxtin yleinen käännöshakemisto). Sama juttu – älä aja vielä mitään.

Vaihe 2 – lataa oikeat tiedostot

node_modules/-hakemistoa ei tarvitse ladata. Paneeli asentaa riippuvuudet puolestasi. Et tarvitse myöskään gitiä tai käännösvälimuisteja.

Lataa tiedostot tilillesi, mieluiten polkuun public_html-hakemiston ulkopuolelle (esim. /home/<tili>/myapp/). Miksi ulkopuolelle? Koska Passenger liittää public_html-hakemiston automaattisesti osoitteen juureen, ja sovelluskoodin sijoittaminen sinne paljastaa sen.

KehysLataa nämäOhita
Next.js.next/, public/, package.json, package-lock.json, next.config.js, oma server.cjs (alla)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, oma server.cjs (alla)node_modules/, .nuxt/, .git/, lähdekoodin pages/, components/

Tiedostot saa palvelimelle kahdella tavalla:

  • Sivusto → Tiedostot → lataa zip-tiedosto → pura se on helpoin, jos yhteytesi on epävakaa.
  • SFTP (FileZilla, Cyberduck, rsync) on nopeampi toistuvissa julkaisuissa. Palvelin, portti, käyttäjätunnus ja salasana löytyvät kohdasta Sivusto → SSH ja SFTP.

Vaihe 3 – lisää käynnistystiedosto

Tämän tiedoston Passenger suorittaa, kun pyyntö saapuu. Sijoita se package.json-tiedoston viereen sovelluskansioosi.

Next.js – server.cjs

const next = require('next')
const http = require('http')
 
const port = process.env.PORT || 3000
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev, dir: __dirname })
const handle = app.getRequestHandler()
 
app.prepare().then(() => {
  http.createServer((req, res) => handle(req, res)).listen(port, () => {
    console.log(`Next.js server listening on port ${port}`)
  })
})

Mitä se tekee:

  • Lataa Nextin ja osoittaa sen nykyiseen hakemistoon (jossa .next/ ja package.json ovat).
  • Luo pyyntöjen käsittelijän Nextin sisäisestä reitittimestä.
  • Käynnistää HTTP-palvelimen Passengerin antamaan porttiin (process.env.PORT).
  • Käyttää paikallisessa testauksessa varaporttina 3000.

dev määräytyy automaattisesti NODE_ENV-arvosta – valitse paneelissa Production-tila (teemme sen vaiheessa 4), niin Next toimii tuotantotilassa.

Nuxt 3 – server.cjs

import('./.output/server/index.mjs').then(({ createApp }) => {
  createApp().then(({ app }) => {
    const port = process.env.PORT || 3000
    app.listen(port, () => {
      console.log(`Nuxt server listening on port ${port}`)
    })
  })
})

Mitä se tekee:

  • Tuo dynaamisesti Nuxtin tiedoston .output/server/index.mjs (komennon npm run build tuottama aloituspiste).
  • Luo createApp()-funktiolla H3-palvelimen instanssin.
  • Kuuntelee Passengerin antamaa porttia.

Dynaaminen import() on tarkoituksellinen – .mjs-moduuleja ei voi ladata require()-funktiolla, mutta .cjs-tiedosto voi tuoda ne dynaamisesti. Tämä on siistein tapa, joka toimii Passengerin käynnistimessä.

Vaihe 4 – luo sovellus paneelissa

Avaa projektisi → Sivusto → Node.js ja Python → Node.js-sovellus.

KenttäArvo
Versio20 tai uudempi
TilaProduction
Kansiomyapp kotikansiossasi (johon latasit tiedostot)
Osoiteyritys.fi (tai aliverkkotunnus, kuten app.yritys.fi)
Käynnistystiedostoserver.cjs

Valitse Luo. Node.js-ympäristö luodaan polkuun ~/nodevenv/myapp/20/.

Asenna riippuvuudet

Kun sovellus on luotu, valitse sen kohdalla Asenna riippuvuudet (npm install) ja seuraa tulostetta. Jos asennus epäonnistuu:

  • Tarkista, että package.json on sovelluksen juuressa (ei alikansiossa).
  • Next.js: varmista, että next on kohdassa dependencies eikä devDependencies (tuotantoasennus ohittaa kehitysriippuvuudet).
  • Nuxt: myös nuxt-paketin pitää olla tavallinen riippuvuus.

Lisää ympäristömuuttujat

Sovelluksen Asetukset → Ympäristömuuttujat → Lisää muuttuja. Production-tila asettaa jo NODE_ENV=production.

Lisää tänne Next.js-sovelluksille ajonaikana luettavat arvot (tietokantojen osoitteet, API-avaimet). Älä toimita salaisuuksia .env-tiedostossa – sovelluksen ympäristömuuttujat ovat oikea paikka.

Asetusten tallentaminen käynnistää sovelluksen uudelleen, joten uudet muuttujat tulevat voimaan heti.

Vaihe 5 – tarkista

Avaa sovelluksesi osoite. Sinun pitäisi nähdä sovelluksesi.

Jos näet Passengerin virhesivun, avaa se ja katso alaosaa – siellä on lähes aina selkeä pinojäljitys. Kaksi yleisintä:

Error: Cannot find module 'next' – npm install ei ajautunut tai ajautui väärässä kansiossa. Valitse uudelleen Asenna riippuvuudet (npm install).

Error: ENOENT: no such file or directory, open '.next/...' – latasit lähdekoodin mutta et käännettyä .next/-hakemistoa. Käännä omalla koneellasi ja lataa uudelleen.

Näin julkaiset päivitykset

Toista vaiheet 1 ja 2 ja valitse sovelluksen kohdalla Käynnistä uudelleen. Tarkemmin:

1. Käännä omalla koneella    npm run build
2. Lataa                     .next/ tai .output/ sekä muuttuneet lähde- ja asetustiedostot
3. Paneeli                   Käynnistä sovellus uudelleen

Jos muutat package.json-tiedostoa, valitse Asenna riippuvuudet (npm install) ennen uudelleenkäynnistystä. Käytätkö mieluummin komentoriviä? Sivusto → Terminaali: sovelluksen kortissa näkyy komento, jolla pääset sen ympäristöön.

Yleiset sudenkuopat

WebSocketit: Passenger käsittelee HTTP/1.1:n ja HTTP/2:n. WebSocket-päivitys toimii Next.js:n ja Nuxtin sisäänrakennetuissa reiteissä. Jos käytät erillistä WebSocket-palvelinta (ws, socket.io), se jakaa saman portin ja käynnistyy samasta server.cjs-tiedostosta – lisäasetuksia ei tarvita.

Tiedostojen lataukset ja next.config.js:n body-parser-rajat: Passengerin oletusraja pyynnön rungolle on 10 Mt. Jos lataat isoja tiedostoja, nosta passenger_max_request_size-arvoa public_html-hakemiston .htaccess-tiedostossa:

PassengerMaxRequestSize 52428800

(50 Mt tavuina.)

Cron-tehtävät: jos sovelluksesi tarvitsee taustatehtäviä (uutiskirjeiden lähetys, ajastetut viennit), älä aja niitä verkkoprosessissa. Käytä kohtaa Sivusto → Cron-tehtävät ja kutsu Node-skriptiä suoraan:

/home/<tili>/nodevenv/myapp/20/bin/node /home/<tili>/myapp/scripts/send-newsletter.js

Prosessin muisti: Passenger käynnistää sovelluksesi uudelleen, jos se ylittää tilikohtaisen RAM-rajan (riippuu paketistasi). Tyypillinen Next.js- tai Nuxt-sovellus käyttää levossa alle 100 Mt. Jos rajat tulevat vastaan, profiloi process.memoryUsage()-funktiolla ja etsi muistivuotoja ennen kuin oletat tarvitsevasi isomman paketin.

Omat verkkotunnukset ja HTTPS: sovellukselle asettamasi osoite on se, johon Passenger sitoutuu. SSL on automaattinen – lisäasetuksia ei tarvita. Toista verkkotunnusta tai aliverkkotunnusta varten lisää se ensin kohdassa Sivusto → Verkkotunnukset ja valitse se sitten sovelluksen osoitteeksi.

Node-versio: Versio-luettelossa näkyvät kaikki asennetut versiot; vaihda versio sovelluksen Asetuksista.

Milloin webhotelli ei sovi Nodelle

Suoraan sanottuna – Node.js webhotellissa toimii erinomaisesti portfoliosivustoille, blogeille, markkinointisivuille, pienten SaaS-palvelujen käyttöliittymille ja sisäisille työkaluille. Vaikeuksia tulee näissä:

  • Suuren läpäisyn rajapinnat (jatkuvasti >50 pyyntöä/s) – tilikohtainen CPU-raja tuntuu
  • Paljon WebSocketeja käyttävät sovellukset, joilla on tuhansia samanaikaisia yhteyksiä
  • Sovellukset, jotka haarauttavat työprosesseja (jonotyöntekijät, haravoijat) – Passengerin tilikohtainen prosessikiintiö tekee tästä hankalaa
  • Kaikki, mikä tarvitsee systemd:tä, Dockeria tai root-oikeuksia

Niihin oikea valinta on VPS-palvelimemme – täydet root-oikeudet, oma ydin, ja se ajaa mitä haluat. Mutta useimmille Next.js- ja Nuxt-sovelluksille, joilla ei ole valtavaa liikennettä, tämä opas riittää.

Lyhyesti

  1. npm run build omalla koneella
  2. Lataa .next/ (Next) tai .output/ (Nuxt) + package.json + server.cjs
  3. Sivusto → Node.js ja Python → Node.js-sovellus → kansio, käynnistystiedosto server.cjs, tila Production
  4. Asenna riippuvuudet (npm install) ja sitten Käynnistä uudelleen

Jos jokin ei toimi, avaa tukipyyntö – liitä mukaan Passengerin virhesivu, niin osoitamme ongelmakohdan.

— Rivervon tiimi