Документация ServBay: Как назначить конкретную версию Node.js для вашего проекта, скрипта или сайта
ServBay — это мощная локальная среда для Web-разработки, поддерживающая множество языков программирования и технологий, включая Node.js. В реальных условиях разработки часто требуется использовать определённую версию Node.js для отдельных проектов, скриптов или целых сайтов. Например, старый проект может зависеть от Node.js 14, тогда как новый использует возможности Node.js 20. ServBay предлагает гибкие инструменты для подобных задач.
В этой статье вы узнаете, как просто назначать необходимые версии Node.js для скриптов и сайтов внутри ServBay, а также использовать проектную конфигурацию.
Использование файла .servbay.config для задания версии Node.js и настройки проекта
Для проектов, где важно строго контролировать версию Node.js и среды, ServBay предоставляет настройку на уровне проекта через файл .servbay.config, размещаемый в корневой директории. С помощью этого файла вы можете задавать используемую версию Node.js, адреса репозиториев для npm/yarn, директории кэша и другие параметры — это обеспечивает изолированность и стабильность вашего окружения.
Пример файла .servbay.config для выбора конкретной версии Node.js и настройки npm/yarn:
NODE_VERSION=20
YARN_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Пример: использование специфического зеркала
NPM_CONFIG_REGISTRY=https://registry.npmmirror.com/ # Пример: использование специфического зеркала
NPM_CONFIG_CACHE=/Applications/ServBay/tmp/npm/cache # Пример: указание директории кэша
YARN_CONFIG_CACHE=/Applications/ServBay/tmp/yarn/cache # Пример: указание директории кэша2
3
4
5
Пояснения:
NODE_VERSION: Главный номер версии Node.js, используемой проектом. ServBay выберет подходящую установленную версию.YARN_CONFIG_REGISTRY,NPM_CONFIG_REGISTRY: Ссылки на используемые npm или yarn-репозитории пакетов.NPM_CONFIG_CACHE,YARN_CONFIG_CACHE: Директории для кэша npm или yarn. В примере используются стандартные временные папки ServBay:/Applications/ServBay/tmp/.
Обычно файл .servbay.config размещается в корне вашего проекта. Подробное описание настроек смотрите в официальной документации ServBay в разделе Файл .servbay.config.
Запуск скриптов с конкретной версией Node.js через командную строку
Если вам не нужно назначать версию Node.js на уровне всего проекта, а нужно временно выполнить скрипт с нужной версией, воспользуйтесь командными псевдонимами, предоставляемыми ServBay.
В терминале ServBay (его можно открыть через интерфейс приложения ServBay), используйте команду вида node-<версия>, чтобы быстро начать выполнение скрипта с нужной версией Node.js. Для каждой установленной версии Node.js автоматически создаются такие псевдонимы.
Например, чтобы запустить скрипт script.js с Node.js 14, выполните:
$ node-14 script.js
Hello World
Node.js Version: 14.17.0 # Пример вывода, ваша версия может отличаться
$ node-16 script.js
Hello World
Node.js Version: 16.3.0 # Пример вывода, ваша версия может отличаться
$ node-20 script.js
Hello World
Node.js Version: 20.10.0 # Пример вывода, ваша версия может отличаться2
3
4
5
6
7
8
9
10
11
Пояснения к примеру
$ node-14 script.js: Запускает скриптscript.jsс установленной в ServBay версией Node.js 14 (какая именно версия внутри 14.x.x — зависит от установленных пакетов).$ node-16 script.js: Запускает скрипт с Node.js 16.$ node-20 script.js: Запускает скрипт с Node.js 20.
Этот механизм позволяет удобно тестировать совместимость кода с разными версиями Node.js, либо выполнять специфические задачи, требующие определённой версии — при этом вам не нужно менять глобальную версию Node.js в системе.
Назначение версии Node.js для сайта через интерфейс управления ServBay
В ServBay можно указать версию Node.js для каждого сайта прямо через административный веб-интерфейс. Это особенно полезно для сайтов или приложений с backend на Node.js (например, сайты, работающие через Express.js, Next.js или NestJS и проксируемые через Caddy или Nginx).
Шаги
Откройте интерфейс управления ServBay: Запустите приложение ServBay и откройте административный интерфейс в браузере (обычно по адресу
http://localhost:5200или через основное окно приложения).Перейдите к управлению сайтами: В левой панели интерфейса выберите пункт
Сайты(Website).Выберите нужный сайт и приступите к редактированию: Найдите нужный сайт в списке (например, сайт в папке
/Applications/ServBay/www/servbay.demo). Нажмите кнопку редактирования (зубчатое колесо или иконка карандаша), либо кликните по названию сайта для перехода в подробности.Укажите версию Node.js: В настройках сайта найдите пункт для выбора версии Node.js, обычно выполненный в виде выпадающего списка. Выберите нужную версию по умолчанию.
Сохраните изменения: После выбора обязательно нажмите кнопку
СохранитьилиПрименитьвнизу страницы.Перезапустите сайт или ServBay (если потребуется): Некоторые изменения вступают в силу только после перезапуска соответствующего веб-сервера (например, Caddy или Nginx) либо всего приложения ServBay. ServBay предупредит, если потребуется перезапуск.
Важные замечания
- Проверьте, что нужная версия Node.js установлена и активна: Для выбора определённой версии Node.js на сайте она должна быть установлена и запущена в разделе
Пакеты(Packages) ServBay. Если не установлено — перейдите в этот раздел и установите необходимое. - Тип сайта: Этот параметр влияет преимущественно на сайты, где Node.js используется как среда выполнения (например, backend-приложения на Express.js, Next.js, NestJS и т.д.). Для статических сайтов или сайтов, полностью построенных на PHP, Python, Go и других языках, настройка Node.js может не играть роли.
- Тестируйте совместимость: После изменения версии Node.js обязательно проверьте работоспособность сайта: удостоверьтесь, что все зависимости функционируют корректно на выбранной версии.
- Приоритет между сайтами и .servbay.config: Заданная через интерфейс версия Node.js будет использоваться по умолчанию. Но если в каталоге сайта есть
.servbay.configс параметромNODE_VERSION, то проектная настройка имеет больший приоритет для более тонкой и гибкой конфигурации.
Итоги
ServBay — это мощная и гибкая локальная среда для разработки, которая предлагает удобные инструменты управления и выбора Node.js-окружения под разные задачи. Вы можете:
- задавать версию и переменные окружения через проектный
.servbay.config, - запускать скрипты нужной версии Node.js в один клик в терминале,
- настраивать отдельную версию Node.js для каждого сайта непосредственно через интерфейс.
Подобные возможности позволяют легко поддерживать старые проекты, внедрять новинки Node.js, обеспечивать максимальное соответствие между локальной и продакшн-средой, и существенно повышать эффективность работы разработчика.