Почати
Усі статтіІНСТРУКЦІЇ · 7 ХВ ЧИТАННЯ

Розгорніть Node.js-застосунок на хостингу Rivervo (Next.js і Nuxt).

RT
Rivervo Team · Rivervo
·
29 квітня 2026 р.
·
Оновлено 13 листопада 2026 р.
Node
ON SHARED HOSTING

Багато хто вважає, що Node.js-застосункам потрібен VPS. Це не так — у кожному тарифі віртуального хостингу Rivervo в меню сайту є розділ Node.js і Python, який запускає для вашого застосунку процес Phusion Passenger за тим самим фронтендом Apache, що обслуговує інші ваші сайти.

У цій інструкції ми пройдемо весь шлях для двох найпопулярніших фреймворків: Next.js і Nuxt 3. Результат: ваш застосунок за адресою https://vashdomen.com.ua (або на будь-якому субдомені) працює на справжньому процесі Node.js, переживає перезавантаження й перезапускається одним кліком.

Якщо ви ще ніколи не розгортали Node-застосунок на віртуальному хостингу, усі зазвичай спотикаються на файлі запуску — Passenger потрібен один вхідний скрипт, який запускає ваш фреймворк. Нижче ми наводимо такий файл для кожного фреймворку: скопіюйте й вставте, нічого не змінюючи.

Що потрібно перед початком

  • Тариф хостингу Rivervo (будь-який — Node.js-застосунки працюють на всіх тарифах)
  • Node.js v20 або новіший локально, щоб зібрати застосунок
  • Зібраний застосунок, готовий до завантаження (для кожного фреймворку розповімо нижче)
  • Доступ до акаунта через файловий менеджер або SFTP (підходить і те, й інше)

Вам не потрібні root, sudo, systemd чи налаштування зворотного проксі. Усе це бере на себе 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.
  • Запускає HTTP-сервер на порту, який призначає Passenger (process.env.PORT).
  • Для локального тестування використовує запасний порт 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}`)
    })
  })
})

Що він робить:

  • Динамічно імпортує .output/server/index.mjs з Nuxt (вхідну точку, створену npm run build).
  • Через createApp() створює екземпляр сервера H3.
  • Слухає порт, призначений Passenger.

Динамічний import() використано навмисно — модулі .mjs не можна підключити через require(), але файл .cjs може імпортувати їх динамічно. Це найчистіший шаблон, який працює в лаунчері Passenger.

Крок 4 — створіть застосунок у панелі

Відкрийте свій проєкт → Сайт → Node.js і Python → Node.js application.

ПолеЗначення
Version20 або новіша
ModeProduction
Foldermyapp у вашій домашній папці (куди ви завантажили файли)
Адресаvashdomen.com.ua (або субдомен, наприклад app.vashdomen.com.ua)
Start fileserver.cjs

Натисніть Створити. У ~/nodevenv/myapp/20/ буде створено середовище Node.js.

Встановіть залежності

Коли застосунок створено, натисніть на ньому Install dependencies (npm install) і стежте за виводом. Якщо сталася помилка:

  • Перевірте, що package.json лежить у корені застосунку (а не у вкладеній папці).
  • Для Next.js: переконайтеся, що next є в dependencies, а не в devDependencies (робоча інсталяція пропускає dev-залежності).
  • Для Nuxt: сам nuxt теж має бути звичайною залежністю.

Додайте змінні середовища

Налаштування застосунку → Environment variables → Add a variable. Режим Production уже встановлює NODE_ENV=production.

Для застосунків на Next.js, які читають значення під час роботи (адреси баз даних, API-ключі), додайте їх тут. Не викладайте файл .env із секретами — правильне місце для них — змінні середовища застосунку.

Збереження налаштувань перезапускає застосунок, тож нові змінні застосовуються одразу.

Крок 5 — перевірте

Відкрийте адресу застосунку. Ви маєте побачити свій застосунок.

Якщо бачите сторінку помилки Passenger, розгорніть її й подивіться вниз — там майже завжди є зрозумілий стек викликів. Дві найчастіші помилки:

Error: Cannot find module 'next' — npm install не запускався або запускався не в тій папці. Ще раз натисніть Install dependencies (npm install).

Error: ENOENT: no such file or directory, open '.next/...' — ви завантажили вихідний код, але не зібраний каталог .next/. Зберіть застосунок локально й завантажте знову.

Як розгортати оновлення

Повторіть кроки 1 і 2 та натисніть Restart на застосунку. Тобто:

1. Збірка локально   npm run build
2. Завантаження      .next/ або .output/, плюс змінений код/конфігурація
3. Панель            Перезапуск застосунку

Якщо ви змінили package.json, перед перезапуском натисніть Install dependencies (npm install). Віддаєте перевагу командному рядку? Сайт → Термінал: на картці застосунку показано команду для входу в його середовище.

Типові підводні камені

WebSockets: Passenger працює з HTTP/1.1 і HTTP/2. Перехід на WebSocket працює для вбудованих маршрутів Next.js і Nuxt. Якщо ви використовуєте окремий WebSocket-сервер (ws, socket.io), він ділить той самий порт і запускається тим самим server.cjs — без додаткових налаштувань.

Завантаження файлів / ліміти body-parser у next.config.js: за замовчуванням Passenger обмежує тіло запиту 10 МБ. Якщо завантажуєте великі файли, підвищте passenger_max_request_size через .htaccess у public_html:

PassengerMaxRequestSize 52428800

(50 МБ у байтах.)

Завдання cron: якщо застосунку потрібні фонові завдання (розсилки, заплановані експорти), не запускайте їх у вебпроцесі. Скористайтеся розділом Сайт → Завдання cron, щоб викликати Node-скрипт напряму:

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

Пам’ять процесу: Passenger перезапускає застосунок, якщо той перевищує ліміт RAM на акаунт (залежить від тарифу). Типовий застосунок на Next.js / Nuxt у спокої займає менше 100 МБ. Якщо впираєтеся в ліміти, профілюйте через process.memoryUsage() і шукайте витоки, перш ніж вирішувати, що потрібен більший тариф.

Власні домени й HTTPS: адреса, яку ви вказали для застосунку, — це те, до чого прив’язується Passenger. SSL налаштовується автоматично, без додаткових дій. Для іншого домену чи субдомену спершу додайте його в розділі Сайт → Домени, а потім оберіть як адресу застосунку.

Версія Node: у списку Version показано всі встановлені версії; змінити її можна в Налаштуваннях застосунку.

Коли віртуальний хостинг для 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 application → папка, файл запуску server.cjs, режим Production
  4. Install dependencies (npm install), потім Restart

Якщо щось працює не так, створіть тікет — вставте сторінку помилки Passenger, і ми вкажемо на потрібний рядок.

— Команда Rivervo