Фронтенд и статика
Как выложить Next.js приложение в интернет
Коротко
Чтобы выложить 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 за несколько минут.
Проверьте package.json#
Убедитесь, что в package.json есть скрипты build и start — обычно next build и next start. По ним Netrun понимает, как собрать и запустить приложение. Если вы создавали проект через create-next-app, эти скрипты уже на месте.
Не задавайте порт числом#
Если у приложения есть серверная часть — отрисовка на сервере (SSR) или API-роуты в папке app либо pages — оно запускается через next start и должно слушать порт из переменной окружения. Next.js по умолчанию читает порт из переменной PORT, поэтому в коде его прописывать не нужно: Netrun сам пробросит нужный.
Решите, нужен ли сервер#
Если сайт чисто статический — без серверной отрисовки и API-роутов — его можно собрать как набор готовых файлов: добавьте в next.config настройку статического экспорта (output: 'export'), и Netrun отдаст результат как обычный статический сайт. Если же есть API-роуты или данные подгружаются на сервере — оставьте обычный режим с next start.
Соберите архив или подключите GitHub#
Загрузить код можно двумя способами: ZIP-архивом или импортом из GitHub-репозитория, в том числе приватного. Папки node_modules и .next класть не нужно — зависимости установит и сборку соберет сам Netrun по вашему package.json, так что архив остается легким.
Укажите секреты при настройке#
Если приложение обращается к базе данных или внешним сервисам, не держите в коде ключи API, токены и строку подключения. Netrun спросит их при настройке проекта и подставит как переменные окружения: в Next.js серверные значения доступны через process.env, а то, что должно попасть в браузер, по правилам Next.js называется с префиксом NEXT_PUBLIC_.
Опубликуйте и следите за статусом#
Запустите публикацию — 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, и их может быть сколько угодно. На бесплатном тарифе сайт работает по выданной ссылке.