Add a Debian NUC installer, IPv4 service definition and usage guide with backup and legacy alias migration. Document the user-confirmed SEN54-to-InfluxDB connection without including credentials.
InfluxDB auf dem Linux-NUC per Avahi bekannt machen
Diese Dateien richten eine dauerhafte mDNS/DNS-SD-Ankündigung für die vorhandene ESP32-Firmware ein. Avahi läuft auf dem Debian-13-NUC, außerhalb von Docker. Die Konfiguration wird nach einem NUC-Neustart automatisch geladen.
Vorgesehener Aufbau
| Einstellung | Wert |
|---|---|
| NUC-WLAN/AP-Interface | wlp2s0 |
| NUC-WLAN-Adresse | 192.168.50.1/24 |
| InfluxDB-URL für den ESP | http://192.168.50.1:8086 |
| Diensttyp | _influxdb2._tcp.local. |
| Dienstname | nanoPSX InfluxDB NUC |
| mDNS-Hostname | vorhandener Avahi-Hostname, auf diesem NUC nuc.local |
Der ESP muss mit dem NUC-WLAN verbunden sein. Der InfluxDB-Container muss Port
8086 an 192.168.50.1 veröffentlichen; das ist beim untersuchten NUC bereits
eingerichtet. Ein fehlender Listener an 127.0.0.1:8086 ist dabei erwartbar.
Der Dienst verwendet den vorhandenen Avahi-Hostnamen (nuc.local auf diesem
NUC). Es wird kein zusätzlicher Hostname für dieselbe IP registriert, da dies bei
Avahi eine lokale Namenskollision verursachen kann. Auf dem WLAN muss die
Auflösung 192.168.50.1 liefern; dies nach der Installation prüfen. Die allgemeine
Avahi-Interface-Konfiguration bleibt erhalten. Die Ankündigung kann auch auf
anderen von Avahi bedienten Interfaces sichtbar sein. Kein mDNS-Reflector wird
eingerichtet.
Installation
-
Das Projekt oder mindestens den vollständigen Ordner
linux-appauf den NUC kopieren. Die folgenden Befehle dort in einer lokalen Shell ausführen. -
Das frühere Python-mDNS-Skript bzw. dessen Systemdienst für diese InfluxDB-Ankündigung beenden und dessen Autostart deaktivieren. Ebenso einen laufenden Test mit
avahi-publish-servicebeenden. Andere mDNS-Dienste erhalten. -
Im Projektverzeichnis ausführen:
sudo bash linux-app/install-avahi.sh
Das Skript prüft die AP-Adresse und InfluxDB /health, installiert mit APT
avahi-daemon, avahi-utils, curl und python3, sichert vorhandene Dateien
unter /var/backups/nanopsx-avahi/install.* und installiert:
/etc/avahi/services/nanopsx-influxdb.service- keinen neuen Eintrag in
/etc/avahi/hosts. Der exakt markierte Alias der ersten Skriptversion wird nach Sicherung entfernt, falls vorhanden.
Andere Hosteinträge und Dienste bleiben erhalten. Eine unbekannte abweichende Dienstdatei führt zum Abbruch. Die unveränderte erste Version der mitgelieferten Dienstdatei wird anhand ihres SHA-256 erkannt und automatisch aktualisiert. Wiederholtes Ausführen mit unveränderten Einstellungen erzeugt keine doppelten Hosteinträge. Ein fehlgeschlagener Installationslauf ist kein Erfolgsnachweis; die ausgegebenen Fehler zuerst prüfen. Bereits installierte Pakete bleiben bei einem späteren Fehler installiert.
Es werden weder Docker, Firewall, WireGuard, SSH noch ESP-Firmware geändert. Es sind keine Influx-Tokens oder WLAN-Passwörter in diesen Dateien erforderlich.
Funktion prüfen
Auf dem NUC:
systemctl is-enabled avahi-daemon.service
systemctl is-active avahi-daemon.service
curl --noproxy '*' -fsS --max-time 5 http://192.168.50.1:8086/health
avahi-browse -r -t _influxdb2._tcp
Erwartet: enabled, active, Health-Status pass und beim aufgelösten Dienst
auf Interface wlp2s0 mit IPv4 die Adresse 192.168.50.1, Port 8086
und Hostname nuc.local (sofern der Rechnername nicht geändert wurde).
avahi-browse unterstützt weder -4 noch -i; die Ausgabe enthält Interface
und IP-Protokoll als Spalten.
Zusätzlich von einem anderen Linux-Rechner im NUC-WLAN prüfen, sofern verfügbar:
avahi-browse -r -t _influxdb2._tcp
curl --noproxy '*' -fsS --max-time 5 http://192.168.50.1:8086/health
Ein lokaler NUC-Test allein beweist noch keine Erreichbarkeit vom ESP. Die Firmware sucht ungefähr alle 60 Sekunden, bis sie einen Dienst gefunden hat, und speichert dessen URL. Hat sie bereits einen anderen Dienst gefunden, den ESP einmal neu starten, nachdem die richtige Ankündigung aktiv ist.
Die seriellen ESP-Logs sollen anschließend mDNS URL: http://192.168.50.1:8086
zeigen. Erst erfolgreiche Influx-Schreibvorgänge mit HTTP-Status 204 und
aktuelle Messwerte im Influx-Bucket bestätigen die vollständige Verbindung.
Organisation, Bucket und ein Token mit Schreibrecht für diesen Bucket müssen
zusätzlich im ESP-Konfigurationsportal hinterlegt sein. Tokens dort lokal
eingeben und nicht in Git oder Diagnoseausgaben veröffentlichen.
Avahi kündigt statisch an: Es überwacht die Verfügbarkeit des Containers nicht.
Die Installation prüft /health einmalig. Nach einem NUC-Neustart kann die
Ankündigung schon sichtbar sein, bevor InfluxDB bereit ist; die Firmware muss
Verbindungsversuche wiederholen.
Fehler untersuchen
journalctl -u avahi-daemon.service -b --no-pager -n 80
ip -br -4 addr
ss -ltn '( sport = :8086 )'
- Kein Dienst gefunden: Avahi-Status und Logs prüfen. In
/etc/avahi/avahi-daemon.confdarfwlp2s0nicht ausgeschlossen und Publishing nicht deaktiviert sein. Das Installationsskript überschreibt diese Einstellungen bewusst nicht. - Nur lokal sichtbar: Firewall für mDNS (UDP 5353, IPv4-Multicast
224.0.0.251) auf dem WLAN und mögliche AP-Client-Isolation prüfen. - HTTP-Timeout: TCP 8086 vom WLAN, Docker-Portfreigabe und Firewall prüfen.
- HTTP 401/403: Influx-Token und dessen Bucket-Schreibrechte prüfen.
- Mehrere Influx-Dienste: Die Firmware nimmt einen passenden Treffer. Alte konkurrierende Ankündigungen entfernen, bevor die Erkennung erneut startet.
Keine Firewall-Regeln pauschal löschen und keine unbekannten Dienste abschalten. Für einen anderen AP die Adresse und das Interface im Installationsskript gezielt anpassen und die Auflösung auf dem neuen WLAN prüfen.
Ankündigung entfernen
Nur die von dieser Einrichtung angelegten Einträge entfernen:
sudo rm /etc/avahi/services/nanopsx-influxdb.service
sudo systemctl reload avahi-daemon.service
Falls die Dateien inzwischen manuell geändert wurden, vor dem Entfernen prüfen. Vorhandene Hosteinträge bleiben erhalten. Avahi und seine anderen Dienste bleiben aktiv. Die Sicherung enthält die vorherigen Dateien; diese nicht pauschal zurückkopieren, wenn inzwischen weitere Änderungen vorgenommen wurden.
Referenzen
Getesteter Stand (2026-11-07)
Skriptsyntax, XML, Installation und Migration der ersten Konfiguration wurden
im Entwicklungscontainer mit isolierten Systemaufrufen geprüft. Der Benutzer
hat die Konfiguration auf dem Debian-NUC installiert und die korrigierte
Dienstdatei ohne zusätzlichen Hostnamen eingesetzt. Seine avahi-browse-Ausgabe
bestätigt auf wlp2s0 die Auflösung von nuc.local zu 192.168.50.1:8086.
Serielle Tests des ESP bestätigten anschließend HTTP-Verbindungen zu dieser
Adresse. Nach Einrichtung von Organisation Home, Bucket nanoPSX und einem
passenden Token hat der Benutzer die funktionierende SEN54-Übertragung zu
InfluxDB bestätigt. Diese abschließende Funktionsbestätigung stammt vom Benutzer;
eine weitere serielle Aufzeichnung mit erfolgreichen Schreibantworten wurde
danach nicht erstellt. Zugangsdaten gehören nicht in diese Dokumentation.