☰
05.08.2026

Как установить Node-RED на VPS через панель Serverspace

Node-RED — это low-code-платформа для создания автоматизаций, интеграций и приложений на основе визуальных потоков. Вместо написания всей логики вручную разработчик соединяет готовые узлы, которые получают данные, преобразуют их, обращаются к API, работают с базами данных и передают результат другим сервисам.

Платформа построена на Node.js и подходит для интеграции облачных сервисов, IoT-устройств, веб-приложений, мессенджеров, брокеров сообщений и внутренних корпоративных систем.

Node-RED можно запустить локально, в Docker, на одноплатном компьютере или виртуальном сервере. Для автоматизаций, которые должны работать постоянно, удобнее использовать VPS: сервер остается доступным круглосуточно, имеет публичный IP-адрес и не зависит от домашнего компьютера.

В этой инструкции рассмотрим развертывание Node-RED через панель управления Serverspace, подключение к VPS, первый вход в редактор, создание тестового flow, настройку firewall, защиту интерфейса, подключение домена, организацию HTTPS и диагностику распространенных ошибок.

Что представляет собой Node-RED

Node-RED использует визуальную модель разработки, в которой приложение собирается из отдельных блоков — nodes.

Каждый узел выполняет конкретную операцию:

Узлы размещаются в редакторе и соединяются линиями. Получившаяся схема называется flow.

После нажатия кнопки Deploy Node-RED применяет изменения и запускает обновленную логику.

Для чего используется Node-RED

Платформа подходит для проектов, в которых необходимо быстро связать несколько систем или автоматизировать обработку событий.

Типичные сценарии:

Node-RED особенно полезен, когда необходимо быстро проверить идею или собрать рабочую интеграцию без разработки отдельного backend-приложения с нуля.

Чем Node-RED отличается от классического программирования

В традиционном приложении разработчик самостоятельно:

В Node-RED многие из этих операций представлены готовыми узлами.

Например, простой HTTP-сервис можно собрать из трех компонентов:

HTTP In → Function → HTTP Response

Для получения события из MQTT и отправки его в Telegram flow может выглядеть так:

MQTT In → Проверка условия → Telegram Sender

Визуальный подход не означает, что программирование полностью исключается. В узле Function можно использовать JavaScript для обработки данных и реализации нестандартной логики.

Основные элементы Node-RED

При работе с платформой используются следующие понятия:

Большинство узлов получают объект msg, изменяют его и передают дальше.

Наиболее часто полезная нагрузка хранится в:

msg.payload

Однако flow может передавать и дополнительные поля:

msg.topic
msg.headers
msg.statusCode
msg.filename

Почему Node-RED удобно размещать на VPS

Локальная установка подходит для обучения и разработки, но постоянные автоматизации требуют среды, которая не отключается вместе с компьютером пользователя.

VPS обеспечивает:

Отдельный сервер также помогает изолировать автоматизации от рабочего компьютера и других приложений.

Какие ресурсы потребуются

Сам Node-RED не требует мощного сервера. Основная нагрузка зависит от количества flows, частоты событий, объема данных и установленных дополнительных узлов.

Для тестового развертывания можно начать с:

Для постоянной эксплуатации нескольких интеграций рекомендуется:

В Serverspace конфигурацию VPS можно собрать в калькуляторе: отдельно выбрать количество vCPU, объём RAM и SSD. Это позволяет начать с минимальной конфигурации и увеличить ресурсы, если нагрузка вырастет.

Увеличение ресурсов может потребоваться, если:

Сетевые порты

Для базового развертывания могут использоваться следующие порты:

Порт Назначение Рекомендация
22/TCP SSH-доступ Использовать SSH-ключ и ограничить доступ
1880/TCP Редактор и HTTP endpoints Node-RED Не открывать публично без авторизации
80/TCP HTTP Используется reverse proxy и проверкой домена
443/TCP HTTPS Рекомендуется для удаленного доступа
1883/TCP MQTT без TLS Нужен только при локальном MQTT-брокере
8883/TCP MQTT с TLS Предпочтительнее для публичных подключений

Не открывайте все перечисленные порты автоматически. Конкретный набор правил зависит от используемых интеграций.

Установка Node-RED через панель Serverspace

Node-RED можно выбрать в каталоге готовых приложений Serverspace.

Такой способ избавляет от ручной установки Node.js, npm, Node-RED и базовых зависимостей. Платформа создает виртуальную машину и подготавливает приложение к первоначальной настройке.

Шаг 1. Откройте создание сервера

Войдите в панель управления Serverspace, откройте раздел vStack cloud и нажмите Создать сервер.

Откроется мастер настройки виртуальной машины.

Шаг 2. Выберите Node-RED

Перейдите на вкладку Приложения или 1-Click Apps.

Найдите в каталоге Node-RED и выберите приложение.

Готовый образ сокращает количество ручных действий и позволяет быстрее перейти к созданию flows.

Шаг 3. Выберите дата-центр

Укажите регион размещения виртуальной машины.

При выборе учитывайте:

Если Node-RED регулярно обращается к базе данных или внутреннему API на другом сервере, желательно уменьшить сетевую задержку между ними.

Шаг 4. Настройте ресурсы

Выберите:

Для нескольких несложных автоматизаций можно начать с:

Пример имени:

node-red-automation-01

или:

integration-gateway

Шаг 5. Настройте SSH-доступ

Выберите способ авторизации:

Для рабочего сервера рекомендуется использовать SSH-ключ.

Закрытый ключ нельзя:

Шаг 6. Создайте сервер

Проверьте выбранные параметры и запустите развертывание.

Serverspace автоматически:

Дождитесь появления статуса Активен.

Почему Node-RED удобно запускать в Serverspace

При таком развертывании инфраструктура и логика автоматизаций управляются отдельно.

В Serverspace настраиваются:

В Node-RED настраиваются:

Администратор может изменять ресурсы VPS, не перестраивая сами flows.

Изоляция автоматизаций

Node-RED рекомендуется запускать на отдельной VPS, если flows получают доступ к важным системам.

Это помогает:

Разделение production и test

Для рабочих и экспериментальных flows можно создать разные серверы:

Сервер Назначение Пример ресурсов
node-red-production Рабочие интеграции 2 vCPU, 4 ГБ RAM
node-red-staging Проверка изменений 1–2 vCPU, 2 ГБ RAM
node-red-iot IoT и MQTT 2 vCPU, 2–4 ГБ RAM

Не устанавливайте непроверенные узлы сразу на production-сервер.

Подключение к VPS по SSH

Скопируйте публичный IP-адрес из панели Serverspace.

Подключитесь:

ssh root@YOUR_SERVER_IP

Замените YOUR_SERVER_IP на адрес сервера.

При первом подключении подтвердите отпечаток:

yes

Введите пароль или используйте закрытый SSH-ключ.

Проверка Node-RED

Проверьте версию Node.js:

node --version

Версию npm:

npm --version

Версию Node-RED:

node-red --version

Проверьте процессы:

ps aux | grep node-red

Убедитесь, что порт 1880 прослушивается:

sudo ss -lntp | grep 1880

Первый вход в редактор

Откройте в браузере:

http://YOUR_SERVER_IP:1880

Замените YOUR_SERVER_IP на публичный IP сервера.

После загрузки откроется редактор Node-RED.

Основные области интерфейса:

Редактор по умолчанию может быть доступен без логина. Не оставляйте порт 1880 открытым для всего интернета после первоначальной проверки.

Создание первого flow

Соберем простую схему, которая отправляет сообщение в журнал отладки.

Шаг 1. Добавьте Inject

Перетащите узел Inject из левой панели в рабочую область.

Он будет запускать flow вручную при нажатии кнопки.

Шаг 2. Добавьте Function

Перетащите узел Function и соедините его с Inject.

Откройте Function и добавьте:

msg.payload = "Node-RED работает на VPS";
return msg;

Сохраните изменения.

Шаг 3. Добавьте Debug

Перетащите узел Debug и соедините его с Function.

Итоговая схема:

Inject → Function → Debug

Шаг 4. Разверните flow

Нажмите Deploy.

После этого нажмите кнопку слева от Inject.

В панели Debug должно появиться сообщение:

Node-RED работает на VPS

Создание простого HTTP endpoint

Node-RED можно использовать для создания небольших HTTP API.

Добавьте:

Соедините:

HTTP In → Function → HTTP Response

В HTTP In укажите:

В Function добавьте:

msg.payload = {
status: "ok",
service: "node-red"
};

msg.headers = {
"Content-Type": "application/json"
};

return msg;

Нажмите Deploy.

Проверьте endpoint:

curl http://127.0.0.1:1880/api/status

Ожидаемый результат:

{"status":"ok","service":"node-red"}

Как работает объект msg

Узлы передают друг другу JavaScript-объект msg.

Пример:

{
"payload": "temperature",
"topic": "sensor/room1",
"value": 24.5
}

В Function node можно изменять поля:

msg.payload = msg.value * 1.8 + 32;
msg.unit = "F";
return msg;

Если Function не возвращает объект, сообщение не будет передано дальше.

Для остановки flow можно использовать:

return null;

Установка дополнительных узлов

Дополнительные интеграции можно устанавливать через редактор.

Откройте:

  1. главное меню;
  2. Manage palette;
  3. вкладку Install;
  4. найдите необходимый пакет;
  5. проверьте его описание и установите.

Дополнительные узлы могут добавлять поддержку:

Перед установкой стороннего пакета проверьте:

Где хранится конфигурация

При обычном запуске пользовательские данные Node-RED часто находятся в каталоге:

~/.node-red

В нем могут храниться:

Точное расположение зависит от пользователя, способа установки и параметра userDir.

Посмотреть путь можно в журнале запуска Node-RED.

Настройка settings.js

Основные параметры среды задаются в файле:

~/.node-red/settings.js

Перед изменением создайте копию:

cp ~/.node-red/settings.js ~/.node-red/settings.js.backup

В settings.js можно настроить:

После изменения конфигурации перезапустите Node-RED.

Почему необходимо защищать редактор

Редактор позволяет:

Если редактор открыт без авторизации, посторонний пользователь может изменить flows или использовать сохраненные подключения.

Публичный доступ к порту 1880 без защиты допустим только в изолированной доверенной сети.

Создание хеша пароля

Для авторизации в редакторе понадобится хеш пароля.

Установите административную CLI, если она отсутствует:

sudo npm install -g --unsafe-perm node-red-admin

Создайте хеш:

node-red-admin hash-pw

Введите пароль.

Команда вернет строку вида:

$2b$08$EXAMPLE_HASH

Скопируйте ее для настройки adminAuth.

Включение авторизации в редакторе

Откройте settings.js:

nano ~/.node-red/settings.js

Найдите или добавьте параметр:

adminAuth: {
type: "credentials",
users: [{
username: "admin",
password: "$2b$08$EXAMPLE_HASH",
permissions: "*"
}]
},

Замените хеш на полученное значение.

После сохранения перезапустите Node-RED.

Теперь при открытии редактора потребуется логин и пароль.

Защита HTTP endpoints

Авторизация редактора и защита endpoint, созданных узлами HTTP In, настраиваются отдельно.

Для базовой авторизации можно использовать httpNodeAuth:

httpNodeAuth: {
user: "apiuser",
pass: "$2b$08$EXAMPLE_HASH"
},

После перезапуска запрос потребует учетные данные:

curl -u apiuser:PASSWORD http://127.0.0.1:1880/api/status

Для публичного API может быть удобнее реализовать проверку токена, использовать reverse proxy или отдельный API Gateway.

Настройка credentialSecret

Node-RED может хранить учетные данные узлов в зашифрованном файле.

Для постоянного ключа укажите в settings.js:

credentialSecret: "LONG_RANDOM_SECRET",

Используйте длинную случайную строку.

Секрет необходимо сохранять вместе с резервной копией. Если файл credentials будет восстановлен без правильного ключа, Node-RED не сможет расшифровать сохраненные пароли и токены.

Безопасный доступ через SSH-туннель

Если редактор нужен только администратору, порт 1880 можно не открывать публично.

Создайте туннель:

ssh -L 1880:127.0.0.1:1880 root@YOUR_SERVER_IP

После подключения откройте локально:

[http://127.0.0.1:1880

(http://127.0.0.1:1880[/code)]

Преимущества:

Подключение домена

Для постоянного веб-доступа создайте отдельный поддомен:

node-red.example.com

Добавьте A-запись:

Тип Имя Значение
A node-red YOUR_SERVER_IP

Проверьте:

dig +short node-red.example.com

Команда должна вернуть IP виртуальной машины.

Настройка Nginx как reverse proxy

Установите Nginx:

sudo apt update
sudo apt install nginx -y

Создайте конфигурацию:

sudo nano /etc/nginx/sites-available/node-red

Добавьте:

server {
listen 80;
server_name node-red.example.com;

location / {
proxy_pass http://127.0.0.1:1880;
proxy_http_version 1.1;

proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}

}

Активируйте сайт:

sudo ln -s /etc/nginx/sites-available/node-red /etc/nginx/sites-enabled/node-red

Проверьте конфигурацию:

sudo nginx -t

Перезапустите Nginx:

sudo systemctl reload nginx

Получение SSL-сертификата

Установите Certbot:

sudo apt install certbot python3-certbot-nginx -y

Запросите сертификат:

sudo certbot --nginx -d node-red.example.com

После установки откройте:

[https://node-red.example.com

(https://node-red.example.com[/code)]

Даже при наличии HTTPS необходимо сохранить авторизацию редактора. Сертификат шифрует соединение, но сам по себе не ограничивает доступ.

Настройка firewall

Разрешите SSH:

sudo ufw allow OpenSSH

Для reverse proxy откройте HTTP и HTTPS:

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

Включите firewall:

sudo ufw enable

Проверьте:

sudo ufw status verbose

После настройки Nginx не обязательно открывать порт 1880 публично.

Перед включением UFW откройте вторую SSH-сессию и убедитесь, что доступ к серверу сохраняется.

Запуск Node-RED как системного сервиса

Node-RED должен автоматически запускаться после перезагрузки VPS.

Проверьте доступные сервисы:

systemctl list-units --type=service | grep -i node-red

Если приложение использует systemd, проверьте статус:

sudo systemctl status nodered

или:

sudo systemctl status node-red

Перезапуск:

sudo systemctl restart nodered

Автозапуск:

sudo systemctl enable nodered

Точное имя службы зависит от способа развертывания готового приложения.

Логи Node-RED

Для systemd-сервиса используйте:

sudo journalctl -u nodered

Просмотр в реальном времени:

sudo journalctl -u nodered -f

Последние 100 записей:

sudo journalctl -u nodered -n 100

Если имя сервиса отличается, замените nodered на фактическое название.

В логах можно найти:

Работа с переменными окружения

Не рекомендуется записывать токены и пароли непосредственно в Function nodes.

Используйте переменные окружения, например:

API_TOKEN=example-secret

Получить значение в Function node можно так:

const token = env.get("API_TOKEN");

msg.headers = {
Authorization: "Bearer " + token
};

return msg;

Это упрощает:

Контекст в Node-RED

Node-RED поддерживает три уровня context:

Пример сохранения значения:

flow.set("counter", 10);

Чтение:

const counter = flow.get("counter") || 0;

По умолчанию context может храниться в памяти. После перезапуска такие данные могут быть потеряны.

Для постоянного хранения можно настроить файловый context в settings.js.

Настройка постоянного context

Добавьте в settings.js:

contextStorage: {
default: {
module: "localfilesystem"
}
},

После перезапуска значения context будут периодически сохраняться на диск.

Файловое хранилище удобно для небольшого состояния, но не заменяет полноценную базу данных для больших объемов информации.

Обработка ошибок в flows

Для диагностики используйте:

Пример схемы:

Основной flow → Ошибка → Catch → Формирование сообщения → Telegram

Для production-автоматизаций важно обрабатывать:

Защита от бесконечных циклов

Неправильное соединение узлов может создать цикл, который будет постоянно генерировать сообщения.

Это может привести к:

При создании повторяющейся логики используйте:

Резервное копирование Node-RED

Сохранять необходимо:

Создать архив пользовательского каталога можно командой:

tar -czf node-red-backup.tar.gz ~/.node-red

Не храните единственную копию на той же VPS.

Архив может содержать секреты, поэтому:

Экспорт и импорт flows

Flow можно экспортировать из редактора:

  1. выделите нужные узлы;
  2. откройте меню;
  3. выберите Export;
  4. скопируйте JSON.

Для импорта:

  1. откройте меню;
  2. выберите Import;
  3. вставьте JSON;
  4. разместите узлы;
  5. проверьте настройки;
  6. нажмите Deploy.

Экспортированный JSON может раскрывать структуру интеграций. Не публикуйте его без проверки.

Рекомендации по безопасности

Полезные команды

Действие Команда
Версия Node.js node --version
Версия npm npm --version
Версия Node-RED node-red --version
Проверить порт 1880 sudo ss -lntp | grep 1880
Статус сервиса sudo systemctl status nodered
Перезапустить сервис sudo systemctl restart nodered
Просмотреть логи sudo journalctl -u nodered -f
Проверить RAM free -h
Проверить диск df -h

Типичные проблемы

Редактор Node-RED не открывается

Проверьте порт:

sudo ss -lntp | grep 1880

Проверьте процесс:

ps aux | grep node-red

Проверьте firewall:

sudo ufw status verbose

Выполните локальный запрос:

curl -I [http://127.0.0.1:1880

(http://127.0.0.1:1880[/code)]

Если локальный запрос работает, проблема может быть связана с firewall, reverse proxy или сетевыми правилами.

Порт 1880 уже занят

Определите процесс:

sudo lsof -i :1880

или:

sudo ss -lntp | grep 1880

Остановите конфликтующий сервис или измените порт Node-RED в settings.js.

Node-RED не запускается после изменения settings.js

Причиной часто становится синтаксическая ошибка.

Проверьте журнал:

sudo journalctl -u nodered -n 100

Верните резервную копию:

cp ~/.node-red/settings.js.backup ~/.node-red/settings.js

После этого перезапустите сервис.

Узлы отображаются как unknown

Это означает, что flow использует модуль, которого нет в текущем окружении.

Проверьте:

Установите нужный модуль и перезапустите Node-RED.

Учетные данные не расшифровываются

Причина может заключаться в неправильном credentialSecret.

Проверьте, что:

Без правильного секрета сохраненные пароли потребуется указать повторно.

Flow не запускается после Deploy

Проверьте:

Добавьте Debug после каждого важного этапа, чтобы определить место остановки.

Node-RED потребляет много CPU

Возможные причины:

Проверьте процессы:

top

Временно отключите подозрительные flows и добавьте ограничение частоты.

Заканчивается память

Проверьте:

free -h

Найдите самые крупные процессы:

ps aux --sort=-%mem | head

При постоянном дефиците:

Когда стоит использовать Node-RED

Задача Подходит ли Node-RED
Интеграция нескольких API Да
Обработка MQTT и IoT-событий Да
Создание webhook-обработчика Да
Быстрый прототип автоматизации Да
Высоконагруженное приложение со сложной бизнес-логикой Может потребоваться отдельный backend
Публичный редактор без авторизации Нет

FAQ

Что такое Node-RED?

Node-RED — это low-code-платформа на базе Node.js для создания автоматизаций и интеграций из визуально соединяемых узлов.

Можно ли установить Node-RED через панель Serverspace?

Да. Node-RED можно выбрать в каталоге 1-Click Apps при создании облачного сервера. Serverspace автоматически подготовит виртуальную машину и приложение.

Какие ресурсы нужны Node-RED?

Для небольшого тестового проекта достаточно 1 vCPU, 1–2 ГБ RAM и 10–20 ГБ диска. Для нескольких постоянных flows рекомендуется от 2 ГБ RAM.

Какой порт использует Node-RED?

Редактор и HTTP endpoints по умолчанию работают на TCP-порту 1880.

Безопасно ли открывать порт 1880 в интернет?

Нет, если редактор не защищен авторизацией. Для удаленного доступа используйте SSH-туннель или reverse proxy с HTTPS и настройте adminAuth.

Можно ли создать API в Node-RED?

Да. Для этого используются узлы HTTP In, Function и HTTP Response. С их помощью можно создавать собственные маршруты и возвращать JSON.

Где хранятся flows?

При стандартной установке пользовательские данные часто находятся в каталоге ~/.node-red. Точный путь зависит от параметра userDir и способа установки.

Можно ли подключить Node-RED к MQTT?

Да. Встроенные MQTT-узлы позволяют получать и отправлять сообщения через MQTT-брокер.

Как защитить пароли в flows?

Используйте credentials узлов, постоянный credentialSecret и переменные окружения. Не вставляйте токены непосредственно в Function nodes.

Можно ли установить дополнительные узлы?

Да. Дополнительные пакеты устанавливаются через Manage palette или npm. Перед установкой следует проверить их происхождение и совместимость.

Нужно ли создавать резервные копии Node-RED?

Да. Сохраняйте flows, credentials, settings.js, package.json, custom nodes и credentialSecret. Минимум одна копия должна храниться вне VPS.

Подходит ли Node-RED для production?

Да, если настроены авторизация, HTTPS, резервное копирование, мониторинг, обработка ошибок и ограничение доступа к редактору.

Разверните Node-RED в Serverspace

Готовое приложение Node-RED в Serverspace позволяет быстро создать сервер для автоматизаций без ручной установки Node.js, npm и самой платформы.

После развертывания вы получаете:

Такое окружение подходит для:

Администратор сохраняет контроль над firewall, обновлениями, журналами, доменом, сертификатами и резервными копиями.

Заключение

Node-RED упрощает создание автоматизаций за счет визуальных flows и готовых узлов для API, MQTT, баз данных, файлов, мессенджеров и других сервисов.

Платформа подходит разработчикам, системным администраторам, инженерам IoT и компаниям, которым необходимо быстро связать разные приложения.

Развертывание через Serverspace сокращает первоначальную подготовку сервера. Достаточно выбрать Node-RED в каталоге приложений, указать ресурсы и создать виртуальную машину.

После первого входа необходимо защитить редактор, настроить HTTPS или SSH-туннель, ограничить сетевой доступ, сохранить credentialSecret и организовать внешнее резервное копирование.