NexoWatt EOS Admin

NexoWatt EOS Admin ist die Administrationsoberfläche für das Energy Operation System.

Diese Ausgabe ist bewusst als eigenständiger ioBroker-Adapter aufgebaut:

Technischer Adaptername: eos-admin
npm-Paketname:          iobroker.eos-admin
Sichtbarer Name:        NexoWatt EOS Admin
Standard-Port:          8091

Damit überschreibt der Adapter den offiziellen admin-Adapter nicht mehr. Die alte ioBroker-Admin-Oberfläche kann parallel vorhanden bleiben, während NexoWatt-Systeme über eos-admin.0 die EOS-Oberfläche nutzen.

Installation über das NexoWatt Repository

Im NexoWatt Repository muss der Adapter unter dem Key eos-admin stehen. Da das npm-Paket unscoped iobroker.eos-admin heißt, ist kein packetName nötig.

Minimaler Repository-Eintrag:

{
  "eos-admin": {
    "name": "eos-admin",
    "version": "7.9.29",
    "title": "NexoWatt EOS Admin",
    "desc": {
      "de": "NexoWatt EOS Administrationsoberfläche als eigenständiger Adapter.",
      "en": "NexoWatt EOS administration interface as a standalone adapter."
    },
    "meta": "https://iobroker.live/repo/eos-admin/io-package.json",
    "icon": "https://iobroker.live/repo/eos-admin/admin.png"
  }
}

Installation auf dem Zielsystem:

cd /opt/iobroker
iobroker repo set nexowatt
iobroker update
iobroker install eos-admin
iobroker upload eos-admin
iobroker start eos-admin.0

Danach ist die Oberfläche standardmäßig erreichbar unter:

http://DEINE-IP:8091

Migration vom offiziellen Admin

Empfohlener sicherer Ablauf:

cd /opt/iobroker

# 1. EOS Admin parallel installieren und testen
iobroker install eos-admin
iobroker upload eos-admin
iobroker start eos-admin.0

# 2. Im Browser testen
# http://DEINE-IP:8091

# 3. Wenn alles sauber läuft, offiziellen Admin stoppen
iobroker stop admin.0

# 4. EOS Admin auf Standard-Port setzen
iobroker set eos-admin.0 --port 8081 --enabled true
iobroker restart eos-admin.0

Danach läuft NexoWatt EOS Admin unter:

http://DEINE-IP:8081

Den offiziellen admin-Adapter erst löschen, wenn der Zugriff über eos-admin.0 zuverlässig funktioniert.

EOS Rollen- und Löschschutz

Ab Version 7.9.25 überwacht der EOS Admin sensible Systembereiche direkt:

• Der alte admin-Adapter und admin.0 werden für Benutzer außerhalb der konfigurierten EOS-Admin-Gruppen ausgeblendet.
• admin.0 bleibt durch den Security Guard deaktiviert und auf 127.0.0.1:18081 verschoben, solange die Legacy-Admin-Sperre aktiv ist.
• Geschützte Adapter können vom Installateur- oder Endkundenbereich nicht gelöscht werden. Die Löschbuttons werden für Nicht-Administratoren ausgeblendet beziehungsweise deaktiviert.
• Die Schutzliste wird vom Administrator im Bereich EOS security gepflegt. Updates bleiben möglich, weil dontDelete=false und nondeletable=false bleiben. Der Schutz läuft über Administrator-ACLs, EOS-UI-Regeln und den Security Guard.

Standardmäßig geschützt:

eos-admin
backitup

Administratoren können weitere Adapter in der Tabelle Protected adapters ergänzen. Die sichtbaren Admin-Gruppen werden über EOS admin groups definiert, standardmäßig administrator.

Updates

Da eos-admin ein eigener Adapter ist, laufen Updates unabhängig vom offiziellen admin-Adapter:

iobroker update
iobroker upgrade eos-admin
iobroker upload eos-admin
iobroker restart eos-admin.0

Veröffentlichung auf npm

npm login
npm publish

Die Version muss vor jedem erneuten Publish erhöht werden.

Lizenz

Die NexoWatt EOS Oberfläche, das Branding, das Layout und alle NexoWatt-spezifischen Anpassungen sind proprietär. Die öffentliche technische Bereitstellung über npm oder ein Repository ist keine Open-Source-Lizenz und keine allgemeine Nutzungserlaubnis.

Details stehen in:

LICENSE
NEXOWATT_PROPRIETARY_LICENSE.md
THIRD_PARTY_NOTICES.md

7.9.29

• Self-Update über die EOS-Oberfläche repariert: der gebaute Adapter-Bundle nutzt jetzt eos-admin statt admin für den Webserver-Updatepfad.
• eos-admin wird im Update-Alle-Dialog übersprungen, damit sich die laufende Oberfläche nicht selbst über den normalen Terminal-Befehl beendet.
• Objektbasierte Löschsperren (dontDelete/nondeletable) werden für EOS Admin entfernt, damit Updates nicht blockiert werden. Der Schutz bleibt über EOS-UI, Rollen und ACLs aktiv.

7.9.27

• Header-Logo links optisch verstärkt und leicht nach oben gesetzt.
• Benutzername/Kontoanzeige oben rechts kontrastreicher dargestellt.

v29 Update-Fix

Version 7.9.29 entfernt den harten common.dontDelete-Schutz vom eos-admin Adapterobjekt. Dieser harte Objekt-Flag kann den ioBroker-Upgrade-Ablauf stören. Der EOS Admin bleibt für Installateur-/Endkundenrollen geschützt, bleibt aber updatefähig, weil der Schutz jetzt über ACLs, UI-Regeln und den Security Guard läuft.

Empfohlene Reparatur auf bestehenden Anlagen:

cd /opt/iobroker
iobroker object set system.adapter.eos-admin common.dontDelete=false || true
iobroker object set system.adapter.eos-admin common.nondeletable=false || true
iobroker object set system.adapter.eos-admin.0 common.dontDelete=false || true
iobroker object set system.adapter.eos-admin.0 common.nondeletable=false || true
iobroker upgrade eos-admin https://iobroker.live/repo/repo-nexowatt.json
iobroker upload eos-admin
iobroker restart eos-admin.0

v7.9.29 update reliability note

This release fixes the EOS Admin self-update path. Previous standalone builds could still route the eos-admin update through the normal adapter command dialog in the prebuilt frontend bundle. Because EOS Admin is the active web interface, that path can terminate the running web process during the update. Version 7.9.29 routes the eos-admin adapter card update through the webserver update flow and excludes eos-admin from bulk update-all operations. The repository metadata must also keep stopBeforeUpdate: false and valid meta/icon URLs.

If an older installation has stale update-blocking object flags, repair them once with:

cd /opt/iobroker
node /opt/iobroker/node_modules/iobroker.eos-admin/tools/nexowatt-repair-eos-admin-update.cjs

NexoWatt EOS v7.9.40 Update-Hinweis

Diese Version korrigiert den Repository-Update-Pfad für den eigenständigen Adapter eos-admin. Der Repository-Eintrag muss packetName: "iobroker.eos-admin" enthalten, damit ioBroker beim Update nicht den falschen Paketpräfix verwendet. Technische Paketnamen in Befehls-/npm-Dialogen werden nicht mehr zu Branding-Text umgeschrieben, damit Fehlermeldungen eindeutig bleiben.

NexoWatt EOS v7.9.42 Force-Update-Hinweis

Dieses Paket hebt die sichtbare Adapter-Version und die EOS-Frontend-Cache-Buster auf v7.9.42 an. Es enthält den Delete-/DP-Write-Fix aus v7.9.41 und sorgt dafür, dass Browser nicht weiter die v40-Hilfsskripte verwenden.

NexoWatt EOS v7.9.45 Dienste/Module Delete Hardfix

Fixes trash-icon deletion. DOM security scripts no longer capture delete clicks; only EOS core adapters stay protected and stale delete locks are repaired automatically.