Zum Inhalt springen
SONOYA.com
Selfhosting & Web

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

Symbol einer ladenden Batterie für eine USV, die einen Homeserver bei Stromausfall mit Network UPS Tools sauber herunterfährt

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 3493 bereit.
  • 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:

Code
sudo apt update
sudo apt install nut

Das Paket nut installiert Server und Client zusammen. Prüf anschließend, ob die USV erkannt wird:

Code
sudo nut-scanner -U

Der 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

Code
sudo nano /etc/nut/nut.conf

Setz dort die Zeile:

Code
MODE=netserver

netserver 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

Code
sudo nano /etc/nut/ups.conf

Häng am Ende diesen Block an:

Code
[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

Code
sudo nano /etc/nut/upsd.conf

Ohne Eintrag lauscht upsd nur lokal. Damit andere Rechner zugreifen können, ergänzt Du die LAN-Adresse des Servers:

Code
LISTEN 127.0.0.1 3493
LISTEN 192.168.178.20 3493

Ersetze 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

Code
sudo nano /etc/nut/upsd.users

Leg zwei Benutzer an, einen für den Wächter auf dem Server selbst und einen für die Rechner im Netz:

Code
[monitor]
    password = EIN_LANGES_PASSWORT
    upsmon primary

[nutclient]
    password = ZWEITES_PASSWORT
    upsmon secondary

Ersetze 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

Code
sudo nano /etc/nut/upsmon.conf

Such die Beispielzeilen mit MONITOR und ergänze darunter:

Code
MONITOR usv@localhost 1 monitor EIN_LANGES_PASSWORT primary

Die 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:

Code
sudo chown root:nut /etc/nut/upsd.users /etc/nut/upsmon.conf
sudo chmod 640 /etc/nut/upsd.users /etc/nut/upsmon.conf

Schritt 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:

Code
sudo systemctl restart nut-driver-enumerator.service
sudo systemctl restart nut-server.service
sudo systemctl restart nut-monitor.service

Danach liest Du die USV aus:

Code
upsc usv@localhost

Die Ausgabe ist eine lange Liste. Wichtig sind diese Werte:

Code
battery.charge: 100
battery.runtime: 1740
ups.load: 18
ups.status: OL

ups.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:

Code
sudo apt install nut-client

Setz in /etc/nut/nut.conf die Zeile MODE=netclient und ergänze in /etc/nut/upsmon.conf:

Code
MONITOR [email protected] 1 nutclient ZWEITES_PASSWORT secondary

Starte den Wächter neu und prüf mit upsc [email protected], ob die Werte ankommen:

Code
sudo systemctl restart nut-monitor.service

Läuft auf dem Server eine Firewall wie ufw, gibst Du Port 3493 nur für Dein Heimnetz frei:

Code
sudo ufw allow from 192.168.178.0/24 to any port 3493 proto tcp

Wie 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:

Code
SHUTDOWNCMD "/usr/bin/logger -t nut-test Jetzt-wuerde-heruntergefahren"

Starte nut-monitor neu und löse dann den Notfall von Hand aus:

Code
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:

Code
journalctl -t nut-test

Danach 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:

Code
sudo rm -f /etc/killpower
sudo systemctl restart nut-server.service
sudo systemctl restart nut-monitor.service

Den 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.