Деплой NestJS на Railway с использованием Postgres и Docker

Хотите быстро и безболезненно задеплоить NestJS‑приложение на Railway? В этом материале мы разберём весь процесс: от подготовки Docker‑контейнера до подключения Postgres и настройки переменных окружения. Следуя шагам, вы сможете развернуть проект в продакшн всего за несколько минут.

Что понадобится перед началом

Прежде чем переходить к деплою, убедитесь, что у вас готовы необходимые инструменты и настройки.

• NestJS‑проект в рабочем состоянии
• Docker установлен локально
• Аккаунт на Railway
• База данных PostgreSQL (локальная или облачная)
• Готовый Dockerfile для сборки приложения

Подготовка Dockerfile

Корректно настроенный Dockerfile — основа стабильного развёртывания. Он определяет, как будет собран и запущен ваш сервис.

Базовая структура Dockerfile

Минимальный Dockerfile для NestJS выглядит так:

FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm install --production
COPY . .
RUN npm run build
CMD ["node", "dist/main.js"]

Рекомендации по оптимизации

• Используйте лёгкие образы, например alpine
• Разделяйте этапы сборки и запуска для ускорения билдов
• Не забывайте о файле .dockerignore

Настройка Railway

После подготовки Docker‑окружения можно переходить к конфигурации Railway.

Создание нового проекта

1. Зайдите в аккаунт Railway
2. Нажмите New Project
3. Выберите деплой через Deploy from GitHub или загрузку Dockerfile

Добавление PostgreSQL

Railway позволяет создать базу в несколько кликов.

• Перейдите в раздел Add Service
• Выберите PostgreSQL
• Скопируйте полученный URL подключения

Настройка переменных окружения

Чтобы приложение корректно работало, необходимо передать в Railway переменные окружения.

Основные переменные

• DATABASE_URL — строка подключения к Postgres
• PORT — порт, который Railway автоматически проксирует
• NODE_ENV=production

Добавление переменных в Railway

1. Перейдите в раздел Variables
2. Добавьте нужные ключи и значения
3. Перезапустите деплой при необходимости

Запуск и проверка деплоя

Когда всё настроено, Railway автоматически соберёт Docker‑образ и запустит сервис.

Что проверить после запуска

• Логи сборки в разделе Deployments
• Статус контейнера — должен быть Healthy
• Доступность API по выданному URL

Заключение

Деплой NestJS на Railway с использованием Docker и PostgreSQL — простой, быстрый и надёжный способ вывести ваш проект в продакшн. Освоив этот процесс, вы сможете запускать любые сервисы — от небольших API до сложных backend‑систем — всего в несколько шагов.