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.
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 |
|---|---|---|
| SSH | 5 autentificări eșuate | 10 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 |
|---|---|
| Ubuntu | 24.04 LTS |
| Uptime Kuma | 2.x |
| Node.js | 22.x LTS |
| PM2 | 6.x |
| Nginx | 1.24 |
| Fail2Ban | 1.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 |