Table of Contents

Uptime Kuma - ghid de inițiere

Uptime Kuma este un instrument de monitorizare găzduit de dumneavoastră, care urmărește disponibilitatea site-urilor, API-urilor, DNS și altor servicii, cu un dashboard clar și notificări instantanee. Serverul vine cu Uptime Kuma, Nginx și PM2 preinstalate – doar deschideți interfața web și creați contul de administrator.


Pasul 1 – Verificați funcționarea Uptime Kuma

Adresa IP și parola root a serverului sunt afișate pe pagina Server Details din panoul clientului. Deschideți browserul și accesați:

http://your.server.ip

La primul acces, Uptime Kuma va afișa un formular de înregistrare. Alegeți un nume de utilizator și o parolă, apoi faceți clic pe Create.

Important: Prima persoană care accesează interfața web creează contul de administrator. Finalizați acest pas imediat după provizionarea serverului.

Dacă ați plasat serverul în spatele unui router VyOS într-o rețea privată, configurați redirecționarea porturilor (80 și 443) pentru a accesa Uptime Kuma de pe internet sau conectați-vă prin VPN și accesați-l pe IP-ul privat al serverului.


Pasul 2 – Adăugarea primului monitor

După autentificare, faceți clic pe Add New Monitor în dashboard:

  • Monitor Type – HTTP(s), TCP, Ping, DNS și altele
  • Friendly Name – un nume descriptiv pentru monitor
  • URL / Hostname – ținta monitorizată
  • Heartbeat Interval – cât de des se face verificarea (implicit: 60 de secunde)

Faceți clic pe Salvare și monitorizarea începe imediat. Adăugați notificări (e-mail, Telegram, Slack, Discord și multe altele) din Settings > Notifications.


Pasul 3 – Configurarea domeniului și SSL (opțional)

Pentru a accesa Uptime Kuma printr-un domeniu cu HTTPS, creați o înregistrare DNS A care indică domeniul către IP-ul serverului. Apoi conectați-vă prin SSH și rulați:

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 va configura SSL și reînnoirea automată. Dashboard-ul va fi disponibil la https://your-domain.com.


După instalare

Fail2Ban – protecție împotriva atacurilor brute-force

Serverul dumneavoastră include Fail2Ban preconfigurat pentru a proteja SSH împotriva atacurilor brute-force.

Regulă Încercări maxime Durata blocării
SSH5 autentificări eșuate10 minute

Comenzi utile:

# Check banned IPs
fail2ban-client status sshd

# Unban an IP
fail2ban-client set sshd unbanip 1.2.3.4

Dacă vă blocați accidental, conectați-vă prin consola VNC din panoul clientului și deblocați-vă IP-ul.

Administrarea serviciilor

Uptime Kuma rulează sub PM2, care îl menține pornit și îl repornește automat după blocări sau reporniri.

# Check status
pm2 list

# View logs
pm2 logs uptime-kuma

# Restart
pm2 restart uptime-kuma

# Nginx reverse proxy
systemctl status nginx
systemctl reload nginx

Backup-uri

Toate datele (monitoare, notificări, istoricul stărilor) sunt stocate în SQLite. Puteți exporta/importa din interfața web (Settings > Backup) sau face backup prin SSH:

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

Actualizări

# 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

Software inclus

Componentă Versiune
Ubuntu24.04 LTS
Uptime Kuma2.x
Node.js22.x LTS
PM26.x
Nginx1.24
Fail2Ban1.0.2

Depanare

Problemă Soluție
Interfața web nu se încarcă Verificați starea: pm2 list. Reporniți dacă este necesar: pm2 restart uptime-kuma
502 Bad Gateway Este posibil ca Uptime Kuma să nu ruleze pe portul 3001. Verificați logurile: pm2 logs uptime-kuma
Notificările nu se trimit Accesați Settings > Notifications și folosiți butonul Test pentru a verifica canalul de notificare
Utilizare mare a memoriei Măriți intervalul heartbeat sau ștergeți istoricul vechi al stărilor din Settings > General
Ați uitat parola de administrator Conectați-vă prin SSH și resetați: cd /opt/uptime-kuma && npm run reset-password
Blocat de Fail2Ban Deblocați-vă IP-ul prin consola VNC din panoul clientului
Ați uitat parola root Resetați-o prin consola VNC din panoul clientului