USV am Homeserver: bei Stromausfall sauber herunterfahren
So fährt Dein Homeserver oder Raspberry Pi bei Stromausfall automatisch herunter: passende USV wählen, NUT unter Debian einrichten und sicher testen.
Von Nathan Base
Ein kurzer Stromausfall reicht, und auf Deinem Homeserver, NAS oder Raspberry Pi bleibt eine halb geschriebene Datenbank oder ein beschädigtes Dateisystem zurück. Eine USV (unterbrechungsfreie Stromversorgung) überbrückt die ersten Minuten, aber erst die Software sorgt dafür, dass der Rechner rechtzeitig herunterfährt, bevor der Akku leer ist. Hier richten wir dafür Network UPS Tools (NUT) unter Debian 13 und Raspberry Pi OS Trixie ein, binden einen zweiten Rechner an und testen das Ganze, ohne den Stecker ziehen zu müssen.
Welche USV passt zum Homeserver?
Für einen Homeserver brauchst Du keine teure Rechenzentrums-USV, aber drei Dinge sollten stimmen: die Bauart, die Leistung und der Datenanschluss.
Bauart: Günstige Offline-Geräte schalten erst bei einem Ausfall auf Akku um. Eine Line-Interactive-USV gleicht zusätzlich Spannungsschwankungen aus, ohne auf den Akku zu gehen, und ist für Homeserver der übliche Kompromiss. Online-USVs mit Doppelwandlung liefern immer sauberen Strom aus dem Wechselrichter, sind aber lauter, teurer und ziehen selbst mehr Strom. Achte bei PCs mit modernen Netzteilen darauf, dass die USV im Akkubetrieb einen reinen Sinus ausgibt, weil manche Netzteile mit aktiver PFC mit einem stufenförmigen Sinus nicht sauber zurechtkommen.
Leistung: USVs werden mit zwei Werten angegeben, VA und Watt. Entscheidend ist die Watt-Angabe, und sie sollte deutlich über dem liegen, was Deine Geräte zusammen ziehen. Miss den Verbrauch von Server, Router und Switch am besten mit einer Messsteckdose, wie es die Anleitung Stromfresser finden: Standby messen mit Messsteckdose beschreibt. Ein Raspberry Pi mit einer SSD, ein kleines NAS und eine FRITZ!Box kommen oft zusammen auf 30 bis 60 Watt. Wie lange die USV das durchhält, steht in der Laufzeittabelle des Datenblatts, nicht in der VA-Zahl.
Datenanschluss: Damit NUT den Zustand der USV auslesen kann, braucht sie einen USB-Anschluss, der als HID-Gerät arbeitet. Das ist bei den gängigen Serien von APC, Eaton und CyberPower der Fall. Ob Dein Modell unterstützt wird, zeigt die Hardware-Kompatibilitätsliste von NUT. Eine passende Line-Interactive-USV mit USB-Anschluss (Affiliate Link) findest Du in jeder Größe.
Häng neben dem Server auch Router und Switch an die USV. Sonst bekommen weitere Rechner im Netz vom Stromausfall nichts mit, weil die Verbindung zum Server als Erstes wegbricht.
So arbeitet NUT
NUT besteht aus drei Teilen, die zusammen auf dem Rechner laufen, an dem das USB-Kabel der USV steckt:
- Der Treiber (bei USB-Geräten fast immer
usbhid-ups) spricht mit der USV und liest Akkustand, Laufzeit und Status. - Der Datenserver upsd stellt diese Werte im Netz auf Port
3493bereit. - Der Wächter upsmon beobachtet den Status und fährt den Rechner herunter, wenn die USV auf Akku läuft und einen niedrigen Ladestand meldet.
Der Rechner mit dem USB-Kabel ist der Primary. Er fährt als Letzter herunter, nachdem er den anderen Bescheid gegeben hat. Alle weiteren Rechner sind Secondaries, sie lesen den Status nur über das Netz. In älteren Anleitungen heißen die Rollen noch master und slave, seit NUT 2.8.0 sind primary und secondary die gültigen Begriffe. Debian 13 und Raspberry Pi OS Trixie bringen NUT 2.8.1 mit.
Schritt 1: NUT installieren und die USV finden
Schließ die USV per USB an den Server an. Dann aktualisieren wir die Paketlisten und installieren NUT:
sudo apt update
sudo apt install nutDas Paket nut installiert Server und Client zusammen. Prüf anschließend, ob die USV erkannt wird:
sudo nut-scanner -UDer Befehl sucht nach USV-Geräten am USB-Bus und gibt einen fertigen Konfigurationsblock aus, in dem unter anderem driver = "usbhid-ups" und die Hersteller- und Produkt-ID stehen. Erscheint nichts, steckt die USV an einem anderen Kabel als dem mitgelieferten Datenkabel oder hat gar keine USB-Datenschnittstelle.
Schritt 2: Die Konfiguration unter /etc/nut
Alle Dateien liegen in /etc/nut/. Wir gehen sie der Reihe nach durch und öffnen jede mit sudo nano. Gespeichert wird jeweils mit Strg + O und Enter, geschlossen mit Strg + X.
nut.conf: die Betriebsart
sudo nano /etc/nut/nut.confSetz dort die Zeile:
MODE=netservernetserver heißt: Dieser Rechner steuert die USV und stellt die Werte auch anderen Rechnern im Netz bereit. Willst Du nur diesen einen Rechner schützen, reicht MODE=standalone.
ups.conf: die USV beschreiben
sudo nano /etc/nut/ups.confHäng am Ende diesen Block an:
[usv]
driver = usbhid-ups
port = auto
desc = "USV Homeserver"usv in der eckigen Klammer ist der Name, unter dem Du das Gerät später ansprichst. port = auto sucht die USV am USB-Bus selbst. Hängen mehrere USVs am selben Rechner, übernimmst Du zusätzlich die Zeilen vendorid und productid aus der Ausgabe von nut-scanner.
upsd.conf: wo der Datenserver lauscht
sudo nano /etc/nut/upsd.confOhne Eintrag lauscht upsd nur lokal. Damit andere Rechner zugreifen können, ergänzt Du die LAN-Adresse des Servers:
LISTEN 127.0.0.1 3493
LISTEN 192.168.178.20 3493Ersetze 192.168.178.20 durch die IP-Adresse Deines Servers. Sie sollte sich nicht ändern, wie Du das einrichtest, zeigt Raspberry Pi feste IP-Adresse geben: Router oder nmcli.
upsd.users: Zugänge für die Wächter
sudo nano /etc/nut/upsd.usersLeg zwei Benutzer an, einen für den Wächter auf dem Server selbst und einen für die Rechner im Netz:
[monitor]
password = EIN_LANGES_PASSWORT
upsmon primary
[nutclient]
password = ZWEITES_PASSWORT
upsmon secondaryErsetze beide Platzhalter durch eigene, lange Passwörter. Die Zeile upsmon primary erlaubt dem Benutzer, das Herunterfahren aller Rechner auszulösen. Mit upsmon secondary darf ein Rechner nur zuhören und selbst herunterfahren.
upsmon.conf: wann heruntergefahren wird
sudo nano /etc/nut/upsmon.confSuch die Beispielzeilen mit MONITOR und ergänze darunter:
MONITOR usv@localhost 1 monitor EIN_LANGES_PASSWORT primaryDie Zeile bedeutet: Überwache die USV usv auf diesem Rechner, sie versorgt ein Netzteil (1), melde Dich als monitor an und arbeite als Primary. Prüf in derselben Datei, dass SHUTDOWNCMD "/sbin/shutdown -h +0" aktiv ist, also ohne # davor. Das ist der Befehl, den upsmon im Ernstfall ausführt.
Weil zwei Dateien Passwörter enthalten, setzen wir die Rechte so, dass nur root und die Gruppe nut sie lesen können:
sudo chown root:nut /etc/nut/upsd.users /etc/nut/upsmon.conf
sudo chmod 640 /etc/nut/upsd.users /etc/nut/upsmon.confSchritt 3: Dienste starten und Werte prüfen
NUT läuft unter systemd als mehrere Dienste, wie sie die Anleitung Eigenen systemd-Dienst anlegen: Skripte dauerhaft starten erklärt. Nach den Änderungen starten wir sie neu, zuerst den Teil, der aus ups.conf die Treiberdienste erzeugt:
sudo systemctl restart nut-driver-enumerator.service
sudo systemctl restart nut-server.service
sudo systemctl restart nut-monitor.serviceDanach liest Du die USV aus:
upsc usv@localhostDie Ausgabe ist eine lange Liste. Wichtig sind diese Werte:
battery.charge: 100
battery.runtime: 1740
ups.load: 18
ups.status: OLups.status: OL heißt „online“, die USV hängt am Netz. Auf Akku steht dort OB, bei niedrigem Ladestand zusätzlich LB. battery.runtime ist die geschätzte Restlaufzeit in Sekunden. Kommt statt der Werte eine Fehlermeldung wie Driver not connected, siehst Du mit systemctl status [email protected] und journalctl -u [email protected], woran der Treiber scheitert. Wie Du solche Logs gezielt filterst, erklärt journalctl: Fehler unter Linux in den Logs finden.
Standardmäßig fährt upsmon herunter, wenn die USV selbst „Akku schwach“ meldet. Manche Geräte melden das sehr spät. Dann kannst Du im Block [usv] in ups.conf mit ignorelb und override.battery.charge.low = 40 eine eigene Schwelle in Prozent setzen. Das funktioniert nur, wenn Deine USV den Ladestand zuverlässig meldet.
Schritt 4: Weitere Rechner als Secondary anbinden
Ein zweiter Linux-Rechner, etwa ein NAS oder ein weiterer Pi, braucht nur den Client:
sudo apt install nut-clientSetz in /etc/nut/nut.conf die Zeile MODE=netclient und ergänze in /etc/nut/upsmon.conf:
MONITOR [email protected] 1 nutclient ZWEITES_PASSWORT secondaryStarte den Wächter neu und prüf mit upsc [email protected], ob die Werte ankommen:
sudo systemctl restart nut-monitor.serviceLäuft auf dem Server eine Firewall wie ufw, gibst Du Port 3493 nur für Dein Heimnetz frei:
sudo ufw allow from 192.168.178.0/24 to any port 3493 proto tcpWie ufw sonst eingerichtet wird, steht in Linux-Server absichern: SSH-Schlüssel, ufw, fail2ban.
Im Ernstfall sagt der Primary allen angemeldeten Secondaries Bescheid und wartet bis zu 15 Sekunden (HOSTSYNC), bis sie sich abgemeldet haben, bevor er selbst herunterfährt. Auch Systeme, die kein Debian sind, können Secondary werden. OpenMediaVault, TrueNAS und Unraid bringen NUT-Clients mit, und bei einer Synology trägst Du in der Systemsteuerung unter Hardware & Energie > USV die IP Deines Servers als Netzwerk-USV ein. DSM erwartet dabei feste Werte für USV-Name und Benutzer, die Du in der Synology-Hilfe zu Deiner DSM-Version nachschlägst und in ups.conf und upsd.users übernimmst. Welche NAS-Software zu Dir passt, vergleicht NAS selber bauen: OpenMediaVault, TrueNAS oder Unraid?.
Schritt 5: Das Herunterfahren testen, ohne den Stecker zu ziehen
Ein echter Test mit gezogenem Stecker schaltet am Ende auch die USV-Ausgänge ab. Sicherer ist es, erst den Ablauf zu prüfen, ohne dass etwas ausgeht. Dafür ersetzt Du in /etc/nut/upsmon.conf vorübergehend den Befehl zum Herunterfahren durch einen Eintrag ins Systemlog:
SHUTDOWNCMD "/usr/bin/logger -t nut-test Jetzt-wuerde-heruntergefahren"Starte nut-monitor neu und löse dann den Notfall von Hand aus:
sudo systemctl restart nut-monitor.service
sudo upsmon -c fsd-c fsd setzt das Flag „Forced Shutdown“, und alle angebundenen Rechner verhalten sich so, als wäre der Akku leer. Vorsicht: Auf den Secondaries steht noch der echte Befehl, sie fahren also wirklich herunter. Ändere dort vorher ebenfalls SHUTDOWNCMD oder teste erst nur mit dem Server allein. Ob der Testbefehl ausgeführt wurde, zeigt:
journalctl -t nut-testDanach räumst Du auf: Setz SHUTDOWNCMD wieder auf "/sbin/shutdown -h +0", lösch die Datei, die upsmon beim Notfall anlegt, und starte die Dienste neu, damit das FSD-Flag verschwindet:
sudo rm -f /etc/killpower
sudo systemctl restart nut-server.service
sudo systemctl restart nut-monitor.serviceDen Pfad /etc/killpower findest Du in upsmon.conf unter POWERDOWNFLAG. Steht dort ein anderer Pfad, löschst Du diesen.
Benachrichtigung und Home Assistant
Bei jedem Wechsel auf Akku schreibt upsmon eine Meldung ins Systemlog und an alle angemeldeten Terminals. Willst Du zusätzlich eine Nachricht aufs Handy, ist Home Assistant der einfachste Weg: Die offizielle NUT-Integration verbindet sich mit der IP des Servers und Port 3493 und liefert Akkustand, Last und Status als Sensoren. Für die reinen Messwerte braucht sie keine Zugangsdaten. Aus dem Sensor Status baust Du dann eine Automation, die meldet, sobald die USV auf Akku läuft, so wie in der Anleitung Home Assistant: Benachrichtigung aufs Handy mit Aktionen.
Der Akku hält nicht ewig
Die Bleiakkus in Heim-USVs halten je nach Temperatur meist drei bis fünf Jahre. Behalte battery.charge und battery.runtime im Auge: Sinkt die Restlaufzeit bei gleicher Last deutlich, ist der Akku am Ende. Viele Geräte melden das auch selbst, dann steht in ups.status zusätzlich RB (replace battery). Der passende Ersatzakku für die USV (Affiliate Link) kostet meist nur einen Bruchteil einer neuen USV. Vergleich vor dem Kauf Spannung, Kapazität und Anschlüsse mit dem alten Akku.
Fazit
Mit einer Line-Interactive-USV per USB und NUT übersteht Dein Homeserver einen Stromausfall ohne Schaden: Er läuft die ersten Minuten weiter, sagt den anderen Rechnern im Netz Bescheid und fährt rechtzeitig herunter. Die Konfiguration besteht aus fünf kleinen Dateien, und der Test mit upsmon -c fsd zeigt Dir, dass alles funktioniert, ohne dass Du den Stecker ziehen musst. Gerade beim Raspberry Pi schützt das die Speicherkarte, mehr dazu in Raspberry Pi im Dauerbetrieb: SD-Karte schonen, stabil laufen.
Die Konfigurationsschlüssel und Befehle sind gegen die offiziellen Handbuchseiten von NUT (unter anderem upsmon.conf und upsd.users) und gegen die NUT-Version 2.8.1 aus Debian 13 geprüft. Ein Durchlauf mit echter USV ist in dieser Anleitung nicht dokumentiert.
Weiterlesen.
-
Raspberry Pi & LinuxRaspberry Pi im Dauerbetrieb: SD-Karte schonen, stabil laufen
Läuft der Raspberry Pi rund um die Uhr, sterben SD-Karten und Netzteile zuerst. Diese Einstellungen unter Raspberry Pi OS Trixie machen den Pi langlebig.
Nathan Base -
Raspberry Pi & LinuxNAS selber bauen: OpenMediaVault, TrueNAS oder Unraid?
Eigenes NAS statt Synology: OpenMediaVault, TrueNAS und Unraid im Vergleich, mit N100-Hardware, realistischem Stromverbrauch und klarer Empfehlung.
Nathan Base -
Digitaler AlltagStromfresser finden: Standby messen mit Messsteckdose
Grundlast zu hoch? So liest Du sie am Stromzähler ab, findest Standby-Stromfresser mit der Messsteckdose und rechnest Watt in Euro pro Jahr um.
Nathan Base -
Selfhosting & WebDocker-Container startet nicht: Logs und Exit-Codes
Docker-Container hängt in „Restarting“ oder beendet sich sofort? So findest Du mit Logs, Exit-Code und Healthcheck die Ursache und behebst sie.
Nathan Base -
Selfhosting & WebDocker belegt zu viel Speicher: sicher aufräumen
Docker füllt die Platte? So findest Du mit docker system df die Ursache, räumst Images und Build-Cache sicher auf und begrenzt wachsende Container-Logs.
Nathan Base -
Selfhosting & WebAnleitung: linkding mit Docker selbst hosten
linkding ist ein schlanker Bookmark-Manager zum Selbsthosten. So richtest Du ihn mit Docker Compose ein und verbindest die Browser-Erweiterung.
Nathan Base