Node.js

Как Railpack определяет приложениеСкопировать ссылку

Приложение распознаётся по package.json в корне (или в пути сборки).

Менеджер пакетов определяется так:

1. Поле packageManager в package.json (версия ставится через Corepack).
2. Lock-файл: pnpm-lock.yaml, bun.lock/bun.lockb, yarn.lock, .yarnrc.yml.
3. По умолчанию — npm.

Команда запуска выбирается так:

1. Скрипт start в package.json.
2. Поле main в package.json.
3. Файл index.js или index.ts в корне.

Если есть скрипт build, он выполняется при сборке.

ПортСкопировать ссылку

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

const port = Number(process.env.PORT ?? 3000);
app.listen(port, '0.0.0.0');

Добавьте приложению переменную PORT со значением порта контейнера из домена (по умолчанию 3000).

Версия Node.jsСкопировать ссылку

Берётся из (по приоритету): переменной RAILPACK_NODE_VERSION, engines.node в package.json, .nvmrc, .node-version, mise.toml или .tool-versions. По умолчанию — 22.

Для Bun версия задаётся RAILPACK_BUN_VERSION или файлом .bun-version.

МонорепозиторииСкопировать ссылку

Railpack поддерживает workspaces npm, yarn, bun и pnpm (pnpm-workspace.yaml), а также Nx.

• Если нужен конкретный пакет, задайте скрипты build и start в корневом package.json или переопределите команды в настройках «Сборка и запуск».
• В Nx с несколькими приложениями укажите переменную RAILPACK_NX_APP (например, web или apps/web).

Полезные переменные RailpackСкопировать ссылку

При запуске выставляются NODE_ENV=production и CI=true.

Частые проблемыСкопировать ссылку