Започнете

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

Проектите само с front-end — 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, се пазят между деплоите и се архивират ежедневно; всичко записано другаде изчезва след следващия деплой. За качени файлове и медия обикновено по-добрият избор е обектното хранилище.

Monorepo

За хранилище с няколко проекта задайте Папка на проекта при създаването на приложението (например apps/web). Друга папка от същото хранилище може да работи като отделна уеб услуга — вижте Услуги на проекта.

Още имате въпроси?

Пишете ни в чата — AI отговаря веднага, а инженер се включва, когато е нужно, по всяко време на денонощието.

Връзка с поддръжката