Розгорніть Node.js-застосунок на хостингу Rivervo (Next.js і Nuxt).
Багато хто вважає, що 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.
| Поле | Значення |
|---|---|
| Version | 20 або новіша |
| Mode | Production |
| Folder | myapp у вашій домашній папці (куди ви завантажили файли) |
| Адреса | vashdomen.com.ua (або субдомен, наприклад app.vashdomen.com.ua) |
| Start file | server.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 без величезного трафіку цієї інструкції цілком достатньо.
Коротко
npm run buildлокально- Завантажте
.next/(Next) або.output/(Nuxt) +package.json+server.cjs - Сайт → Node.js і Python → Node.js application → папка, файл запуску
server.cjs, режим Production - Install dependencies (npm install), потім Restart
Якщо щось працює не так, створіть тікет — вставте сторінку помилки Passenger, і ми вкажемо на потрібний рядок.
— Команда Rivervo