# 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 1. Das Projekt oder mindestens den vollständigen Ordner `linux-app` auf den NUC kopieren. Die folgenden Befehle dort in einer lokalen Shell ausführen. 2. 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-service` beenden. Andere mDNS-Dienste erhalten. 3. Im Projektverzeichnis ausführen: ```bash 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: ```bash 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: ```bash 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 ```bash 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.conf` darf `wlp2s0` nicht 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: ```bash 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 - [Debian: statische Avahi-Dienste](https://manpages.debian.org/trixie/avahi-daemon/avahi.service.5.en.html) - [Debian: avahi-browse und gültige Optionen](https://manpages.debian.org/trixie/avahi-utils/avahi-browse.1.en.html) - [InfluxDB: Health-Prüfung](https://docs.influxdata.com/influxdb/v2/api/health/) ## 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.