FUXA auf Geräten der reComputer RK-Serie installieren

Zuletzt aktualisiert:

FUXA ist eine browserbasierte SCADA/HMI- und Dashboard-Plattform. Sie verbindet sich mit Datenquellen wie MQTT, Modbus und OPC UA und zeigt deren Werte auf Überwachungsbildschirmen an. Diese Anleitung zeigt die Installation auf dem reComputer RK3576 und die Prüfung des Dienstes und Webeditors.

Umgebung: reComputer RK3576 DevKit mit ARM64 Armbian (Debian Bookworm) und installiertem Docker. Das Image latest kann sich ändern. Für reproduzierbare Bereitstellungen sollten Sie eine geprüfte Image-Version oder einen Digest festlegen.

Vorbereitungen

  • Verbinden Sie RK3576 und Computer mit einem vertrauenswürdigen Netzwerk.
  • Stellen Sie SSH- oder Terminalzugriff auf den RK3576 und einen funktionsfähigen Docker Engine bereit.
  • Prüfen Sie, ob auf dem Systemlaufwerk genug Platz für das Image vorhanden ist.

Prüfen Sie die Umgebung auf dem RK3576:

bash
uname -m
cat /etc/os-release
docker --version
df -h /

uname -m sollte aarch64 ausgeben. Falls Docker fehlt, installieren und starten Sie Docker Engine nach den Anweisungen für Ihr Armbian-Image.

Schritt 1: FUXA-ARM64-Image herunterladen

bash
sudo docker pull --platform linux/arm64 frangoteam/fuxa:latest

Wenn der Download wegen Zeitüberschreitung scheitert, prüfen Sie die Verbindung zu Docker Hub. Ein Proxy nur in der SSH-Shell wird nicht automatisch für den Docker-Daemon eingerichtet. Falls ein Proxy nötig ist, folgen Sie den Docker-Anweisungen zum Daemon-Proxy und verwenden Sie die Proxy-Adresse Ihres Netzwerks.

Schritt 2: Container starten

Starten Sie nach dem Herunterladen den FUXA-Container:

bash
sudo docker run -d \
  --name fuxa-rk3576 \
  --platform linux/arm64 \
  --network host \
  --restart unless-stopped \
  -v fuxa_rk3576_appdata:/usr/src/app/FUXA/server/_appdata \
  -v fuxa_rk3576_db:/usr/src/app/FUXA/server/_db \
  -v fuxa_rk3576_logs:/usr/src/app/FUXA/server/_logs \
  -v fuxa_rk3576_images:/usr/src/app/FUXA/server/_images \
  frangoteam/fuxa:latest

-d startet FUXA im Hintergrund. Statt einer Webseite wird daher erwartungsgemäß eine Container-ID ausgegeben. Benannte Volumes speichern Projektdaten, Verlauf, Protokolle und hochgeladene Bilder. Der Befehl nutzt das Linux-Hostnetzwerk, daher ist -p 1881:1881 nicht erforderlich. Lassen Sie Port 1881 nur in einem vertrauenswürdigen Netzwerk zu und richten Sie vor einer größeren Freigabe Zugriffsschutz ein.

Schritt 3: Dienst prüfen

bash
sudo docker ps --filter name=fuxa-rk3576
sudo docker logs --tail 40 fuxa-rk3576
curl -I http://127.0.0.1:1881/
hostname -I

Der Container sollte Up anzeigen, in den Protokollen sollte FUXA started! stehen und die lokale Webanfrage sollte eine HTTP-Antwort erhalten. Öffnen Sie auf einem Computer im selben vertrauenswürdigen Netzwerk die LAN-Adresse des RK3576 aus hostname -I:

  • Laufzeitseite: http://<RK3576_IP>:1881/
  • Webeditor: http://<RK3576_IP>:1881/editor

Die Laufzeitseite kann anfangs leer sein, weil noch keine Visualisierung erstellt wurde.

Schritt 4: Editor prüfen

Öffnen Sie den Editor und wählen Sie MainView im Bereich Views. Platzieren Sie als einfachen Test ein Textelement aus General auf der Arbeitsfläche und geben Sie beispielsweise RK3576 FUXA test ein. Speichern Sie mit dem Diskettensymbol und öffnen Sie die Vorschau. Prüfen Sie, ob der gespeicherte Text in der Laufzeitansicht erscheint.

Damit sind FUXA und der Editor einsatzbereit. Echtzeit-Gerätedaten, MQTT-Verbindung, Alarm und SCADA-Prozess sind noch nicht eingerichtet.

Fehlerbehebung

  • Seite vom Computer nicht erreichbar: Prüfen Sie den Containerstatus, curl -I http://127.0.0.1:1881/ auf dem RK3576, die LAN-IP sowie Netzwerk und Firewall für Port 1881.
  • Laufzeitseite leer: Öffnen Sie /editor und speichern Sie eine Ansicht. Eine anfangs leere Seite allein ist kein Installationsfehler.
  • Image-Download fehlgeschlagen: Prüfen Sie Speicherplatz und Netzwerk-/Proxy-Einstellungen des Docker-Daemons. Löschen Sie andere Images nicht ohne Prüfung.

Nächste Schritte

Nach der Installation finden Sie in der FUXA-Dokumentation Anleitungen zum Verbinden von Datenquellen, Verknüpfen von Tags mit Anzeigen und Diagrammen und Anzeigen von Live-Daten auf der Laufzeitseite.