Găzduirea Uptime Kuma pe un Managed VPS: monitorizați-vă serviciile continuu

Ce monitorizează Uptime Kuma

Uptime Kuma interoghează serviciile dumneavoastră la intervale regulate, până la una la 20 de secunde, păstrează istoricul răspunsurilor lor și vă anunță de îndată ce unul dintre ele nu mai răspunde. Se folosește dintr-o interfață web, disponibilă în mai multe limbi.

• Monitoarele: HTTP și HTTPS, căutarea unui cuvânt-cheie în pagină, cerere JSON, TCP, WebSocket, ping, înregistrare DNS, containere Docker și monitorul „push”, pentru o sarcină programată care își semnalează singură rularea.
• Alertele: peste 90 de servicii de notificare, printre care Telegram, Discord, Slack și e-mailul.
• Paginile de stare: mai multe pagini publice, fiecare pe propriul domeniu, dacă doriți.
• Certificatele: informațiile certificatului HTTPS al fiecărui serviciu monitorizat.
• Contul: autentificare în doi pași și trecere printr-un proxy pentru monitoarele care au nevoie de așa ceva.

Puneți Uptime Kuma pe alt server decât serviciile pe care le monitorizează. Pe o mașină distinctă, el vede pana din exterior și trimite alerta în timp ce serviciile dumneavoastră sunt oprite.

Ce permite licența MIT

Uptime Kuma este publicat sub licența MIT. Ea permite utilizarea, copierea, modificarea, îmbinarea, publicarea, distribuirea, sublicențierea și vânzarea software-ului, cu o singură condiție: păstrarea mențiunii de copyright și a textului licenței în orice copie.

Puteți deci rula Uptime Kuma în firmă, monitoriza cu el serviciile clienților dumneavoastră și le deschide pagini de stare, fără nicio licență de cumpărat.

Instalarea cu Docker Compose

Documentația Uptime Kuma începe cu Docker Compose. Pe un server unde Docker este instalat, creați un director și descărcați fișierul oficial:

mkdir uptime-kuma
cd uptime-kuma
curl -o compose.yaml https://raw.githubusercontent.com/louislam/uptime-kuma/master/compose.yaml

Fișierul proiectului publică portul 3001 pe toate adresele serverului. În spatele unui proxy invers, limitați-l la adresa locală, așa cum propune README-ul:

services:
  uptime-kuma:
    image: louislam/uptime-kuma:2
    restart: unless-stopped
    volumes:
      - ./data:/app/data
    ports:
      - "127.0.0.1:3001:3001"

docker compose up -d

• Un port publicat pe 127.0.0.1: Docker publică implicit pe toate adresele serverului, înaintea regulilor firewallului ufw. Publicat local, Uptime Kuma este accesibil doar prin proxy-ul invers.
• Un director data pe un disc local: el păstrează baza kuma.db, fișierele trimise și capturile de ecran. Proiectul exclude NFS și celelalte sisteme de fișiere în rețea, deoarece SQLite are nevoie de blocări de fișiere fiabile.
• Eticheta 2 urmărește versiunea 2 a Uptime Kuma, iar trecerea la o versiune majoră următoare rămâne alegerea dumneavoastră.
• Imaginea 2-slim este mai ușoară, cu aproximativ 185 MB de descărcat față de 620 MB: ea lasă deoparte Chromium și MariaDB-ul integrat pe care le conține imaginea 2. Imaginea 2 este cea recomandată de proiect, iar un monitor „Browser Engine” cere atunci un Chromium extern cu 2-slim.

La prima pornire, deschideți interfața: un asistent vă face să alegeți baza de date, apoi să creați contul de administrator. Activați autentificarea în doi pași încă de la prima conectare.

Proiectul nu indică nici memoria, nici procesorul necesare: dimensiunea depinde de numărul de servicii de monitorizat și de frecvența dorită. Pe un Managed VPS, descrieți-ne utilizarea dumneavoastră și vă recomandăm dimensiunea potrivită.

HTTPS și WebSocket: proxy-ul invers

Pe o rețea publică, proiectul cere HTTPS. Uptime Kuma se bazează pe WebSocket: proxy-ul invers trebuie să transmită antetele Upgrade și Connection. El se servește la rădăcina unui domeniu sau a unui subdomeniu, iar wiki-ul său exclude subdirectoarele precum example.com/uptimekuma.

Cu Caddy

Caddy obține și reînnoiește singur certificatul și transmite WebSocket fără nicio setare în plus:

uptime.example.com {
    reverse_proxy 127.0.0.1:3001
}

Cu Nginx și Certbot

server {
    listen 80;
    server_name uptime.example.com;

    location / {
        proxy_pass         http://localhost:3001;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection "upgrade";
        proxy_set_header   Host $host;
    }
}

Certbot instalează apoi certificatul Let’s Encrypt și redirecționarea spre HTTPS, apoi reînnoiește singur certificatul:

sudo certbot --nginx -d uptime.example.com

Când Uptime Kuma este accesibil doar prin proxy, deschideți setările sale, „Settings”, „Reverse Proxy”, „HTTP Headers”, și treceți „Trust Proxy” pe „Yes”: jurnalele afișează atunci adresa reală a vizitatorilor.

SQLite sau MariaDB

Începând cu versiunea 2, Uptime Kuma propune trei baze de date, la alegere în asistentul primei porniri:

Pentru a fixa alegerea dinainte, fără a trece prin asistent, variabilele UPTIME_KUMA_DB_TYPE, UPTIME_KUMA_DB_HOSTNAME, UPTIME_KUMA_DB_PORT, UPTIME_KUMA_DB_NAME, UPTIME_KUMA_DB_USERNAME și UPTIME_KUMA_DB_PASSWORD se adaugă serviciului în compose.yaml.

Notificările, inclusiv e-mailul

Un monitor are rost doar dacă alerta ajunge la dumneavoastră. Declarați canalele în „Settings”, „Notifications”, trimiteți un mesaj de probă din fiecare și prevedeți două, de exemplu o aplicație de mesagerie și e-mailul: dacă unul cade, celălalt preia ștafeta.

Pentru e-mail, Uptime Kuma se conectează la un server SMTP. Pe un VPS Simafri, trimiterea trece printr-un releu autentificat, pe portul 587: adresa unui cont de e-mail pe care îl aveți deja sau Simafri Suite.

Backupuri și actualizări

Începând cu versiunea 2, backupul directorului data este singura metodă pe care proiectul o suportă. Cu SQLite sau cu MariaDB-ul integrat, totul se află acolo. O bază SQLite copiată în plină scriere poate ajunge coruptă: opriți containerul pe durata copierii, știind că monitoarele se opresc odată cu el.

docker compose stop
tar -czf uptime-kuma-$(date +%F).tar.gz data
docker compose start

Actualizarea

Wiki-ul proiectului dă două comenzi, din directorul fișierului compose.yaml. Directorul data rămâne pe loc:

docker compose pull
docker compose up -d --force-recreate

Citiți notele de versiune înaintea fiecărei actualizări: unele conțin corecturi de securitate, precum versiunea 2.5.9 din 31 octombrie 2026. Un backup făcut chiar înainte vă oferă o revenire simplă.

Trecerea de la versiunea 1 la versiunea 2 cere mai multă grijă: salvați directorul data, cu containerul oprit, și lăsați migrarea să ajungă la capăt, căci o migrare întreruptă impune restaurarea backupului. Proiectul a măsurat aproximativ 7 minute pentru 20 de monitoare și 90 de zile de istoric, și mult mai mult pe o mașină modestă sau cu mai multe monitoare.

Cine ce face pe un Managed VPS

Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; Uptime Kuma rămâne software-ul dumneavoastră, cu setările și datele sale.

Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.