Table of Contents

Uptime Kuma - pradžios vadovas

Uptime Kuma yra savarankiškai talpinamas stebėjimo įrankis, leidžiantis sekti svetainių, API, DNS ir kitų paslaugų pasiekiamumą su aiškiu skydeliu ir momentiniais pranešimais. Šiame serveryje iš anksto įdiegti Uptime Kuma, Nginx ir PM2 – tiesiog atidarykite žiniatinklio sąsają ir susikurkite administratoriaus paskyrą.


1 žingsnis – Patikrinkite, ar Uptime Kuma veikia

Jūsų serverio IP adresas ir root slaptažodis nurodyti kliento skydelio puslapyje Server Details. Atidarykite naršyklę ir eikite į:

http://your.server.ip

Pirmą kartą atidarius, Uptime Kuma parodys registracijos formą. Pasirinkite naudotojo vardą ir slaptažodį, tada spustelėkite Create.

Svarbu: Administratoriaus paskyrą sukuria pirmasis žiniatinklio sąsają atidaręs žmogus. Atlikite šį žingsnį iškart paruošus serverį.

Jei serverį patalpinote už VyOS maršrutizatoriaus privačiame tinkle, arba sukonfigūruokite prievadų peradresavimą (80 ir 443), kad Uptime Kuma pasiektumėte iš interneto, arba prisijunkite per VPN ir pasiekite jį privačiu serverio IP.


2 žingsnis – Pirmojo monitoriaus pridėjimas

Prisijungę skydelyje spustelėkite Add New Monitor :

  • Monitor Type – HTTP(s), TCP, Ping, DNS ir kt.
  • Friendly Name – aprašomasis monitoriaus pavadinimas
  • URL / Hostname – stebimas taikinys
  • Heartbeat Interval – kaip dažnai tikrinti (numatytasis: 60 sekundžių)

Spustelėkite Išsaugoti ir stebėjimas prasideda iš karto. Pranešimus (el. paštas, Telegram, Slack, Discord ir daug kitų) pridėsite skiltyje Settings > Notifications.


3 žingsnis – Domeno ir SSL konfigūravimas (neprivaloma)

Norėdami pasiekti Uptime Kuma per domeną su HTTPS, sukurkite DNS A įrašą, nukreipiantį domeną į serverio IP. Tada prisijunkite per SSH ir paleiskite:

ssh root@your.server.ip
sed -i 's/server_name _;/server_name your-domain.com;/' /etc/nginx/sites-available/uptime-kuma
nginx -t && systemctl reload nginx
apt install -y certbot python3-certbot-nginx
certbot --nginx -d your-domain.com

Certbot sukonfigūruos SSL ir automatinį atnaujinimą. Skydelis bus pasiekiamas adresu https://your-domain.com.


Po įdiegimo

Fail2Ban – apsauga nuo slaptažodžių spėjimo atakų

Jūsų serveryje įdiegta Fail2Ban iš anksto sukonfigūruotas apsaugoti SSH nuo slaptažodžių spėjimo atakų.

Taisyklė Maks. bandymų Blokavimo trukmė
SSH5 nesėkmingi prisijungimai10 minučių

Naudingos komandos:

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Jei netyčia užsiblokavote, prisijunkite per VNC konsolę kliento skydelyje ir atblokuokite savo IP.

Paslaugų valdymas

Uptime Kuma veikia per PM2, kuris palaiko jo veikimą ir automatiškai paleidžia iš naujo po gedimų ar perkrovimų.

# Check status
pm2 list

# View logs
pm2 logs uptime-kuma

# Restart
pm2 restart uptime-kuma

# Nginx reverse proxy
systemctl status nginx
systemctl reload nginx

Atsarginės kopijos

Visi duomenys (monitoriai, pranešimai, būsenų istorija) saugomi SQLite. Eksportuoti/importuoti galite žiniatinklio sąsajoje (Settings > Backup) arba daryti atsarginę kopiją per SSH:

cp -r /opt/uptime-kuma/data /root/uptime-kuma-backup-$(date +%F)

Atnaujinimai

# Update Uptime Kuma
cd /opt/uptime-kuma
pm2 stop uptime-kuma
git fetch --all
git checkout $(git describe --tags --abbrev=0 origin/master)
npm install --production
npm run download-dist
pm2 restart uptime-kuma
pm2 save

# Update OS packages
apt update && apt upgrade -y

Įdiegta programinė įranga

Komponentas Versija
Ubuntu24.04 LTS
Uptime Kuma2.x
Node.js22.x LTS
PM26.x
Nginx1.24
Fail2Ban1.0.2

Trikčių šalinimas

Problema Sprendimas
Žiniatinklio sąsaja neįsikelia Patikrinkite būseną: pm2 list. Jei reikia, paleiskite iš naujo: pm2 restart uptime-kuma
502 Bad Gateway Uptime Kuma galbūt neveikia per 3001 prievadą. Patikrinkite žurnalus: pm2 logs uptime-kuma
Pranešimai nesiunčiami Eikite į Settings > Notifications ir mygtuku Test patikrinkite pranešimų kanalą
Didelis atminties naudojimas Padidinkite heartbeat intervalą arba išvalykite seną būsenų istoriją skiltyje Settings > General
Pamiršote administratoriaus slaptažodį Prisijunkite per SSH ir atkurkite: cd /opt/uptime-kuma && npm run reset-password
Užblokavo Fail2Ban Atblokuokite savo IP per VNC konsolę kliento skydelyje
Pamiršote root slaptažodį Atkurkite jį per VNC konsolę kliento skydelyje