WebUI Benutzung

Die WebUI von OpenCCU entspricht in Aufbau und Bedienung weitgehend der WebUI der originalen CCU3. Im Folgenden werden einige Funktionen beschrieben, die OpenCCU zusätzlich mitbringt bzw. die für den Betrieb von OpenCCU besonders relevant sind.

Meldungen und Ereignisse auf Geräteebene (z. B. zyklische Statusmeldungen von Aktoren/Sensoren) findest du hier:

• Status und Bedienung → Systemprotokoll Dort kannst du Einträge aktualisieren, löschen und die Daten über den Browser herunterladen. In gewissem Rahmen lassen sich die erzeugten Statusmeldungen über die Gerätekonfiguration einschränken.

Weiterführende Log-Funktionen findest du unter:

• Einstellungen → Systemsteuerung → Zentralen-Wartung → Fehlerprotokoll Hier lässt sich der Log-Level getrennt für die Komponenten Homematic IP (HMIPServer), BidCos-RF, BidCos-Wired, die CCU-Steuerung und die Logikschicht (ReGaHss) einstellen. Zusätzlich kann unter Syslog-Server Adresse ein Rechner angegeben werden, an den OpenCCU seine Logmeldungen per Syslog weiterleitet (auf diesem Rechner muss eine entsprechende Software installiert sein). Über Logdatei herunterladen lassen sich die aktuellen Logmeldungen zu Diagnosezwecken als Textdatei herunterladen, z. B. für eine Hilfeanfrage.

Eine dritte Quelle für Log-Daten und ggf. eigene Log-Einstellungen ergibt sich abhängig von installierter Zusatzsoftware:

• Einstellungen → Systemsteuerung → Zusatzsoftware Detailinformationen und Konfigurationsmöglichkeiten entnimmst du bitte der Dokumentation des jeweiligen Add-ons.

Unter Einstellungen → Systemsteuerung → Erweiterte Einstellungen lassen sich verschiedene OpenCCU-spezifische Funktionen ein- bzw. ausschalten, die bei der originalen CCU3 nicht vorhanden sind. Zu jeder Option wird in der WebUI zusätzlich ein Hilfetext angezeigt.

WatchDog-Optionen

System-Optionen

Experten-Optionen

Die Einstellungen werden jeweils als Dateien unter /etc/config gespeichert (z. B. NoCronBackup, CronBackupPath, disableLED, AllowExternalAccess) und können alternativ auch per SSH gesetzt werden.

Für einen sicheren Fernzugriff auf OpenCCU von unterwegs – ohne Port-Weiterleitung im Router – enthält OpenCCU einen integrierten Tailscale-VPN-Client. Voraussetzung ist ein (kostenloses) Tailscale-Konto.

1. In der WebUI unter Einstellungen → Systemsteuerung → Netzwerkeinstellungen die Option Tailscale VPN-Funktion aktivieren und die Einstellungen übernehmen.
2. Anschließend auf Authentifizierung klicken. Es öffnet sich die Tailscale-Anmeldeseite, über die OpenCCU mit dem eigenen Tailscale-Konto verbunden und in das persönliche VPN-Netzwerk aufgenommen wird.
3. Danach ist OpenCCU von allen Geräten, die mit demselben Tailscale-Netzwerk verbunden sind, über ihre Tailscale-IP-Adresse (bzw. ihren Tailscale-Namen) erreichbar.

Zugriffe über das Tailscale-Netzwerk gelten für die Firewall von OpenCCU als lokale Zugriffe. Bei einer Unterbrechung der VPN-Verbindung wird die Alarmmeldung WatchDog: tailscale0-down erzeugt.

Für verschlüsselte HTTPS-Verbindungen erzeugt OpenCCU automatisch ein eigenes, selbstsigniertes Zertifikat. Wenn du eine eigene PKI betreibst und das Root-Zertifikat bereits auf deine Endgeräte verteilt hast, kannst du stattdessen ein von deiner CA signiertes Zertifikat verwenden. Voraussetzung ist das vom Webserver erwartete Datei-/Formatlayout:

• Die Datei muss server.pem heißen.

• Die Inhalte werden in einer PEM-Datei in dieser Reihenfolge abgelegt:

  1. Server-Zertifikat
  2. Zertifikate der Intermediate-CAs (falls vorhanden)
  3. Privater Schlüssel des Server-Zertifikats

  Das Server-Zertifikat muss dabei an erster Stelle stehen, da der Webserver und die Prüfung auf ein ablaufendes Zertifikat das erste Zertifikat der Datei als Server-Zertifikat verwenden. Das Root-Zertifikat der CA wird nicht benötigt.

Ein Beispielaufbau (PEM-Blöcke jeweils vollständig einfügen):

-----BEGIN CERTIFICATE-----
…Server-Zertifikat…
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
…Zertifikat der Intermediate-CA…
-----END CERTIFICATE-----
-----BEGIN PRIVATE KEY-----
…Inhalt des privaten Schlüssels…
-----END PRIVATE KEY-----

Hinweis: Läuft das in server.pem hinterlegte Zertifikat in weniger als 24 Stunden ab oder ist es ungültig, ersetzt OpenCCU es beim nächsten Start des Webservers automatisch durch ein neu erzeugtes, selbstsigniertes Zertifikat. Das bisherige Zertifikat wird dabei als server.pem_JJJJMMTT gesichert. Ein bald ablaufendes Zertifikat wird zudem mit der Alarmmeldung WatchDog: lighttpd-expired-sslcert gemeldet.

• Per WebUI: Unter Einstellungen → Systemsteuerung → Netzwerkeinstellungen die Datei server.pem auswählen und über Hochladen übertragen. Der Webserver wird anschließend automatisch neu gestartet.
• Per SCP: Alternativ kann die Datei per scp auf das System kopiert werden:

  scp server.pem root@<openccu-DNS-Name-oder-IP>:/usr/local/etc/config/

  Nach einem Upload per SCP wird der Webserver nicht automatisch neu gestartet. Das neue Zertifikat ist erst nach einem Neustart des Webservers aktiv:

  /etc/init.d/S50lighttpd restart