IceWhale-communitytråden om Uptime Kuma från 2023 är mer en introduktion än en installationsguide. Inlägget säger att handledningen omfattar installation på CasaOS, medan svaren fokuserar på varför användare uppskattar Uptime Kuma: avbrottsaviseringar, produktionsövervakning för icke-kritiska tjänster och push-monitorer. Själva forumtexten innehåller inte längre någon detaljerad steg-för-steg-konfiguration av installationen.
En aktuell sida bör därför behålla CasaOS-kontexten och communityns användningsområden, men använda Uptime Kumas underhållna Docker-krav för själva driftsättningen.
Vad Uptime Kuma tillför en hemmaserver
Uptime Kuma är en egenhostad övervakningspanel. Den kan kontrollera om en webbplats, TCP-tjänst, DNS-ändpunkt, ping-mål, Docker-relaterad tjänst eller push-baserat jobb fungerar och kan skicka aviseringar när statusen ändras.
De ursprungliga svaren lyfte upprepade gånger fram aviseringar som den praktiska nyttan. En panel är användbar, men den främsta fördelen är att få reda på att en tjänst ligger nere innan någon i hushållet rapporterar det.
Använd den aktuella Uptime Kuma-containern
Aktuella installationsanvisningar för Uptime Kuma använder den underhållna avbildningen louislam/uptime-kuma:2. Webbapplikationen lyssnar på port 3001 och lagrar sin beständiga databas och konfiguration under /app/data.
För en aktuell anpassad CasaOS-applikation bör du översätta Uptime Kumas underhållna Docker-installationsinställningar till CasaOS-applikationsformuläret i stället för att använda en gammal avbildningstagg från en video från 2023.
Exponera panelen på port 3001
Webbtjänsten på containern använder TCP-port 3001. Om den värdporten redan används kan du mappa en annan värdport till containerns port 3001 och öppna CasaOS-applikationen via den valda värdporten.
Att ändra värdporten kräver inte att du ändrar Uptime Kumas interna port, såvida inte applikationen uppströms uttryckligen stöder och behöver den ändringen.
Beständiggör /app/data
Mappa en CasaOS-mapp på värden eller en Docker-volym till /app/data. Detta är det viktiga säkerhetskopieringsmålet eftersom mappen innehåller övervakningskonfigurationen, användardata och SQLite-databasen.
Om du återskapar containern utan den beständiga volymen kommer den att fungera som en ny Uptime Kuma-installation.
Förvara databasen på ett filsystem med tillförlitlig låsning
Aktuella riktlinjer för Uptime Kuma varnar för att SQLite-databasen behöver tillförlitlig POSIX-fillåsning och avråder särskilt från filsystem som många NFS-konfigurationer för datakatalogen.
För en hemmaserver är det enklast att förvara /app/data på lokal lagring. Därefter kan du säkerhetskopiera den lokala katalogen till en annan disk eller en fjärransluten målplats.
Välj monitorer som motsvarar användarupplevelsen
En ping-monitor visar bara att en maskin svarar på ICMP. Om det verkliga kravet är ”Jellyfin ska läsa in” är en HTTP-monitor för Jellyfin-ändpunkten mer meningsfull.
En praktisk uppsättning kan innehålla:
- HTTP-kontroller för webbapplikationer;
- TCP-kontroller för tjänster utan en användbar webbändpunkt;
- DNS-kontroller för Pi-hole eller AdGuard Home;
- ping-kontroller för grundläggande nåbarhet till värdar;
- push-monitorer för schemalagda jobb som bör rapportera att de är slutförda.
Varför push-monitorn som nämndes i tråden är viktig
En deltagare i communityn sade specifikt att de använde push-monitorer ofta. I stället för att Uptime Kuma frågar en tjänst efter status anropar ett säkerhetskopieringsskript eller ett schemalagt jobb en unik URL när det lyckas. Om den förväntade pulssignalen inte kommer inom rätt tidsintervall markerar Uptime Kuma monitorn som ej fungerande.
Detta är användbart för uppgifter där ”servern är online” inte bevisar att jobbet faktiskt kördes.
Testa aviseringarna före det första avbrottet
Konfigurera minst en aviseringskanal och utlös avsiktligt en testavisering. Ett övervakningssystem som i tysthet misslyckas med att skicka aviseringar är bara en historisk panel.
För hushållstjänster bör du också tänka på aviseringströtthet. Om du övervakar varje mindre ändpunkt med omedelbara aviseringar kan det bli lättare att ignorera verkliga avbrott.
Håll övervakningspanelen privat om fjärråtkomst inte är avsiktlig
Uptime Kuma kan avslöja interna värdnamn, tjänstenamn, nätverksadresser och avbrottshistorik. Exponera den inte direkt mot det offentliga internet bara för att fjärrövervakning är användbar. Använd ett VPN, ett privat overlay-nätverk eller en autentiserad omvänd proxy om fjärråtkomst krävs.
Betrakta inte CasaOS-tråden från 2023 som en aktuell versionslåsning
Källdiskussionen lovordar en välunderhållen applikation men anger ingen avbildningsversion. Det är fördelaktigt: använd den aktuella versionen från projektets ursprung i stället för att försöka återskapa exakt den container som fanns i september 2023.
Vanliga frågor om Uptime Kuma på CasaOS
Vilken port använder den aktuella versionen av Uptime Kuma?
Port 3001 för webbgränssnittet.
Vilken katalog måste beständiggöras?
/app/data.
Varför bör datakatalogen ligga på lokal lagring?
SQLite-databasen kräver tillförlitlig fillåsning, och aktuella riktlinjer från projektet varnar för olämpliga nätverksfilsystem.
Vad uppskattade communityn mest från början?
Aviseringar och push-monitorfunktionalitet lyftes upprepade gånger fram i svaren.
