Open Source · Self-hosted · MIT-Lizenz

Relay-Steuerung.
Vollständig unter Ihrer Kontrolle.

RelayControlServer ist eine self-hosted Weboberfläche zur Steuerung von Ethernet-Relaisgeräten über Modbus TCP. Unterstützt Waveshare POE ETH und kompatible Hardware mit bis zu 64 Kanälen.

Funktionen

Was RelayControlServer bietet

Entwickelt für den professionellen Einsatz in Gebäudeautomation, Industrie und Labor.

Modbus TCP
Unterstützt Waveshare POE ETH Relaisgeräte sowie alle Modbus-TCP-kompatiblen Geräte. Bis zu 64 Kanäle pro Gerät, mehrere Geräte gleichzeitig.
REST API
Vollständige REST API zur Integration in eigene Systeme. API-Token-Verwaltung mit fein granulierter Zugriffskontrolle pro Relay und Methode.
Benutzerverwaltung
Mehrbenutzerbetrieb mit rollenbasiertem Berechtigungssystem. Admins verwalten Benutzer und deren Zugriffsrechte auf einzelne Relais.
iOS App
Native iOS-App zur Steuerung direkt vom iPhone. Verbindet sich mit Ihrer eigenen Serverinstanz — keine Drittanbieter, keine Cloud.
Seiten
Relais lassen sich in frei gestaltbare Seiten gruppieren. Ideal für Gebäudebereiche, Produktionslinien oder Anlagenabschnitte.
Self-hosted
Läuft vollständig auf Ihrer eigenen Infrastruktur. Keine Cloud, keine externe Abhängigkeiten, keine Abonnements. Geeignet für Netzwerke ohne Internetzugang.
Installation

In wenigen Minuten betriebsbereit

RelayControlServer läuft auf jedem Linux-Server mit Node.js. Keine Datenbank-Engine, keine externen Dienste erforderlich.

1
Repository klonen
Klonen Sie das Repository auf Ihren Server oder laden Sie das aktuelle Release herunter.
git clone https://github.com/vilsmeier-systems/relay-control-server
2
Abhängigkeiten installieren
Node.js 18 oder neuer ist erforderlich. Alle Abhängigkeiten werden über npm installiert.
npm install
3
Konfiguration anpassen
Kopieren Sie die Beispielkonfiguration und passen Sie Port sowie Datenbankpfad an Ihre Umgebung an.
cp config.example.json config.json
4
Server starten
Starten Sie den Server. Für den Dauerbetrieb empfehlen wir systemd oder pm2. Beim ersten Start wird automatisch ein Admin-Konto angelegt.
node server/index.js
Plattformen

Steuerung von überall

Zugriff über den Browser vom Desktop oder Laptop — kein separates Programm notwendig. Die Weboberfläche ist für alle Bildschirmgrößen optimiert.

Die native iOS-App ermöglicht Steuerung direkt vom iPhone. Verbindet sich ausschließlich mit Ihrer eigenen Serverinstanz. Für den Betrieb über eine Domain mit gültigem SSL-Zertifikat empfohlen — im lokalen Netz auch per HTTP nutzbar.

Die REST API erlaubt die vollständige Integration in Drittsysteme, Automatisierungslösungen und eigene Applikationen.

Webbrowser
Web Interface
Verfügbar
iPhone / iPad
iOS App
Verfügbar
HTTP / JSON
REST API
Verfügbar
Android
Android App
Geplant
Open Source

Quellcode offen auf GitHub

MIT-lizenziert. Einsehbar, prüfbar, anpassbar. Beiträge willkommen.

Zum GitHub-Repository