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.
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ė |
|---|---|---|
| SSH | 5 nesėkmingi prisijungimai | 10 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 |
|---|---|
| Ubuntu | 24.04 LTS |
| Uptime Kuma | 2.x |
| Node.js | 22.x LTS |
| PM2 | 6.x |
| Nginx | 1.24 |
| Fail2Ban | 1.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 |