Benachrichtigungen

E-Mail-Benachrichtigungen: SMTP, Empfänger, Ereignisse, Test-Mail.

Bunkerbox meldet Probleme und wichtige Ereignisse per E-Mail. Alle Einstellungen liegen in der Oberfläche unter System → Benachrichtigungen; es gibt keine SMTP-Einstellungen in bunkerbox.env.

Einrichten

1. SMTP-Server eintragen: Hostname oder IP-Adresse, Verschlüsselung und Port.

   Verschlüsselung	Port	Verwendung
   STARTTLS	587	Standard bei den meisten Anbietern (Submission)
   TLS	465	Verschlüsselt ab dem ersten Byte („SMTPS“)
   Keine	25	Nur für ein Relay im eigenen Netz, ohne Anmeldung

   Beim Wechsel der Verschlüsselung wird der übliche Port vorgeschlagen.

2. Absender: Viele Anbieter verlangen, dass der Absender zum Konto passt.

3. Anmeldung (optional): Benutzername und Passwort. Eine Anmeldung ist nur mit TLS oder STARTTLS erlaubt, damit das Passwort nie unverschlüsselt übertragen wird.

4. Empfänger: bis zu 20 Adressen. Jede Benachrichtigung geht in einer einzigen E-Mail an alle.

5. E-Mail-Benachrichtigungen senden einschalten und speichern.

6. Test-Mail senden prüft die Einstellungen sofort; ein Fehler (z. B. falsches Passwort, Verbindung abgelehnt) wird mit der Antwort des Servers angezeigt.

Zertifikat des Servers prüfen ist voreingestellt. Nur für ein eigenes Relay mit selbstsigniertem Zertifikat ausschalten – ohne Prüfung könnte sich ein Angreifer im Netzwerk als Mail-Server ausgeben.

Beispiele:

Anbieter	Server	Verschlüsselung
Gmail / Google Workspace	smtp.gmail.com	STARTTLS 587, App-Passwort nötig
Microsoft 365	smtp.office365.com	STARTTLS 587
GMX	mail.gmx.net	STARTTLS 587
Fritz!Box als Relay	IP der Fritz!Box	je nach Einstellung

Passwort

Das SMTP-Passwort steht nur in /appdata/bunkerbox/data/secrets/smtp-password (Verzeichnis 700, Datei 600, nur root). Die Oberfläche zeigt nur, ob ein Passwort gespeichert ist. Beim Speichern bleibt es erhalten, solange Passwort ändern nicht gewählt ist; ein leeres neues Passwort oder ein leerer Benutzername entfernt es.

Ereignisse

Für jedes Ereignis lässt sich die E-Mail einzeln abwählen. Ereignisse melden die jeweiligen Bereiche; die Benachrichtigungen entscheiden zentral über den Versand.

Ereignis	Bereich
Pool beeinträchtigt, Pool ausgefallen, Gerätefehler, Scrub mit Fehlern	Speicher
SMART: Platte fällt aus, SMART-Warnung, Plattentemperatur, Burn-in beendet	Speicher
USV auf Batterie (auch: Strom zurück), USV-Akku schwach, Herunterfahren durch USV	USV
Backup fehlgeschlagen	Backup
Update verfügbar (einmal pro Version)	Updates
Anmeldung von neuer Adresse (standardmäßig aus)	Sicherheit

Jedes Ereignis hat einen Schweregrad (Info, Warnung, kritisch), der in Verlauf und E-Mail angezeigt wird.

Entprellung und Begrenzung

• Gleiches Ereignis höchstens alle … (Standard 360 Minuten): Besteht ein Problem weiter (z. B. ein beeinträchtigter Pool), wird es erst nach dieser Zeit erneut gemeldet. Gleich ist ein Ereignis mit demselben Schlüssel, z. B. pool-degraded:tank; ein zweiter Pool wird sofort gemeldet. Der Zustand übersteht einen Neustart.
• Höchstens pro Stunde (Standard 20): Weitere E-Mails werden unterdrückt und im Verlauf als Unterdrückt vermerkt. Kritische Ereignisse werden immer gesendet.
• Schlägt der Versand fehl, wird das Ereignis frühestens nach 15 Minuten erneut versucht, wenn es dann noch besteht.

Verlauf

Der Reiter Verlauf zeigt die letzten 200 Ereignisse mit Zeit, Schweregrad, Betreff und Versand: Gesendet, Fehlgeschlagen (mit der Antwort des Servers), Unterdrückt (Stundenlimit) oder Nicht gesendet (ausgeschaltet, nicht eingerichtet oder Ereignis abgewählt). Wiederholungen innerhalb der Entprellzeit erscheinen nicht erneut. Die Dashboard-Karte zeigt Zustand, letzte gesendete E-Mail und Fehler der letzten 24 Stunden.

Inhalt der E-Mails

Betreff [<Hostname>] <Ereignis>, Text in der eingestellten Sprache mit Beschreibung, Details, Schweregrad, Server und Zeit. Die E-Mails sind reiner Text (UTF-8) und als automatisch erzeugt gekennzeichnet (Auto-Submitted: auto-generated), damit Abwesenheitsnotizen nicht antworten.

Im Mock-Modus werden keine E-Mails versendet; sie erscheinen nur im Konsolenprotokoll. Ein Servername, der auf .invalid endet, simuliert dort einen Fehler.