Julkaise Node.js-sovelluksesi Rivervon webhotellissa (Next.js ja Nuxt).
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 buildTä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 buildTä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.
| Kehys | Lataa 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/japackage.jsonovat). - 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(komennonnpm run buildtuottama 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 |
|---|---|
| Versio | 20 tai uudempi |
| Tila | Production |
| Kansio | myapp kotikansiossasi (johon latasit tiedostot) |
| Osoite | yritys.fi (tai aliverkkotunnus, kuten app.yritys.fi) |
| Käynnistystiedosto | server.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.jsonon sovelluksen juuressa (ei alikansiossa). - Next.js: varmista, että
nexton kohdassadependencieseikä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 uudelleenJos 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.jsProsessin 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
npm run buildomalla koneella- Lataa
.next/(Next) tai.output/(Nuxt) +package.json+server.cjs - Sivusto → Node.js ja Python → Node.js-sovellus → kansio, käynnistystiedosto
server.cjs, tila Production - Asenna riippuvuudet (npm install) ja sitten Käynnistä uudelleen
Jos jokin ei toimi, avaa tukipyyntö – liitä mukaan Passengerin virhesivu, niin osoitamme ongelmakohdan.
— Rivervon tiimi