Node.js, Next.js и Nuxt приложения.
Как се разпознават и стартират Node.js проекти: версия на Node, мениджър на пакети, Next.js и Nuxt (сървър или статичен сайт), SvelteKit, Astro, Express и подобни, променливата PORT и миграции с Prisma.
Хранилище с 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 — като сървър |
| NestJS | dist/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). Друга папка от същото хранилище може да работи като отделна уеб услуга — вижте Услуги на проекта.