Как задеплоить проект из Cursor на свой сервер

Cursor отлично помогает написать код, но выкладка на сервер — отдельная дисциплина, и ИИ здесь часто советует половину шагов. Итог знакомый: сайт открывается, пока открыт терминал, падает ночью и теряет HTTPS через три месяца. Ниже — как выглядит нормальный деплой и что можно проверить самому.

Почему так происходит

В Cursor вы работаете в режиме разработки: горячая перезагрузка, ключи в локальном .env, база на localhost. На сервере всё иначе: нет вашего .env, порт закрыт firewall, процесс никто не перезапустит, а браузеры требуют HTTPS. ИИ видит только код проекта и не знает, какой у вас сервер, поэтому выдаёт общие инструкции, которые ломаются на первой же отличающейся детали.

Что проверить самому

1. В package.json есть скрипты build и start, и npm run build && npm start работает у вас локально.
2. Все ключи читаются из process.env, а .env указан в .gitignore.
3. Приложение берёт порт из переменной PORT, а не жёстко 3000.
4. В коде нет http://localhost в адресах API — их должна задавать переменная.
5. Есть доступ к серверу по SSH-ключу, а не только паролю.
6. Домен куплен, и вы знаете, где управлять его DNS.

Минимальная связка nginx и приложения выглядит так:

server {
  server_name example.kz;
  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

После этого sudo certbot --nginx -d example.kz выпускает сертификат и сам настраивает редирект на HTTPS. Приложение запускается через pm2 start npm --name app -- start, затем pm2 save и pm2 startup, чтобы оно поднималось после перезагрузки.

Когда звать разработчика. Если проект — статический сайт или простое приложение без базы, по этой схеме его вполне можно выложить самому, а ИИ поможет с деталями. Помощь нужна, когда есть база данных, загрузка файлов, фоновые задачи, несколько сервисов, или когда сервер будет хранить персональные данные клиентов. Ошибки в настройке сервера редко видны сразу: открытый наружу порт базы, вход по паролю root или отсутствие обновлений безопасности проявляются только тогда, когда сервер уже взломан.

Как чиним мы

Сначала диагностика: собирается ли проект в продакшн-режиме, где база, какие внешние сервисы и ключи нужны. Затем готовим сервер с базовой защитой: отдельный пользователь, SSH-ключи, firewall, автообновления безопасности. Ставим приложение, базу, nginx, сертификат, настраиваем логи и деплой одной командой, чтобы следующая правка из Cursor выезжала на прод за минуту и без риска. Отдаём доступы и короткую инструкцию. Если по дороге всплывают ошибки в коде, сначала сообщаем и согласуем. Подробно об услуге — на странице «Аптечка вайб-кода», а правила, которые не дадут проекту развалиться после деплоя, — в статье «Почему вайб-код ломается».

Сколько стоит

Диагностика — 50 000 ₸, деплой с сервером, доменом и HTTPS — 50 000 ₸, итого от 100 000 ₸ для небольшого проекта. Стоимость самого VPS оплачивается провайдеру отдельно. Если проект не собирается, добавляется запуск и сборка — 40 000 ₸. Рассчитайте свой вариант в калькуляторе.