Uptime Kuma hakkında
Uptime Kuma, Louis Lam ve topluluğu tarafından MIT lisansıyla geliştirilen, kendi sunucunuzda çalıştırdığınız bir izleme aracıdır. Web sitelerinizi, API'lerinizi, TCP portlarını, sunucuları (ping), DNS kayıtlarını veya Docker konteynerlerini düzenli aralıklarla yoklar. Bir şey yanıt vermeyi bıraktığında Telegram, Discord, Slack, e-posta ya da webhook ile haber verir. Arayüzü sadedir ve dokümantasyona bakmadan kullanılabilir.
Geliştiriciler, ajanslar ve küçük ekipler için uygundur: bir servis çöktüğünde bunu müşterilerinden önce öğrenmek isteyen ama monitör başına SaaS aboneliği ödemek istemeyenler. Aracı kendi VPS'inizde çalıştırmak, izleme verilerinin denetimini de size bırakır.
Teslimatta sunucuda Docker, Uptime Kuma (louislam/uptime-kuma:2 imajı) ve bir Caddy ters vekil sunucusu (reverse proxy) hazır bulunur. Uygulama yalnızca 127.0.0.1:3001 adresini dinler. Caddy onu, sunucunun genel IP adresinin 443 portunda, otomatik imzalı (self-signed) bir sertifikayla HTTPS üzerinden yayınlar. Geriye yalnızca adresi açıp yönetici hesabını oluşturmak kalır.
Uptime Kuma ile neler yapabilirsiniz
Çok sayıda monitör türü
HTTP(S), sayfada anahtar kelime, TCP, ping, DNS, Docker konteyneri ve daha fazlası. Kontrol aralığını ve uyarıdan önce kaç başarısız denemenin olacağını siz belirlersiniz.
Alıştığınız kanallardan uyarı
Telegram, Discord, Slack, SMTP e-posta, webhook ve birçok başka bildirim servisi arayüzden seçilebilir. Eklenti kurmanız gerekmez.
Herkese açık durum sayfaları
Servislerinizin durumunu müşterileriniz veya ekibiniz için bir sayfada yayınlarsınız. İsterseniz kendi alan adınızı kullanabilirsiniz.
TLS sertifikası takibi
Uptime Kuma, izlenen HTTPS sitelerinin sertifika bitiş tarihini okur ve süre dolmadan sizi uyarabilir.
Docker ve Caddy hazır kurulu
Otomatik yeniden başlayan (
restart: always) iki konteyner, düzenleyip sürüm kontrolüne alabileceğiniz birdocker-compose.ymldosyasında tanımlıdır.Veriler ayrı bir volume'de
Monitör yapılandırması ve geçmişi
kuma_dataDocker volume'ünde saklanır. Bu, yedekleme ve güncellemeyi kolaylaştırır.
Uptime Kuma ile başlayın
Siparişten canlıya birkaç dakikada.
- 1
VPS'i Uptime Kuma ile sipariş edin
Sipariş formunda Debian 12, Debian 13 veya Ubuntu 20.04, 22.04, 24.04 yüklü bir Linux VPS seçin (Paris veya Frankfurt). "Uygulamalar" sekmesinde Uptime Kuma'yı işaretleyin.
- 2
Teslimatı bekleyin ve arayüzü açın
Sunucu teslim edildikten sonra kurulum arka planda birkaç dakika sürer (Docker ve imajların indirilmesi). Ardından aşağıdaki adresi açın. Sertifika otomatik imzalı olduğundan tarayıcı bir uyarı gösterir: devam etmek için istisnayı kabul edin.
Bashhttps://SERVER_IP:443 # SSH ile konteynerlerin durumunu kontrol edin: ssh root@SERVER_IP cd /opt/uptime-kuma && docker compose ps - 3
Admin hesabını ve ilk monitörü oluşturun
İlk girişte Uptime Kuma sizden yönetici kullanıcısını oluşturmanızı ister. Ardından bir monitör ekleyin (örneğin sitenize HTTP(S)) ve uyarıları almak için bir bildirim kanalı tanımlayın.
- 4
Üretim için güvenli hale getirin
YOUR_DOMAIN için SERVER_IP adresini gösteren bir DNS A kaydı oluşturun, sonra Caddyfile'daki adresi alan adınızla değiştirin: Caddy tanınan bir sertifika alacaktır. 80 ve 443 portları açık kalmalı, mümkünse 22 portunu yalnızca kendi IP adreslerinize sınırlayın.
Bashcd /opt/uptime-kuma nano Caddyfile # YOUR_DOMAIN { # reverse_proxy 127.0.0.1:3001 # } docker compose restart caddy
Uptime Kuma kullanım alanları
Sitelerinizi ve API'lerinizi izleyin
Her site veya kritik endpoint için bir HTTP monitörü kurun. Yanıt kodu beklenen aralığın dışına çıktığında Telegram ya da e-posta ile uyarı alın.
Müşterileriniz için durum sayfası
Bir ajans veya SaaS yayıncısı servislerinin durumunu ayrı bir sayfada yayınlar. Böylece her soruya tek tek mesajla yanıt vermek gerekmez.
Sunucuları ve iç portları kontrol edin
Makinelerinize ping, bir veritabanına veya SSH servisine TCP kontrolü, bir Docker konteynerinin denetimi: altyapıya tek ekrandan bakış.
Sertifika bitişlerini önceden yakalayın
Alan adlarınızın sertifika bitiş tarihlerini izler, başarısız bir yenileme bir siteyi kapatmadan önce uyarı alırsınız.
Uptime Kuma hakkında sık sorulan sorular
Tarif, Caddy'yi tls internal ile yapılandırır. Bu ayar, sunucunun IP adresi için otomatik imzalı bir sertifika üretir. Şifreleme etkindir, ancak tarayıcı sertifikayı veren tarafı doğrulayamaz. Tanınan bir sertifika için sunucuya bir alan adı bağlayın ve Caddyfile'ı düzenleyin.
Uptime Kuma hakkında daha fazlası
Dosyaların konumu
Her şey /opt/uptime-kuma altındadır: kurulum betiği install-uptime-kuma.sh, docker-compose.yml dosyası ve Caddyfile. Caddy network_mode: host ile çalışır ve Caddyfile'ı salt okunur olarak okur.
Caddyfile'ı düzenledikten sonra kurulum betiğini yeniden çalıştırmayın: betik dosyayı genel IP adresiyle baştan yazar ve alan adı yapılandırmanız kaybolur. Bir değişikliği uygulamak için docker compose restart caddy komutunu kullanın.
IP adresinden alan adına geçiş
Varsayılan olarak Caddyfile, tls internal ile birlikte https://IP_PUBLIQUE:443 satırını içerir. Otomatik imzalı sertifikanın nedeni budur. Bu satırı bir alan adıyla değiştirir ve tls internal ifadesini silerseniz, Caddy herkesçe tanınan bir sertifikayı kendisi alır ve yeniler. DNS kaydı sunucuyu şimdiden göstermelidir, aksi halde istek başarısız olur.
Yedekleme
Uptime Kuma verileri kuma_data Docker volume'ündedir. En güvenli yol, kopyalama süresince konteyneri durdurup volume'ü arşivlemektir.
Bashcd /opt/uptime-kuma docker compose stop uptime-kuma docker volume ls | grep kuma_data docker run --rm -v uptime-kuma_kuma_data:/data -v $(pwd):/backup alpine \ tar czf /backup/kuma-backup.tar.gz -C /data . docker compose start uptime-kuma
Volume'ün tam adı proje klasörüne bağlıdır; docker volume ls komutuyla kontrol edin. Ardından arşivi sunucunun dışına kopyalayın. VPS anlık görüntüsü (snapshot) iyi bir tamamlayıcıdır.
Güncellemeler
İmaj, 2.x sürümlerini izleyen 2 etiketini kullanır. En son sürüme geçmek için önce yedek alın, ardından şunları çalıştırın:
Bashcd /opt/uptime-kuma docker compose pull docker compose up -d
İzleme aracını nereye kurmalı
İzlediği sunucunun üzerinde çalışan bir monitör, o sunucunun tamamı kapandığında sizi uyarmaz. Önemli servisler için Uptime Kuma'yı ayrı bir VPS'e, örneğin diğer lokasyona (Paris veya Frankfurt) kurun. Daha fazlası için eğitim yazılarımıza göz atın.

