Фронтенд и статика

Как выложить Next.js приложение в интернет

· 4 мин чтения

Коротко

Чтобы выложить Next.js приложение в интернет, проверьте скрипты build и start в package.json, не задавайте порт числом и загрузите код без папок node_modules и .next. Netrun установит зависимости, выполнит сборку, запустит приложение и выдаст ссылку с HTTPS. Если серверной части нет, сайт можно собрать статическим экспортом (output: 'export') и раздавать как набор готовых файлов.

  • Next.js в режиме next start по умолчанию читает порт из переменной окружения PORT.
  • Сайт на Next.js без серверной отрисовки и API-роутов можно собрать в статические файлы настройкой output: 'export' в next.config.
  • Переменные окружения, которые должны попасть в браузер, в Next.js называются с префиксом NEXT_PUBLIC_.
  • Папки node_modules и .next загружать не нужно: Netrun устанавливает зависимости и собирает проект сам по package.json.
  • На бесплатном тарифе Netrun веб-приложение засыпает без посетителей и просыпается при первом запросе.

Обычно, чтобы выложить Next.js приложение в интернет, нужно арендовать сервер, поставить на него Node.js, собрать проект через npm run build, запустить его как постоянный процесс, повесить рядом nginx, получить SSL-сертификат и следить, чтобы все это поднималось обратно после перезагрузки. Для пет-проекта или первого сайта это слишком много ручной работы.

Netrun берет инфраструктуру на себя: вы загружаете код приложения, а сборку, запуск, перезапуск, домен и HTTPS делаем мы. Ниже — как опубликовать ваш Next.js за несколько минут.

  1. Проверьте package.json#

    Убедитесь, что в package.json есть скрипты build и start — обычно next build и next start. По ним Netrun понимает, как собрать и запустить приложение. Если вы создавали проект через create-next-app, эти скрипты уже на месте.

  2. Не задавайте порт числом#

    Если у приложения есть серверная часть — отрисовка на сервере (SSR) или API-роуты в папке app либо pages — оно запускается через next start и должно слушать порт из переменной окружения. Next.js по умолчанию читает порт из переменной PORT, поэтому в коде его прописывать не нужно: Netrun сам пробросит нужный.

  3. Решите, нужен ли сервер#

    Если сайт чисто статический — без серверной отрисовки и API-роутов — его можно собрать как набор готовых файлов: добавьте в next.config настройку статического экспорта (output: 'export'), и Netrun отдаст результат как обычный статический сайт. Если же есть API-роуты или данные подгружаются на сервере — оставьте обычный режим с next start.

  4. Соберите архив или подключите GitHub#

    Загрузить код можно двумя способами: ZIP-архивом или импортом из GitHub-репозитория, в том числе приватного. Папки node_modules и .next класть не нужно — зависимости установит и сборку соберет сам Netrun по вашему package.json, так что архив остается легким.

  5. Укажите секреты при настройке#

    Если приложение обращается к базе данных или внешним сервисам, не держите в коде ключи API, токены и строку подключения. Netrun спросит их при настройке проекта и подставит как переменные окружения: в Next.js серверные значения доступны через process.env, а то, что должно попасть в браузер, по правилам Next.js называется с префиксом NEXT_PUBLIC_.

  6. Опубликуйте и следите за статусом#

    Запустите публикацию — Netrun определит, что это Node.js, установит зависимости, выполнит сборку и выдаст ссылку с HTTPS. Логи и статус видны в кабинете в реальном времени, поэтому если сборка на чем-то споткнется, вы сразу это увидите. При сбое в работе проект перезапускается автоматически.

Готово: ваше Next.js приложение живет в интернете по адресу с HTTPS, без аренды сервера и настройки nginx. На бесплатном тарифе доступен один проект, и веб-приложение засыпает при простое, а просыпается по первому запросу — отвечает чуть медленнее только в первый раз. Если сайт должен быть всегда наготове, без пауз, подойдет платный тариф с постоянной работой, а дополнительные проекты оплачиваются отдельно. Попробовать Netrun.

Частые вопросы

Почему переменная окружения не видна в браузере?

В Next.js в браузер попадают только переменные с префиксом NEXT_PUBLIC_, и их значения подставляются в код во время сборки. Поэтому после изменения такой переменной во вкладке «Секреты» проект нужно опубликовать заново. Секретные ключи этим префиксом не помечайте: его значения увидит любой посетитель.

Нужен ли Vercel, чтобы запустить Next.js?

Нет. Next.js — обычное приложение на Node.js: после next build его запускает next start на любом сервере с Node.js. Vercel удобен, но не обязателен.

Что выбрать: обычный режим или статический экспорт?

Если страницы собираются из готовых данных и API-роутов нет, статический экспорт проще: на выходе набор файлов. Если данные подгружаются на сервере, есть API-роуты или серверные действия, нужен обычный режим с next start.

Почему сборка Next.js падает, хотя в режиме разработки все работает?

Часто из-за ошибок TypeScript: next build проверяет типы и останавливается на ошибке, а режим разработки к ним мягче. Запустите npm run build у себя, чтобы увидеть ту же ошибку, а в Netrun смотрите логи сборки в кабинете — они видны в реальном времени.

Можно ли подключить к Next.js сайту свой домен?

Да, на тарифе Pro: свои домены подключаются в кабинете, каждый с HTTPS, и их может быть сколько угодно. На бесплатном тарифе сайт работает по выданной ссылке.

Запустите свой проект

Загрузите код, ответьте на пару вопросов — и получите рабочую ссылку. Есть бесплатный тариф

Попробовать Netrun
Все статьи блога