Почати

Застосунки на Node.js, Next.js і Nuxt.

Як ми розпізнаємо й запускаємо проєкти на Node.js: версія Node, менеджер пакетів, Next.js і Nuxt (сервер або статика), SvelteKit, Astro, Express та інші, змінна PORT і міграції Prisma.

3 ХВ ЧИТАННЯ

Репозиторій із файлом package.json — це проєкт на Node.js. Ми самі визначаємо фреймворк, менеджер пакетів і версію Node, збираємо й запускаємо проєкт — вам лишається тільки робити push.

Версія Node і менеджер пакетів

  • Node.js — береться з engines.node у package.json або з .nvmrc: найновіша з 24, 22, 20, 18 чи 16, що підходить. Якщо немає ні того, ні іншого, — Node.js 22.
  • Менеджер пакетів — за lock-файлом: pnpm-lock.yaml → pnpm, yarn.lock → yarn, інакше npm (npm ci, якщо є package-lock.json).
  • Збирання — скрипт build, якщо він є в package.json.

Фреймворки

ФреймворкЯк запускається
Next.jsяк сервер (next start) — серверний рендеринг, API-маршрути й middleware працюють як завжди
Next.js з output: 'export'як статичний сайт із out
Nuxtяк сервер (.output/server/index.mjs)
Nuxt з ssr: false і скриптом generateяк статичний сайт із .output/public
SvelteKitяк сервер з adapter-node; з adapter-static — як статичний сайт
Astroяк статичний сайт; з @astrojs/node — як сервер
NestJSdist/main.js після збирання
Express, Fastify, Koa, Hono та інші серверифайл зі scripts.start (node server.js), інакше main, інакше server.js, app.js, index.js або main.js

Проєкти лише з фронтендом — Vite, Create React App, Angular, Vue CLI та інші — обслуговуються як статичні сайти; див. Статичні сайти.

Слухайте порт із PORT

Сервер має слухати порт зі змінної PORT на всіх інтерфейсах:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js і Nuxt роблять це самі. Якщо ваш застосунок слухає фіксований порт, відвідувачі до нього не потраплять — тоді розгортання зупиниться на перевірці запуску, а попередня версія продовжить працювати.

Значення на етапі збирання

Змінні з вкладки Змінні потрапляють у запущений застосунок, а не в збирання. Значення, які збирання вписує в клієнтський код, — як-от NEXT_PUBLIC_… у Next.js або VITE_…, — читаються з вашого репозиторію, наприклад із закоміченого файлу .env.production. Серверний код читає вкладку Змінні як звичайно.

Власна команда запуску

Якщо визначений нами спосіб запуску вам не підходить, задайте Налаштування → Налаштування збирання → Команда запуску, наприклад node dist/server.js або npm run start:prod. Там само можна змінити команди встановлення й збирання.

Бази даних і Prisma

Додайте до проєкту PostgreSQL або MySQL і читайте DATABASE_URL — цю змінну задано за вас. Якщо в залежностях є Prisma, рекомендована команда релізу — npx prisma migrate deploy: вона виконується під час кожного розгортання, перш ніж нова версія почне приймати відвідувачів. Див. Розгортання.

Для черг на BullMQ додайте Valkey і використовуйте REDIS_URL. Обробник черги запускайте як фоновий процес — на вкладці Процеси або як окремий сервіс із власними ресурсами. Див. Сервіси проєкту.

Файли, що переживають розгортання

Кожне розгортання починається зі свіжої копії вашого репозиторію. Файли, які застосунок записує в /data, зберігаються між розгортаннями, і щодня з них робиться резервна копія; усе, що записано деінде, зникне після наступного розгортання. Для завантажень і медіафайлів зазвичай краще підходить об’єктне сховище.

Монорепозиторії

Якщо в репозиторії кілька проєктів, під час створення застосунку вкажіть Папку проєкту (наприклад, apps/web). Інша папка того самого репозиторію може працювати як окремий вебсервіс — див. Сервіси проєкту.

Залишилися питання?

Напишіть нам у чат — AI відповідає одразу, а інженер підключається за потреби в будь-який час доби.

Написати в підтримку