Установка Node-RED чаще всего упирается не в саму платформу, а в отсутствие или неподходящую версию Node.js — без неё команда npm install -g node-red просто не выполнится. Поэтому первое действие перед установкой — проверить, установлен ли Node.js, и при необходимости поставить актуальную LTS-версию с официального сайта проекта.
Node-RED — это визуальная среда потокового программирования, популярная в задачах IoT, домашней автоматизации и интеграции сервисов. Редактор работает в браузере, а сама платформа запускается локально — на ПК, сервере, Raspberry Pi или в контейнере Docker. Ниже разберём все основные способы установки и типичные проблемы.
Подготовка: установка Node.js и npm
Node-RED распространяется как пакет npm, поэтому сначала необходимо установить Node.js. Рекомендуется использовать LTS-версию — с ней совместимость пакетов обычно лучше, чем с самой свежей Current-сборкой. Точные требования к поддерживаемым версиям Node.js стоит сверить с официальной документацией Node-RED, так как они периодически обновляются.
После установки проверьте, что всё встало корректно. Откройте терминал (в Windows — командную строку или PowerShell) и выполните:
node -v
npm -v
Если обе команды возвращают номера версий — можно переходить к установке Node-RED. Если система отвечает, что команда не найдена, перезапустите терминал или проверьте, добавлен ли Node.js в переменную PATH.
- 🟢 Скачивайте Node.js только с официального сайта nodejs.org
- 🔵 Выбирайте LTS-версию для стабильной работы
- 🟡 После установки закройте и заново откройте терминал
- 🟠 Проверьте версии командами
node -vиnpm -v
Установка Node-RED через npm
Стандартный способ установки — глобальная установка пакета через npm. Команда одинакова для Windows, Linux и macOS:
npm install -g --unsafe-perm node-redФлаг -g устанавливает пакет глобально, чтобы команда node-red была доступна из любой папки. Параметр --unsafe-perm нужен в основном на Linux-системах, чтобы избежать ошибок прав доступа при сборке зависимостей. На Windows процесс обычно проходит без дополнительных флагов.
Если установка завершилась без критических ошибок (предупреждения вида npm warn обычно не страшны), проверьте запуск:
node-redВ терминале появится лог запуска, после чего редактор станет доступен в браузере по адресу http://localhost:1880. Порт 1880 — стандартный порт Node-RED, именно на нём по умолчанию работает веб-интерфейс.
☑️ Проверка после установки
Установка на Linux и Raspberry Pi
Для Raspberry Pi OS и Debian-подобных систем существует официальный скрипт установки, который подтянет Node.js, Node-RED и настроит автозапуск через systemd. Команда приведена в официальной документации Node-RED; перед запуском любых скриптов из интернета стоит открыть их и убедиться, что они загружены с официального источника.
После установки на Linux удобно включить автозапуск сервиса, чтобы Node-RED стартовал вместе с системой:
sudo systemctl enable nodered.service
sudo systemctl start nodered.service
⚠️ Внимание: не устанавливайте Node-RED черезsudo npm install -gбез необходимости — это частая причина проблем с правами на каталог~/.node-red. Если ошибкиEACCESуже появились, проверьте владельца папки пользовательских данных.
Запуск Node-RED в Docker
Если на машине уже развёрнут Docker, это один из самых чистых способов: Node-RED работает в изолированном контейнере и не затрагивает системную установку Node.js. Официальный образ называется nodered/node-red.
docker run -d -p 1880:1880 --name mynodered nodered/node-redКлюч -p 1880:1880 пробрасывает порт редактора наружу. Чтобы потоки и установленные ноды не пропадали при пересоздании контейнера, добавьте volume для каталога данных — подробности монтирования описаны в документации образа на Docker Hub. Без volume все наработки будут потеряны при удалении контейнера.
Что делать, если порт 1880 занят
Измените внешний порт в команде Docker, например -p 1881:1880, и открывайте редактор по адресу localhost:1881. Для локальной установки порт меняется в файле settings.js в каталоге ~/.node-red.
Сравнение способов установки
| Способ | Сложность | Автозапуск | Кому подходит |
|---|---|---|---|
| npm (Windows) | Низкая | Настраивается отдельно | Новичкам, локальные эксперименты |
| npm (Linux) | Средняя | Через systemd | Серверы и постоянная работа |
| Скрипт для Raspberry Pi | Низкая | Включён в скрипт | Домашняя автоматизация |
| Docker | Средняя | Политика restart контейнера | Тем, кто уже использует контейнеры |
Выбор зависит от сценария: для разового знакомства достаточно npm-установки, для постоянно работающего сервера удобнее systemd или Docker с автоперезапуском.
Типичные ошибки при установке и их решение
Чаще всего пользователи сталкиваются с ошибкой EACCES (нет прав на запись) на Linux — она решается корректной настройкой прав npm или установкой под своим пользователем, а не через sudo. Вторая частая проблема — node-red is not recognized на Windows: обычно помогает перезапуск терминала или проверка PATH.
Если редактор не открывается, проверьте лог запуска в терминале: там видно, на каком порту стартовал сервер и не было ли конфликта портов. Также убедитесь, что брандмауэр не блокирует входящие подключения к порту 1880, если вы открываете редактор с другого устройства в сети.
⚠️ Внимание: по умолчанию редактор Node-RED не защищён паролем. Если порт 1880 доступен из локальной сети или интернета, обязательно настройте аутентификацию в файле settings.js — иначе любой в сети сможет изменять ваши потоки.
- 🔴 Ошибка EACCES — проблема прав доступа к каталогам npm
- 🟣 Команда не найдена — проверьте PATH и перезапустите терминал
- 🟤 Порт занят — смените порт в settings.js или в параметрах Docker
- ⚪ Старые ноды не ставятся — обновите Node.js до поддерживаемой LTS
Первые шаги после установки
После запуска откройте редактор и перетащите на холст ноды inject и debug, соедините их и нажмите Deploy. Клик по кнопке inject отправит сообщение, которое отобразится на вкладке отладки — это простейшая проверка, что платформа работает полностью.
Дополнительные ноды устанавливаются через меню Manage palette прямо в редакторе. Перед установкой сторонних палитр полезно смотреть на дату последнего обновления пакета — заброшенные ноды могут конфликтовать со свежими версиями Node-RED.
Частые вопросы
Какая версия Node.js нужна для Node-RED?
Рекомендуется актуальная LTS-версия Node.js. Точный перечень поддерживаемых версий указан в официальной документации Node-RED и меняется со временем, поэтому сверяйтесь с ней перед установкой.
Как запустить Node-RED автоматически при загрузке?
На Linux используйте systemd: sudo systemctl enable nodered.service. В Docker задайте политику перезапуска контейнера. На Windows можно использовать планировщик задач или сторонние менеджеры процессов.
Где Node-RED хранит потоки и настройки?
В каталоге ~/.node-red в домашней папке пользователя. Там находятся файлы потоков, settings.js и установленные палитры. Резервная копия этой папки сохраняет весь проект.
Можно ли изменить порт 1880?
Да. Для локальной установки порт задаётся параметром uiPort в файле settings.js. В Docker порт меняется в параметре проброса, например -p 8080:1880.
Нужен ли интернет для работы Node-RED?
Для работы редактора и локальных потоков интернет не нужен — весь интерфейс обслуживается локальным сервером. Сеть требуется только для установки пакетов, обновлений и нод, обращающихся к внешним сервисам.