Коротко о главном
Node.js удобен для API, инструментов командной строки и фронтенд-сборки. Пакетный менеджер npm входит в стандартную поставку и описывает проект в package.json. В статье разберём установку, создание приложения, зависимости и воспроизводимую установку в CI. Примеры используют обычный Linux-терминал и не требуют глобальных фреймворков.
Единая среда JavaScript упрощает разработку клиента и сервера. npm даёт доступ к огромной экосистеме библиотек и готовых скриптов. package-lock.json фиксирует дерево зависимостей для повторяемых сборок. Node.js также часто используется для локальных инструментов и автоматизации.
В этой статье разберём nodejs по шагам: установка, базовая конфигурация, практические сценарии и ошибки, которые встречаются чаще всего.
Зачем нужен nodejs
nodejs решает вполне конкретные задачи: Node.js выполняет JavaScript вне браузера и служит основой для серверных и консольных приложений. Вместе с npm он управляет зависимостями и скриптами проекта. Важно не превращать инструмент в самоцель — если задача проще решается штатными средствами системы, начните с них.
Установка
В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:
sudo apt install nodejs npm
В Fedora и RHEL-совместимых системах пакет ставится через DNF:
sudo dnf install nodejs npm
В Arch Linux и производных пакет доступен в официальных репозиториях:
sudo pacman -S nodejs npm
Пошаговая настройка
После установки переходите к базовому сценарию. Команды ниже выполняйте от пользователя с достаточными правами, но не запускайте всё под root без необходимости.
1. Проверьте Node.js и npm
Убедитесь, что установлены обе команды и их версии совместимы. Для новых проектов выбирайте LTS-ветку Node.js. Версия npm влияет на поддержку команд npm pkg и npm ci.
node --version
npm --version
2. Создайте проект
npm init -y создаёт package.json с настройками по умолчанию. Команда npm pkg set позволяет изменить поле без ручного редактирования. Значение type=module включает современный синтаксис import.
mkdir demo-app && cd demo-app
npm init -y
npm pkg set type=module
3. Установите зависимости
Обычная зависимость нужна приложению во время работы. Флаг —save-dev добавляет пакет только для разработки и проверок. npm создаёт package-lock.json с точными версиями.
npm install express
npm install --save-dev eslint
4. Запустите скрипт проекта
Скрипты из package.json запускаются через npm run. Короткая форма npm start работает для стандартного скрипта start. Создайте простой index.js, чтобы проверить настройку.
printf 'console.log("ok")\n' > index.js
npm start
5. Подготовьте воспроизводимую установку
npm ci устанавливает зависимости строго по package-lock.json и подходит для CI. Команда требует наличия lock-файла и удаляет существующий node_modules. npm audit показывает известные уязвимости зависимостей.
npm ci
npm audit
Базовая конфигурация
Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.
{
"name": "demo-app",
"version": "1.0.0",
"private": true,
"type": "module",
"scripts": {
"start": "node index.js",
"test": "node --test"
}
}
Практические советы
Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.
Совет 1. Выбирайте LTS-версию Node.js для рабочих проектов и проверяйте срок по
Выбирайте LTS-версию Node.js для рабочих проектов и проверяйте срок поддержки.
Совет 2. Коммитьте package-lock.json: без него npm ci не сможет воспроизвести у
Коммитьте package-lock.json: без него npm ci не сможет воспроизвести установку.
Совет 3. Используйте npm ci в CI, а npm install — при активной разработке завис
Используйте npm ci в CI, а npm install — при активной разработке зависимостей.
Совет 4. Добавляйте node_modules и .env в .gitignore, чтобы не хранить зависимо
Добавляйте node_modules и .env в .gitignore, чтобы не хранить зависимости и секреты в репозитории.
Совет 5. Поле engines в package.json помогает явно указать поддерживаемые верси
Поле engines в package.json помогает явно указать поддерживаемые версии Node.js.
Практический сценарий
Представьте типовую задачу: нужно развернуть nodejs на одной машине, проверить работу и передать доступ коллеге. Начните с чистой системы или снапшота, чтобы результат был воспроизводим. Запишите все команды в отдельный файл — это одновременно шпаргалка и черновик будущей автоматизации.
Дальше действуйте короткими шагами: установка, минимальная конфигурация, проверка, затем расширение. После каждого шага фиксируйте, что именно изменилось и как это проверить. Такой журнал экономит время, когда через месяц понадобится повторить настройку на другом сервере или объяснить её коллеге.
Порядок работ для этого сценария выглядит так:
- Проверьте Node.js и npm
- Создайте проект
- Установите зависимости
- Запустите скрипт проекта
- Подготовьте воспроизводимую установку
Отдельно продумайте, что произойдёт при сбое. Для nodejs важно заранее знать, где хранятся данные, как их скопировать и сколько времени займёт восстановление. Если ответа нет, не двигайтесь дальше: сначала закройте этот пробел, потом добавляйте новые возможности.
Типичные ошибки
Ниже — сбои, которые встречаются чаще всего. Перед исправлением сохраните текущие конфиги и запишите, какие изменения вносите: так проще откатиться.
1. npm install -g завершается ошибкой EACCES.
Не используйте sudo для npm. Настройте пользовательский prefix или применяйте npx для разовых инструментов.
2. При запуске появляется Cannot find module.
Установите зависимости командой npm install и проверьте имя модуля. Убедитесь, что команда выполняется в каталоге проекта.
3. Пакет требует другую версию Node.js.
Проверьте поле engines и переключитесь на поддерживаемую LTS-версию. Обновите зависимости или Node.js в зависимости от требований проекта.
4. Сервер завершается с ошибкой EADDRINUSE.
Порт уже занят другим процессом. Найдите его через ss -ltnp и остановите процесс либо задайте другой порт через переменную окружения.
Что проверить перед вводом в работу
Перед тем как считать настройку завершённой, пройдитесь по короткому списку. Он не заменяет полноценный аудит, но отсекает большинство очевидных проблем.
Чек-лист
- Версия nodejs зафиксирована, а обновления не применяются вслепую.
- Есть резервная копия конфигурации и данных, восстановление проверено.
- Доступ ограничен нужными пользователями и сетями, лишние порты закрыты.
- Логи и метрики собираются, понятно, куда смотреть при сбое.
- Изменения описаны в документации и могут быть повторены на другой машине.
- Есть план отката и понятный критерий, по которому вы решите его применить.
Если какой-то пункт вызывает затруднение, это сигнал вернуться к соответствующему разделу, а не откладывать проверку. Настройка, которую нельзя повторить, плохо работает не только у коллег, но и у вас самих через полгода.
Итог
nodejs — это не «поставил и забыл». Рабочая конфигурация складывается из понимания задачи, аккуратной установки и проверки результата. Начните с базового сценария, затем добавляйте только те возможности, которые действительно используете.