необходимые условия
Чтобы установить Node-RED локально, вам нужна поддерживаемая версия Node.js.
Установите Node-RED с помощью npm
Для установки Node-RED вы можете воспользоваться командой, входящей в состав npmnode.js:
sudo npm install -g -unsafe-perm node-red
Если вы используете Windows, не используйте sudo.
Эта команда устанавливает Node-RED и его зависимости как глобальные модули.
Вы можете убедиться в успешном выполнении, если вывод команды будет похож на следующий:
node-red@1.1.0
добавил 332 пакета от 341 автора за 18,494 с
найдено 0 уязвимостей
Установите Node-RED с помощью npm
Чтобы запустить его в Docker в самом простом виде, просто выполните команду:
docker run -it -p 1880:1880 -name mynodered nodered/node-red
Для получения более подробной информации смотрите руководство по докерам Node-RED.
Установка с помощью snap
Если ваша операционная система поддерживает Snap, вы можете установить Node-RED:
sudo snap install node-red
При установке в виде пакета Snap он запускается в защищенном контейнере, который не имеет доступа к некоторым дополнительным средствам, которые могут вам понадобиться, например:
- Доступ к основному системному хранилищу. Можно читать/записывать только локальный домашний каталог.
- gcc - любые двоичные компоненты, необходимые для компиляции узла для установки
- git - требуется, если вы хотите использовать функции проекта
- Прямой доступ к аппаратным средствам gpio
- Получите доступ к любым внешним командам, которые ваш поток хочет использовать с помощью узла Exec (например).
- Если вам нужен доступ к системному оборудованию или добавление узлов, требующих компиляции, мы рекомендуем использовать полную установку Node-RED, а не использовать привязки.
Начните работу с Node-RED
После установки в качестве глобального модуля вы можете запустить Node-RED в терминале с помощью команды node-red. Остановить Node-RED можно с помощью Ctrl-C или закрыв окно терминала.
$node-красный
Добро пожаловать в Node-RED====================
30 Jun 23:43:39 - [info] Версия Node-RED: v1.3.5
30 Jun 23:43:39 - [info] Node.jsversion: v14.7.2
30 Jun 23:43:39 - [info] Darwin 19.6.0 x64 LE
30 Jun 23:43:39 - [info] Загрузка узлов палитры
30 Jun 23:43:44 - [warn] rpi-gpio : Специфический узел Raspberry Pi установлен неактивным
30 Jun 23:43:44 - [info] Файл настроек: /Users/nol/.node-red/settings.js
30 Jun 23:43:44 - [info] HTTP Static: /Users/nol/node-red/web
30 Jun 23:43:44 - [info] Контекстное хранилище: 'default' [module=localfilesystem]
30 Jun 23:43:44 - [info] Каталог пользователя : /Users/nol/.node-red
30 Jun 23:43:44 - [warn] Проекты отключены : установите editorTheme.projects.enabled=true для включения
30 Jun 23:43:44 - [info] Создание нового файла потоков : flows_noltop.json
30 Jun 23:43:44 - [info] Запуск потоков
30 Jun 23:43:44 - [info] Запущенные потоки
30 Jun 23:43:44 - [info] Сервер сейчас работает по адресу http://127.0.0.1:1880/red/.
Затем вы можете получить доступ к редактору Node-RED, направив браузер на http://localhost:1880.
Вывод журнала позволяет получить различную информацию:
- Версии Node-RED и Node.js
- Любые ошибки, возникшие при попытке загрузить узел палитры
- Расположение файлов настроек и пользовательских каталогов
- Имя потокового файла, который используется.
Node-REDflows_
Использование командной строки
Node-RED Вы можете запустить node-red с помощью команды. Эта команда может принимать различные параметры:
node-red [-v] [-?] [-settings settings.js] [-userDir DIR]
[-port PORT] [-title TITLE] [-safe] [flows.json|projectName]
[-DX=Y|@file]
| Опции | описать |
| -p,-port PORT | Установите TCP-порт, на котором будет прослушиваться среда выполнения. По умолчанию: 1880 |
| -safe | Запустите Node-RED без запуска потока. Это позволит вам открыть поток в редакторе и внести изменения без запуска потока. Когда вы развернете свои изменения, процесс запустится. |
| -s,-settings FILE | Установите используемый файл настроек. По умолчанию: settings.js в каталоге userDir |
| -titleTITL | Установка заголовка окна процесса |
| -u,-userDir DIR | Установите используемый каталог пользователя. По умолчанию: ~/.node-red |
| -v | Включить вывод подробной информации |
| -DX=Y|@file | Отмена индивидуальных настроек |
| -?,-help | Показать справку об использовании командной строки и выход |
| flows.json|projectName | Здесь задается файл потока, который вы хотите использовать, если функция проектов не включена. Если функция проектов включена, это определяет, какой проект должен быть запущен. |
Node-REDflows_
Отмена индивидуальных настроек
Начиная с Node-RED 1.1.0
-D С помощью опции (или -define) можно отменить отдельные настройки в командной строке.
Например, чтобы изменить уровень протоколирования, вы можете использовать:
-D logging.console.level=trace
Вы также можете предоставить пользовательские настройки в виде файла:
-D @./custom-settings.txt
Файл должен содержать список настроек, которые необходимо отменить:
logging.console.level=trace
logging.console.audit=true
Передайте параметры основному процессу Node.js
Иногда необходимо передавать параметры базовому процессу Node.js. Например, при работе на устройстве с ограниченным объемом памяти, таком как Raspberry Pi или BeagleBone Black.
Для этого необходимо использовать сценарий запуска node-red-pi вместо node-red. Примечание: Этот сценарий недоступен для Windows.
Если же вы используете команду node для запуска Node-RED, вы должны предоставить аргументы процессу node перед указанием red.js, а также аргументы, которые будут переданы самому Node-RED.
Следующие две команды демонстрируют оба метода:
node-red-pi -max-old-space-size=128 -userDir /home/user/node-red-data/
node -max-old-space-size=128 red.js -userDir /home/user/node-red-data/
Обновление Node-RED
Если вы установили Node-RED в качестве глобального пакета npm, вы можете обновить его до последней версии с помощью следующей команды:
sudo npm install -g -unsafe-perm node-red
Если вы используете Windows, не используйте sudo.
