notwendige Voraussetzungen
Um Node-RED lokal zu installieren, benötigen Sie eine unterstützte Version von Node.js.
Node-RED mit npm installieren
Um Node-RED zu installieren, können Sie den in npmnode.js enthaltenen Befehl verwenden:
sudo npm install -g -unsafe-perm node-red
Wenn Sie Windows verwenden, verwenden Sie nicht sudo.
Mit diesem Befehl werden Node-RED und seine Abhängigkeiten als globale Module installiert.
Sie können bestätigen, dass es erfolgreich war, wenn die Befehlsausgabe ähnlich wie die folgende aussieht:
node-red@1.1.0
332 Pakete von 341 Mitwirkenden in 18,494s hinzugefügt
0 Schwachstellen gefunden
Node-RED mit npm installieren
Um es in Docker in seiner einfachsten Form auszuführen, führen Sie einfach aus:
docker run -it -p 1880:1880 -name mynodered nodered/node-red
Weitere Einzelheiten finden Sie in der Node-RED-Anleitung für Docker.
Installation mit Snap
Wenn Ihr Betriebssystem Snap unterstützt, können Sie Node-RED installieren:
sudo snap install node-red
Wenn es als Snap-Paket installiert wird, wird es in einem sicheren Container ausgeführt, der keinen Zugriff auf einige zusätzliche Funktionen hat, die Sie möglicherweise nutzen müssen, wie z. B:
- Zugriff auf den Hauptspeicher des Systems. Nur das lokale Home-Verzeichnis kann gelesen/geschrieben werden.
- gcc - alle Binärkomponenten, die zum Kompilieren von Node für die Installation benötigt werden
- git - erforderlich, wenn Sie die Projektfunktionen nutzen wollen
- Direkter Zugriff auf gpio-Hardware
- Greifen Sie über den Knoten Exec auf alle externen Befehle zu, die Ihr Ablauf verwenden möchte (zum Beispiel).
- Wenn Sie Zugang zu Systemhardware benötigen oder Knoten hinzufügen, die kompiliert werden müssen, empfehlen wir eine vollständige Installation von Node-RED, anstatt Snaps zu verwenden.
Erste Schritte mit Node-RED
Nach der Installation als globales Modul können Sie Node-RED im Terminal mit dem Befehl node-red starten. Sie können Node-RED mit Strg-C oder durch Schließen des Terminalfensters beenden.
$node-rot
Willkommen bei Node-RED====================
30 Jun 23:43:39 - [info] Node-RED Version: 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] Laden von Palettenknoten
30 Jun 23:43:44 - [warn] rpi-gpio : Raspberry Pi spezifischer Knoten inaktiv gesetzt
30 Jun 23:43:44 - [info] Einstellungsdatei: /Users/nol/.node-red/settings.js
30 Jun 23:43:44 - [info] HTTP Static: /Benutzer/nol/node-red/web
30 Jun 23:43:44 - [info] Kontextspeicher: 'default' [module=localfilesystem]
30 Jun 23:43:44 - [info] Benutzerverzeichnis : /Benutzer/nol/.node-red
30 Jun 23:43:44 - [warn] Projekte deaktiviert : set editorTheme.projects.enabled=true um zu aktivieren
30 Jun 23:43:44 - [info] Neue Flussdatei erstellen: flows_noltop.json
30 Jun 23:43:44 - [info] Abläufe starten
30 Jun 23:43:44 - [info] Gestartete Flüsse
30 Jun 23:43:44 - [info] Server läuft jetzt unter http://127.0.0.1:1880/red/
Sie können dann auf den Node-RED-Editor zugreifen, indem Sie in Ihrem Browser auf http://localhost:1880 zeigen.
Die Protokollausgabe liefert Ihnen verschiedene Informationen:
- Node-RED und Node.js-Versionen
- Alle Fehler, die beim Laden des Palettenknotens auftreten
- Der Speicherort Ihrer Einstellungsdateien und Benutzerverzeichnisse
- Der Name der verwendeten Stream-Datei.
Node-REDflows_
Verwendung der Befehlszeile
Node-RED Sie können node-red mit dem Befehl starten. Dieser Befehl kann verschiedene Parameter annehmen:
node-red [-v] [-?] [-settings settings.js] [-userDir DIR]
[-port PORT] [-title TITLE] [-safe] [flows.json|projectName]
[-DX=Y|@file]
| Optionen | beschreiben |
| -p,-Anschluss PORT | Legt den TCP-Port fest, an dem die Laufzeitumgebung lauscht. Standard: 1880 |
| -sicher | Starten Sie Node-RED, ohne einen Stream zu starten. So können Sie den Stream im Editor öffnen und Änderungen vornehmen, ohne dass der Stream läuft. Wenn Sie Ihre Änderungen bereitstellen, wird der Prozess gestartet. |
| -s,-Einstellungen DATEI | Legen Sie die zu verwendende Einstellungsdatei fest. Standard: settings.js in userDir |
| -titleTITL | Titel des Prozessfensters festlegen |
| -u,-userDir DIR | Legen Sie das zu verwendende Benutzerverzeichnis fest. Standard: ~/.node-red |
| -v | Ausführliche Ausgabe einschalten |
| -DX=Y|@file | Einzelne Einstellungen außer Kraft setzen |
| -?,-Hilfe | Hilfe zur Verwendung der Befehlszeile anzeigen und beenden |
| flows.json|projectName | Damit wird die zu verwendende Ablaufdatei festgelegt, wenn die Projektfunktion nicht aktiviert ist. Wenn die Funktion Projekte aktiviert ist, wird hier festgelegt, welches Projekt gestartet werden soll. |
Node-REDflows_
Einzelne Einstellungen außer Kraft setzen
Ausgehend von Node-RED 1.1.0
-D Mit der Option (oder -define) können Sie einzelne Einstellungen in der Befehlszeile außer Kraft setzen.
Um beispielsweise die Protokollierungsstufe zu ändern, können Sie verwenden:
-D logging.console.level=trace
Sie können auch benutzerdefinierte Einstellungen als Datei bereitstellen:
-D @./custom-settings.txt
Die Datei sollte eine Liste der zu überschreibenden Einstellungen enthalten:
logging.console.level=trace
logging.console.audit=true
Übergabe von Parametern an den zugrunde liegenden Node.js-Prozess
Manchmal ist es notwendig, Parameter an den zugrunde liegenden Node.js-Prozess zu übergeben. Zum Beispiel, wenn er auf einem Gerät mit begrenztem Speicher läuft, wie einem Raspberry Pi oder BeagleBone Black.
Dazu müssen Sie das Startskript node-red-pi anstelle von node-red verwenden. Hinweis: Dieses Skript ist unter Windows nicht verfügbar.
Wenn Sie alternativ den Befehl node verwenden, um Node-RED auszuführen, müssen Sie dem node-Prozess Argumente übergeben, bevor Sie red.js angeben, sowie die Argumente, die an Node-RED selbst übergeben werden.
Die folgenden beiden Befehle zeigen beide Methoden:
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/
Upgrade von Node-RED
Wenn Sie Node-RED als globales npm-Paket installiert haben, können Sie mit dem folgenden Befehl auf die neueste Version aktualisieren:
sudo npm install -g -unsafe-perm node-red
Wenn Sie Windows verwenden, verwenden Sie nicht sudo.