Бастау
Барлық жазбаларНҰСҚАУЛЫҚ · 6 МИН ОҚУ

Node.js қолданбасын Rivervo хостингіне орналастыру (Next.js және Nuxt).

RT
Rivervo Team · Rivervo
·
2026 ж. 29 сәуір
·
Жаңартылды 2026 ж. 13 қараша
Node
ON SHARED HOSTING

Node.js қолданбалары тек VPS-те жұмыс істей алады деп ойлайды. Олай емес — Rivervo-ның әр ортақ хостинг тарифінде сайт мәзірінде Node.js және Python бөлімі бар. Ол қолданбаңыз үшін басқа сайттарыңызға қызмет ететін Apache фронтының артында Phusion Passenger процесін іске қосады.

Бұл нұсқаулық ең кең таралған екі фреймворк — Next.js пен Nuxt 3 үшін бүкіл жолды көрсетеді. Нәтижесінде қолданбаңыз https://saitynyz.kz мекенжайында (немесе кез келген субдоменде) нақты Node.js процесінде жұмыс істейді, қайта жүктелуден кейін де қалады және бір батырмамен қайта іске қосылады.

Node қолданбасын ортақ хостингке бұрын орналастырмаған болсаңыз, бәрі тоқтайтын жер — іске қосу файлы. Passenger-ге фреймворкті іске қосатын бір кіру скрипті керек. Төменде әр фреймворк үшін біреуін береміз — көшіріп қойыңыз, өзгертудің қажеті жоқ.

Бастамас бұрын не керек

  • Rivervo хостинг тарифі (кез келгені — Node.js қолданбалары барлық тарифте жұмыс істейді)
  • Қолданбаны құрастыру үшін жергілікті v20 немесе жаңарақ Node.js
  • Жүктеуге дайын құрастырылған нұсқа (әр фреймворк үшін төменде айтамыз)
  • Аккаунтыңызға File Manager немесе SFTP арқылы қол жеткізу (екеуі де жарайды)

Сізге root, sudo, systemd немесе reverse-proxy баптауы керек емес. Мұның бәрін Passenger атқарады.

1-қадам — қолданбаны жергілікті құрастырыңыз

Сіз бастапқы кодты емес, құрастырылған қолданбаны жүктейсіз. Панель тәуелділіктерді орнатады, бірақ React-ті компиляцияламайды және Vite құрастыруын іске қоспайды. Мұны алдымен өз компьютеріңізде жасаңыз.

Next.js:

npm ci
npm run build

Нәтижесінде .next/ (құрастырылған нұсқа) пайда болады. Мұнда next start іске қоспаңыз — сәлден кейін оны іске қосу файлынан іске қосамыз.

Nuxt 3:

npm ci
npm run build

Нәтижесінде .output/ (Nuxt-тың әмбебап құрастыру каталогы) пайда болады. Мұнда да әзірге ештеңе іске қоспаңыз.

2-қадам — қажетті файлдарды жүктеңіз

node_modules/ жүктеудің қажеті жоқ. Тәуелділіктерді панель өзі орнатады. git пен құрастыру кэштері де керек емес.

Аккаунтыңызға, жақсысы public_html сыртындағы жолға жүктеңіз (мысалы, /home/<account>/myapp/). Неге сыртына? Себебі Passenger public_html-ді URL түбіріне автоматты түрде қосады, сондықтан қолданба кодын сонда салсаңыз, ол ашық қалады.

ФреймворкМыналарды жүктеңізӨткізіп жіберіңіз
Next.js.next/, public/, package.json, package-lock.json, next.config.js, server.cjs файлыңыз (төменде)node_modules/, .git/, .env.local
Nuxt 3.output/, package.json, package-lock.json, server.cjs файлыңыз (төменде)node_modules/, .nuxt/, .git/, бастапқы pages/, components/

Файлдарды жеткізудің екі жолы бар:

  • Сайт → Файлдар → zip жүктеу → оны ашу — байланысыңыз тұрақсыз болса, ең оңайы.
  • SFTP (FileZilla, Cyberduck, rsync) қайталама жаңартулар үшін жылдамырақ. Сервер, порт, пайдаланушы және құпиясөз Сайт → SSH және SFTP бөлімінде.

3-қадам — іске қосу файлын қосыңыз

Бұл — сұрау келгенде Passenger орындайтын файл. Оны қолданба қалтасында package.json жанына салыңыз.

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}`)
  })
})

Ол не істейді:

  • Next-ті жүктеп, оны ағымдағы каталогқа (.next/ пен package.json орналасқан жерге) бағыттайды.
  • Next-тің ішкі маршрутизаторынан сұрау өңдеушісін жасайды.
  • Passenger тағайындаған портта (process.env.PORT) HTTP серверін іске қосады.
  • Жергілікті тексеру үшін 3000 портын пайдаланады.

dev мәні NODE_ENV арқылы автоматты анықталады — панельде Production режимін орнатыңыз (мұны 4-қадамда жасаймыз), сонда Next жұмыс режимінде істейді.

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}`)
    })
  })
})

Ол не істейді:

  • Nuxt-тың .output/server/index.mjs файлын (npm run build жасаған кіру нүктесін) динамикалық түрде импорттайды.
  • H3 сервер данасын құру үшін createApp() пайдаланады.
  • Passenger тағайындаған портты тыңдайды.

Динамикалық import() әдейі қолданылған — .mjs модульдерін require() арқылы жүктеуге болмайды, бірақ .cjs файлы оларды динамикалық импорттай алады. Passenger іске қосқышында жұмыс істейтін ең таза тәсіл осы.

4-қадам — панельде қолданба жасаңыз

Жобаңызды ашыңыз → Сайт → Node.js және Python → Node.js қолданбасы.

ӨрісМәні
Нұсқа20 немесе жаңарақ
РежимProduction
Қалтаүй қалтаңыздағы myapp (файлдарды жүктеген жер)
Мекенжайsaitynyz.kz (немесе app.saitynyz.kz сияқты субдомен)
Іске қосу файлыserver.cjs

Құру батырмасын басыңыз. ~/nodevenv/myapp/20/ ішінде Node.js ортасы жасалады.

Тәуелділіктерді орнатыңыз

Қолданба жасалған соң, оның Тәуелділіктерді орнату (npm install) батырмасын басып, шығысты бақылаңыз. Сәтсіз болса:

  • package.json қолданба түбірінде екенін (ішкі қалтада емес) тексеріңіз.
  • Next.js үшін: next devDependencies емес, dependencies ішінде екенін тексеріңіз (жұмыс орнатуы әзірлеу тәуелділіктерін өткізіп жібереді).
  • Nuxt үшін: nuxt өзі де қалыпты тәуелділік болуы керек.

Орта айнымалыларын қосыңыз

Қолданбаның Баптаулар → Орта айнымалылары → Айнымалы қосу. Production режимі NODE_ENV=production мәнін өзі орнатады.

Жұмыс кезінде мәндерді оқитын Next.js қолданбалары үшін (дерекқор URL-дері, API кілттері) оларды осында қосыңыз. Құпия деректері бар .env файлын жүктемеңіз — оларға дұрыс орын қолданбаның орта айнымалылары.

Баптауларды сақтағанда қолданба қайта іске қосылады, сондықтан жаңа айнымалылар бірден қолданылады.

5-қадам — тексеріңіз

Қолданбаңыздың URL-ін ашыңыз. Қолданбаңызды көруіңіз керек.

Passenger қате бетін көрсеңіз, оны ашып, төменгі жағын қараңыз — онда әдетте анық стек ізі болады. Ең жиі кездесетін екеуі:

Error: Cannot find module 'next' — npm install іске қосылмаған немесе басқа қалтада іске қосылған. Тәуелділіктерді орнату (npm install) батырмасын қайта басыңыз.

Error: ENOENT: no such file or directory, open '.next/...' — бастапқы кодты жүктегенсіз, бірақ құрастырылған .next/ каталогын жүктемегенсіз. Жергілікті құрастырып, қайта жүктеңіз.

Жаңартуларды қалай шығаруға болады

1 және 2-қадамдарды қайталап, қолданбаның Қайта іске қосу батырмасын басыңыз. Нақтырақ:

1. Жергілікті құрастыру    npm run build
2. Жүктеу                  .next/ немесе .output/, сондай-ақ өзгерген код/баптаулар
3. Панель                  Қолданбаны қайта іске қосу

package.json өзгерсе, қайта іске қоспас бұрын Тәуелділіктерді орнату (npm install) батырмасын басыңыз. Командалық жолды ұнатасыз ба? Сайт → Терминал: қолданба карточкасы оның ортасына кіру командасын көрсетеді.

Жиі кездесетін тұзақтар

WebSockets: Passenger HTTP/1.1 мен HTTP/2-ні өңдейді. WebSocket upgrade Next.js пен Nuxt-тың кірістірілген маршруттарында жұмыс істейді. Бөлек WebSocket серверін (ws, socket.io) пайдалансаңыз, ол сол портты бөліседі және сол server.cjs арқылы іске қосылады — қосымша баптау қажет емес.

Файл жүктеу / next.config.js body-parser шектеулері: Passenger-дің әдепкі сұрау денесі шегі 10 МБ. Үлкен файлдар жүктесеңіз, public_html ішіндегі .htaccess арқылы passenger_max_request_size мәнін көбейтіңіз:

PassengerMaxRequestSize 52428800

(Байтпен 50 МБ.)

Cron тапсырмалары: қолданбаңызға фондық тапсырмалар керек болса (таратылымдар, жоспарлы экспорттар), оларды веб-процесс ішінде іске қоспаңыз. Node скриптін тікелей шақыру үшін Сайт → Cron тапсырмалары бөлімін пайдаланыңыз:

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

Процесс жады: қолданбаңыз аккаунттың RAM шегінен асса (тарифке байланысты), Passenger оны қайта іске қосады. Әдеттегі Next.js / Nuxt қолданбасы бос тұрғанда 100 МБ-тан аз жұмсайды. Шекке жетсеңіз, үлкенірек тариф керек деп шешпес бұрын process.memoryUsage() арқылы профильдеп, жад ағуын іздеңіз.

Жеке домендер және HTTPS: қолданбаға орнатқан мекенжайды Passenger байланыстырады. SSL автоматты — қосымша баптау қажет емес. Басқа домен немесе субдомен үшін алдымен оны Сайт → Домендер бөліміне қосып, содан кейін қолданбаның мекенжайы ретінде таңдаңыз.

Node нұсқасы: Нұсқа тізімі орнатылған барлық нұсқаны көрсетеді; оны қолданбаның Баптаулар бөлімінде ауыстырыңыз.

Node үшін ортақ хостингті қашан пайдаланбау керек

Ашығын айтсақ, ортақ хостингтегі Node.js портфолио сайттары, блогтар, маркетинг беттері, шағын SaaS фронттары, ішкі құралдар үшін тамаша жұмыс істейді. Мыналарға қиын:

  • Жоғары өткізу қабілетті API (тұрақты >50 сұрау/сек) — аккаунттың CPU шегін сезесіз
  • Мыңдаған қатар қосылымы бар WebSocket-ке негізделген қолданбалар
  • Жұмысшы процестерін тудыратын қолданбалар (кезек өңдеушілері, скраперлер) — Passenger-дің аккаунттағы процесс шегі мұны қиындатады
  • systemd, Docker немесе root қол жеткізуін қажет ететін кез келген нәрсе

Олар үшін VPS дұрыс таңдау — толық root, өз ядроңыз, қалағаныңызды іске қоса аласыз. Ал үлкен трафик көтермейтін Next.js пен Nuxt қолданбаларының көбі үшін осы нұсқаулық жеткілікті.

Қысқаша

  1. Жергілікті npm run build
  2. .next/ (Next) немесе .output/ (Nuxt) + package.json + server.cjs жүктеңіз
  3. Сайт → Node.js және Python → Node.js қолданбасы → қалта, іске қосу файлы server.cjs, режим Production
  4. Тәуелділіктерді орнату (npm install), содан кейін Қайта іске қосу

Бірдеңе дұрыс жұмыс істемесе, өтінім ашыңыз — Passenger қате бетін қойыңыз, біз нақты жолын көрсетеміз.

— Rivervo командасы