Was ist Uptime Kuma? Einrichtung und Überwachung per Proxy

Ein kleiner Onlineshop in Konya betreibt Uptime Kuma auf einem VPS (einem gemieteten virtuellen Server) im selben Rechenzentrum wie seinen Webserver, und das Dashboard ist seit drei Tagen grün. Am Montag sagt das Support-Postfach etwas anderes: Kunden mit mobilen Daten können die Checkout-Seite nicht laden, und ein Händler in Deutschland erreicht die Website überhaupt nicht. Der Fehler liegt irgendwo auf dem Weg zur Website, etwa ein Routing-Problem in einem einzelnen Netz oder eine zu weit gefasste Geoblocking-Regel. Die Überwachung stand direkt neben der Website und hat davon nichts gesehen.

Dieser Leitfaden zeigt, was 99,9 % Uptime in Stunden bedeutet, was Uptime Kuma macht, welchen Monitortyp Sie wählen und wie Sie das Tool mit Docker installieren. Danach geht es darum, warum die Prüfung von nur einem Ort einen toten Winkel lässt, wie Sie die Prüfungen eines Monitors über einen HTTP- oder SOCKS5-Proxy schicken und wie viel Datenverkehr das verbraucht.

Was ist Uptime, und was bedeutet 99,9 % Uptime?#

Uptime ist der Anteil der Zeit, in der ein Dienst während eines Messzeitraums erreichbar war; Downtime ist der Rest. Gemeint ist nicht der Linux-Befehl uptime, der zeigt, wie lange ein einzelner Computer schon eingeschaltet ist. Ein Jahr mit 365 Tagen hat 8.760 Stunden, und 99,9 % lassen 0,1 % davon, also 8,76 Stunden, für Ausfälle. Online-Rechner, die 8 Stunden 45 Minuten 57 Sekunden anzeigen, rechnen das Jahr mit 365,25 Tagen.

Eine Uptime-Garantie ist dieses Ziel, festgeschrieben in einem Service Level Agreement (SLA). Das SRE-Buch von Google beschreibt zwei Arten, sie zu messen: den Anteil der Zeit, in der ein System lief, und den Anteil der Anfragen, die erfolgreich waren (Embracing Risk).

Was ist Uptime Kuma, und wofür braucht man es?#

Uptime Kuma ist ein Monitoring-Tool von Louis Lam, veröffentlicht unter der MIT-Lizenz. Sie installieren es auf Ihrem eigenen Server, öffnen es im Browser und legen Monitore an; jeder Monitor ist eine Adresse oder ein Dienst, der geprüft wird. Das Projekt-Repository hatte im September 2026 mehr als 90.000 Sterne, die aktuelle Version war 2.5.5.

Anders als bei einem gehosteten Dienst bleiben der Prüfverlauf und die Zugangsschlüssel Ihrer Benachrichtigungsdienste auf Ihrem Server, und die Zahl der Monitore ist nicht begrenzt. Im Gegenzug halten Sie diesen Server selbst am Laufen, und er prüft von dort aus, wo er steht. Außerdem bietet Uptime Kuma öffentliche Statusseiten, Wartungsfenster unter Wartung, in denen die Alarme pausieren, und eine Oberfläche in mehr als 40 Sprachen.

Wie prüft Uptime Kuma eine Website?#

Jeder Monitor wiederholt denselben Zyklus:

1. Das Intervall läuft ab. Das Heartbeat-Intervall beträgt standardmäßig 60 Sekunden. Die Anfrage trägt den User-Agent Uptime-Kuma/2.5.5, sodass Sie sie in Ihren Server-Logs wiederfinden.
2. Er wartet. Kommt innerhalb des Anfrage-Timeouts, standardmäßig 48 Sekunden, keine Antwort, gilt die Prüfung als gescheitert.
3. Er liest die Antwort. Der Statuscode muss im Bereich Akzeptierte Statuscodes liegen, standardmäßig 200-299 (HTTP-Statuscodes). Ein Schlüsselwort-Monitor sucht außerdem Ihr Wort auf der Seite und achtet dabei auf Groß- und Kleinschreibung.
4. Er wiederholt. Steht Wiederholungen über 0, wird eine gescheiterte Prüfung im Heartbeat-Wiederholungsintervall wiederholt. Neue Monitore starten mit 0, also löst schon ein einziges verlorenes Paket einen Alarm aus.
5. Er alarmiert. Sind die Wiederholungen aufgebraucht, wechselt der Monitor auf DOWN (in der deutschen Oberfläche „Offline“), und die Kanäle, die Sie unter Einstellungen > Benachrichtigungen angelegt haben, erhalten eine Nachricht; besteht eine Prüfung wieder, wechselt er auf UP („Online“).
6. Er zeichnet auf. Die Seite des Monitors zeigt die Verfügbarkeit für 24 Stunden, 30 Tage und 1 Jahr.

Die Benachrichtigung bei Zertifikatsablauf ist bei neuen Monitoren ausgeschaltet. Schalten Sie sie für HTTPS-Websites ein: Let's Encrypt bietet seit Mai 2026 auf Wunsch Zertifikate mit 45 Tagen Laufzeit an und plant ab Februar 2027 standardmäßig Zertifikate mit 64 Tagen (Let's Encrypt), Verlängerungen stehen also häufiger an.

Welchen Monitortyp sollten Sie wählen?#

Uptime Kuma 2.5.5 hat rund dreißig Monitortypen. Die meisten Websites brauchen diese:

HTTP(s) allein beweist nur, dass der Server geantwortet hat. Auch eine Wartungsseite oder ein kaputtes Template kann 200 zurückgeben und als UP zählen. Ein Schlüsselwort-Monitor, der nach der Beschriftung des Bezahlknopfs sucht, erkennt beides, und Schlüsselwort invertieren meldet sich, wenn ein Wort wie „Wartung“ auftaucht. Eine Health-Check-Seite ist eine kurze Adresse, die Ihr Entwickler anlegt und die „ok“ antwortet, wenn Anwendung und Datenbank reagieren.

Für Fortgeschrittene: Wie installieren Sie Uptime Kuma mit Docker?#

Sie brauchen einen Linux-VPS oder einen Heimserver mit Docker, getrennt von dem Rechner, auf dem die Website läuft. Der Befehl aus der README des Projekts:

docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:2

• -d startet den Container im Hintergrund, und --restart=always startet ihn nach einem Absturz oder Neustart wieder.
• -p 3001:3001 gibt den Standardport 3001 frei.
• -v uptime-kuma:/app/data legt die Datenbank in ein Docker-Volume, das erhalten bleibt, wenn der Container entfernt wird (Docker-Volumes). Laut README werden Netzwerkordner (NFS) nicht unterstützt.
• louislam/uptime-kuma:2 folgt der Reihe 2.x; am 25. September 2026 zeigte der Tag auf 2.5.5.

Mit Docker Compose laden Sie die offizielle compose.yaml in einen leeren Ordner und führen docker compose up -d aus; die Daten liegen dann im lokalen Ordner ./data. Öffnen Sie anschließend http://ihre-server-ip:3001, wählen Sie die Sprache und eine Datenbank (SQLite genügt für eine kleine Installation), legen Sie das Administratorkonto an und klicken Sie auf Neuen Monitor hinzufügen. Die Menünamen in diesem Leitfaden stammen aus der deutschen Oberfläche. Für ein Update ziehen Sie das neue Image, entfernen den Container und führen den Befehl erneut aus; das Volume behält Ihre Monitore.

Das Dashboard unter Ihrer eigenen Domain mit HTTPS zu öffnen, ist Aufgabe eines Reverse Proxys wie nginx oder Caddy, der die Header Upgrade und Connection für WebSocket weitergeben muss; das Wiki des Projekts enthält Beispiele. Die beiden Richtungen eines Proxys vergleicht Forward-Proxy und Reverse-Proxy.

Was übersieht eine Überwachung von nur einem Ort?#

Ein Monitor im Rechenzentrum der Website beweist, dass der Server funktioniert, nicht aber, dass Kunden ihn erreichen. Er übersieht:

• Ein Routing-Problem in einem Netz: Die Kunden eines Anbieters erreichen die Website nicht.
• DNS, das je nach Region abweicht: Ein falscher Eintrag auf einem DNS-Server trifft nur dessen Nutzer.
• Eine zu weit gefasste Geoblocking-Regel: Eine Regel, die für ein Land gedacht ist, sperrt auch ein anderes.
• Einen CDN-Server, der Fehler liefert: Ein CDN liefert die Website von vielen Servern aus, und nur Besucher, die beim defekten Server landen, sehen Fehler.
• Geteilte Mobilfunk-IPs, die an ein Rate Limit stoßen: Netzbetreiber setzen viele Nutzer hinter eine einzige Adresse (Was ist CGNAT?).

Es gibt drei Wege, den Blick zu erweitern. Der erste ist ein zweites Uptime Kuma in einem anderen Land. Der zweite ist der Monitortyp Globalping, eingeführt in Version 2.1.0, der von Messpunkten aus prüft, die von der Community betrieben werden; sein Standortfeld akzeptiert ein Land, eine Stadt oder den Namen eines Anbieters (Globalping). Globalping erlaubt ohne Konto 250 Tests pro Stunde und wählt aus den Messpunkten, die gerade online sind; für ein bestimmtes Netz gibt es also womöglich keinen Messpunkt, wenn Sie einen brauchen.

Der dritte Weg ist ein Proxy am Monitor: Die Prüfung verlässt das Netz über einen Ausgang in dem Land, das Sie wählen. Das ist die Idee hinter einem Lokalisierungstest.

Wie richten Sie einen Proxy an einem Uptime-Kuma-Monitor ein?#

Hier geht es um die ausgehenden Prüfungen des Monitors; das Dashboard hinter nginx ist der Reverse-Proxy-Fall von oben. Proxy-Einstellungen gibt es nur bei den Monitoren HTTP(s), HTTP(s) - Schlüsselwort und HTTP(s) - JSON-Abfrage.

1. Öffnen Sie Einstellungen > Proxys und klicken Sie auf Proxy einrichten.
2. Wählen Sie unter Proxy-Protokoll den Eintrag HTTP oder SOCKS v5 (+DNS). Die Liste enthält außerdem HTTPS, SOCKS, SOCKS v5 und SOCKS v4.
3. Tragen Sie unter Proxy-Server pr.proxynet.io ein und als Port 8000 für HTTP oder den SOCKS5-Port, den der Endpoint-Generator anzeigt.
4. Setzen Sie das Häkchen bei Proxy-Server erfordert Authentifizierung und füllen Sie Benutzer und Passwort aus (hier user:pass). Kopieren Sie den Benutzernamen aus dem Endpoint-Generator des Proxynet-Panels; er enthält Land, Stadt und Sitzung (Proxy-Authentifizierung).
5. Als Standard festlegen gibt den Proxy an neue Monitore weiter, Auf alle bestehenden Monitore anwenden an die vorhandenen.
6. Speichern Sie und wählen Sie dann bei jedem Monitor unter Proxy entweder Kein Proxy oder den gewünschten Proxy.

Für ein zweites Land klicken Sie neben dem Proxy auf Klonen und ändern das Land im Benutzernamen. „Checkout (Türkiye)“ und „Checkout (Deutschland)“ können dann dieselbe Adresse beobachten.

Das Protokoll entscheidet, wo der Name der Website aufgelöst wird. Bei SOCKS v5 löst der Uptime-Kuma-Server die Domain auf; bei SOCKS v5 (+DNS) und HTTP übernimmt das der Proxy am Ausgang, sodass auch DNS aus dem Zielland getestet wird (SOCKS und HTTP Proxy im Vergleich). Um die Route zu bestätigen, richten Sie einen Schlüsselwort-Monitor mit Proxy auf eine Seite, die Ihr Land anzeigt (Funktioniert mein Proxy?).

Der Mobile-Proxy greift in Türkiye auf Leitungen von Turkcell, Türk Telekom und Vodafone zurück. Sie wählen Land und Stadt, nicht den Netzbetreiber; jede Prüfung zeigt, wie sich die Website in einem Mobilfunknetz verhält.

Kann der Server Telegram oder einen anderen Benachrichtigungsdienst nicht erreichen, schickt die Umgebungsvariable NOTIFICATION_PROXY (seit 2.0.0) die meisten Benachrichtigungen über einen Proxy, E-Mails allerdings nicht (Proxy-Umgebungsvariablen).

Wie viel Datenverkehr verbraucht die Überwachung über einen Proxy?#

Residential- und Mobile-Proxys werden pro GB abgerechnet. Bei einem Intervall von 60 Sekunden macht ein Monitor in 30 Tagen 43.200 Prüfungen. Uptime Kuma lädt nur das HTML der Seite, keine Bilder oder Skripte, öffnet aber für jede Prüfung eine neue Verbindung über den Proxy. Jede Prüfung wiederholt also den TLS-Handshake, den Austausch, mit dem die HTTPS-Verschlüsselung aufgebaut wird.

Wir haben das am 25. September 2026 gemessen: Die Anfrage von Uptime Kuma (mit ihren Headern, ohne Komprimierung) lief über einen lokalen HTTP-Proxy, und wir haben die Bytes in beide Richtungen gezählt:

Für Ihren eigenen Wert nehmen Sie die unkomprimierte HTML-Größe der Seite aus den Entwicklertools des Browsers, rechnen 6 bis 8 KB für die Verbindung hinzu und multiplizieren das mit den Prüfungen pro Monat und der Zahl der Monitore. So senken Sie den Verbrauch:

• Beobachten Sie eine Health-Check-Seite statt der Startseite.
• Nutzen Sie HEAD unter HTTP-Optionen > Methode; die Methode lässt den Seiteninhalt weg, Schlüsselwort-Monitore können sie deshalb nicht verwenden.
• Fordern Sie Komprimierung an, indem Sie {"Accept-Encoding": "gzip"} in das Feld Header eintragen; Schlüsselwortprüfungen funktionieren weiterhin.
• Verlängern Sie das Intervall: ein Monitor ohne Proxy alle 60 Sekunden, Proxy-Monitore alle 2 bis 5 Minuten.

Ein Residential-Proxy gibt Ihnen einen Ausgang über einen privaten Internetanschluss im Land Ihrer Wahl. Ein rotierender Ausgang gibt jeder Prüfung eine neue IP-Adresse, wodurch die Antwortzeiten schwanken; ein Sticky-Proxy hält eine IP für 1 bis 60 Minuten.

Anwendungsfälle#

• Der Checkout aus Sicht mobiler Daten in Türkiye: ein Schlüsselwort-Monitor über einen Mobile-Proxy.
• Ein Händlerportal für Partner im Ausland: ein Monitor pro Händlerland (Lokalisierungstests).
• Die API Ihrer mobilen App: ein JSON-Abfrage-Monitor, der aus einem Mobilfunknetz prüft (App-Tests).
• Eine Partner-API, die nur freigegebene IPs annimmt: Uptime Kuma auf einem Server mit fester IP (Statische oder dynamische IP).
• Änderungen am Inhalt einer Seite: eine andere Aufgabe, siehe Website auf Änderungen überwachen.
• Eine einmalige Prüfung, ob die Website ausgefallen ist: siehe Die Website ist nicht erreichbar.

Häufige Fehler#

• Den Monitor auf dem Server installieren, den er überwacht. Fällt der Server aus, fällt das Tool, das den Alarm senden soll, mit ihm aus.
• Wiederholungen auf 0 lassen. Ein verlorenes Paket um 3 Uhr nachts weckt jemanden; stellen Sie 1 oder 2 ein.
• Die eigene Firewall den Monitor blockieren lassen. Antwortet die Website plötzlich mit 403, geben Sie die IP des Monitors frei (Access-Denied-Fehler). Überwachen Sie nur Websites, die Ihnen gehören oder die Sie prüfen dürfen.
• Einfaches SOCKS v5 für einen Standorttest. DNS wird dann weiterhin auf Ihrem Server aufgelöst.
• „TLS/SSL-Fehler für HTTPS-Websites ignorieren“ einschalten. Damit schalten Sie auch den Alarm bei Zertifikatsablauf ab.
• Den Container ohne Volume betreiben. Ein Update löscht dann alle Monitore.

Entscheidungshilfe#

Häufige Fragen#

Ist Uptime Kuma kostenlos?#

Ja, es ist Open-Source-Software unter der MIT-Lizenz. Kosten entstehen nur für den Server, auf dem es läuft, und für eventuellen Proxy-Datenverkehr.

Welchen Port nutzt Uptime Kuma?#

Standardmäßig Port 3001. In -p 8080:3001 ist die erste Zahl der Port auf Ihrem Server und die zweite der Port im Container (Was ist Port 8080?).

Was ist der Unterschied zwischen Uptime Kuma und UptimeRobot?#

UptimeRobot ist ein gehosteter Dienst, bei dem Sie nichts installieren; im September 2026 umfasste sein kostenloser Plan 50 Monitore mit einem Intervall von 5 Minuten. Uptime Kuma läuft ohne Begrenzung der Monitore auf Ihrem eigenen Server, und diesen Server warten Sie selbst.

Wie viel Ausfallzeit erlauben 99,9 % Uptime in einem Monat?#

43 Minuten 12 Sekunden in einem 30-Tage-Monat und rund 43 Minuten 50 Sekunden in einem durchschnittlichen Kalendermonat.

Was ist eine Uptime-Garantie in einem SLA?#

Das ist das Verfügbarkeitsziel im Vertrag eines Anbieters. Prüfen Sie den Messzeitraum, die Ausnahmen (etwa geplante Wartung) und den Ausgleich, häufig eine Gutschrift auf die Servicegebühr.

Kann Uptime Kuma von mehreren Standorten aus überwachen?#

Ja, auch wenn Version 2.5.5 keine Remote-Agenten hat: Ein normaler Monitor prüft von seinem eigenen Server aus. Für weitere Standorte betreiben Sie Kopien an anderen Orten, nutzen den Monitortyp Globalping oder geben jedem HTTP-Monitor einen Proxy in einem anderen Land.

Fazit#

Ein Uptime-Wert ist nur so genau wie der Ort, an dem er gemessen wird. Uptime Kuma installieren Sie mit einem Docker-Befehl; geben Sie dem Checkout einen Schlüsselwort-Monitor, stellen Sie die Wiederholungen auf 1 oder 2 und schalten Sie den Zertifikatsalarm ein. Um zu sehen, was Ihre Kunden sehen, lassen Sie denselben Monitor über einen Ausgang in deren Land laufen, nachdem Sie den Datenverkehr berechnet haben. Auf unserer Seite zu den Proxy-Diensten finden Sie die verfügbaren Ausgangsarten.