Hizmetlerinizi ve web sitelerinizi izlemek için Uptime Kuma'yı Docker ile nasıl kurarsınız?

Son güncelleme: 02/09/2026

  • Uptime Kuma, HTTP, TCP, DNS ve Ping kullanarak hizmetlerin kullanılabilirliğini izlemenizi sağlayan açık kaynaklı bir araçtır.
  • Dağıtım, Docker konteynerleri veya Docker Compose kullanılarak kolayca gerçekleştirilebilir ve verilerin yerel disklerde kalıcı olarak saklanması sağlanır.
  • Sistem, gerçek zamanlı uyarılar almak için Telegram ve Discord'u öne çıkararak 90'dan fazla bildirim kanalını entegre ediyor.
çalışma süresi kuma

Eğer evinizde küçük bir sunucunuz varsa, NAS İster birkaç web sitesi yönetin ister yönetmeyin, her beş dakikada bir kontrol etmek zorunda kalmadan her şeyin düzgün çalıştığını bilmenin verdiği huzuru takdir edeceksiniz. Bazen bilgisayar açık olduğu için servisin yanıt verdiğini varsayarız, ancak gerçek şu ki, altta yatan uygulama çökmüş veya donmuşken bir konteyner çalışıyor olabilir ve bizi çaresiz bırakabilir. Neyse ki, elimizde şu seçenek var: Hizmetlerinizi ve web sitelerinizi izlemek için Uptime Kuma'yı Docker ile kurun.

Uptime Kuma Bu, karmaşık bir kurumsal altyapı kurmak zorunda kalmadan hizmetlerimizi izlememizi sağlayan açık kaynaklı bir araçtır. Basit bir ping'den daha güçlü bir şey arayan ancak Prometheus'u yapılandırmanın veya pahalı aylık abonelikler ödemenin zahmetine girmek istemeyenler için ideal bir seçenektir. Temel olarak, 7/24 güvenlik görevlisi Bu, bir şey yanıt vermeyi bıraktığı anda cep telefonumuza bir bildirim gönderir.

Dağıtım için ön koşullar

Herhangi bir kurulum işlemine başlamadan önce, zemini hazırlamamız gerekiyor. En önemli şey, aşağıdaki özelliklere sahip bir sunucuya sahip olmaktır: Docker ve Docker Compose artık çalışır durumda.Eğer bunlara sahip değilseniz, resmi Docker betiğini kullanarak Ubuntu veya Debian gibi dağıtımlara hızlıca kurabilirsiniz. Kaynaklar açısından ise Uptime Kuma şaşırtıcı derecede hafiftir; 1 vCPU ve 1 GB RAM'e sahip mütevazı bir VPS fazlasıyla yeterli olacaktır, çünkü sistem tipik olarak yaklaşık olarak şu kadar kaynak tüketir: 200 MB RAM Yüzlerce aktif monitör olsa bile.

Dikkate alınması gereken bir diğer nokta da depolama alanıdır. Varsayılan SQLite veritabanı çok büyük olmasa da, çok uzun bir çökme geçmişini saklamak istiyorsanız, en az 10 GB alan ayırmanızı öneririm. Ayrıca, panele yerel ağınızın dışından erişmeyi planlıyorsanız, şunlara ihtiyacınız olacak: kendi alan adınız ve bir ters proxy gibi Nginx Proxy Yöneticisi SSL sertifikalarını yönetmek ve güvenli bir bağlantı sağlamak.

Modern bir veri merkezinde sunucuların durumunun profesyonel olarak izlenmesi.
İlgili makale:
Uptime Kuma ile web sitenizi nasıl izleyebilir ve uyarıları nasıl kurabilirsiniz?
Uptime Kuma'yı Docker ile nasıl kurarsınız?
Uptime Kuma'yı Docker ile nasıl kurarsınız?

Docker Compose ile adım adım kurulum

Uptime Kuma'yı kurmanın en temiz ve profesyonel yolu bir YAML dosyası kullanmaktır. Öncelikle, işleri düzenli tutmak için, örneğin ana dizininizde, özel bir klasör oluşturun ve ardından dosyayı bu klasörün içine oluşturun. docker-compose.ymlBu yöntem tercih edilir çünkü bize olanak tanır. Güncellemeleri ve hacimleri yönetin Tek bir komutla olduğundan çok daha kolay bir şekilde.

Özel içerik - Buraya Tıklayın  Atlassian, yapay zeka destekli iş tarayıcısı Dia'yı desteklemek için The Browser Company'yi satın aldı

Optimize edilmiş bir yapılandırmaya örnek olarak şunlar verilebilir:

Hizmetler: uptime-kuma: imaj: louislam/uptime-kuma:2 konteyner adı: uptime-kuma yeniden başlat: durdurulmadığı sürece portlar: - "3001:3001" birimler: - ./data:/app/data ortam: - TZ=Europe/Madrid sağlık kontrolü: test: aralık: 60s zaman aşımı: 30s yeniden deneme sayısı: 5

Dosya kaydedildikten sonra, çalıştırmanız yeterlidir. docker compose up -d Böylece konteyner arka planda çalışmaya başlar. Şimdi yapmanız gereken tek şey tarayıcınızı açıp sunucunuzun IP adresini ve ardından 3001 portunu girmek. İlk göreceğiniz şey sihirbaz olacaktır. yönetici kullanıcısını oluşturBurada dikkat edin: Güçlü bir şifre seçin çünkü Uptime Kuma'nın kolay bir şifre kurtarma sistemi yok ve şifrenizi kaybederseniz veritabanını manuel olarak düzenlemeniz gerekecek.

Modern bir veri merkezindeki sunucu ekipmanlarının yakın çekim görüntüsü, Uptime Kuma'nın devreye alınması için gereken teknolojik altyapıyı göstermektedir.
İlgili makale:
Uptime Kuma ile TCP Portlarını ve Servislerini İzlemeye Yönelik Kapsamlı Kılavuz

Hızlı alternatif: Docker Run kullanarak kurulum

 

YAML dosyalarıyla uğraşmak istemiyorsanız ve izleme hizmetinin hemen çalışır durumda olması gerekiyorsa, "tek satırlık" seçeneği mevcuttur. Terminalde tek bir komut çalıştırmak hizmeti devreye alacaktır. Bu komut konteyneri oluşturur, 3001 portunu atar ve bir ayar yapar. uptime-kuma adlı kalıcı hacim Böylece konteyneri yeniden başlattığınızda ayarlarınız kaybolmaz.

Özel içerik - Buraya Tıklayın  Disk alanını boşaltmak ve diskinizi optimize etmek için WinDirStat nasıl kullanılır

Komut şu şekilde olurdu: docker run -d --restart=always -p 3001:3001 -v uptime-kuma:/app/data --name uptime-kuma louislam/uptime-kuma:1Daha hızlı olmasına rağmen, üretim ortamları için Compose kullanmanın çok daha uygun olduğunu unutmayın. hizmetlerinizin yönetimini merkezileştirin.

Uptime Kuma'yı Docker ile Kurma: İlk Yapılandırma ve Optimizasyon

Gözlüklerde yansıyan programlama kodu, yazılım dağıtımı için Docker Compose dosyalarının teknik yapılandırmasını göstermektedir.
Uptime Kuma'yı Docker ile nasıl kurarsınız?

Panelin içine girdikten sonra, sadece monitörler oluşturup işi bitmiş saymayın. Ayarlamanız gereken üç kritik ayar var. Birincisi, Genel menüsündeki saat dilimi; bunu değiştirmezseniz, çökme günlükleri UTC olarak görünecek ve gerçek zamanı hesaplamaya çalışırken kendinizi çıldırtacaksınız. İkincisi, etkinleştirin... iki faktörlü kimlik doğrulama (2FA) Güvenlik bölümünde, panel bildirimlerinizden hassas veriler sakladığı için dikkatli olunmalıdır. Üçüncüsü, ters proxy kullanıyorsanız, şu seçeneği etkinleştirin: proxy başlıklarına güvenmek Böylece sistem, proxy'nin IP adresini değil, ziyaretçinin gerçek IP adresini kaydeder.

Sistemin sunucunuzun kaynaklarını tüketmesini önlemek için kontrol aralıklarını ayarlayın. Kritik olmayan bir hizmeti her 10 saniyede bir izlemenize gerek yok; çoğu durumda 60 saniyelik bir aralık fazlasıyla yeterlidir. CPU yükünü önemli ölçüde azaltır ve veritabanının boyutu.

Modern bir veri merkezindeki profesyonel sunucu donanımının yakın çekim görüntüsü, sürücü yuvalarını ve durum LED'lerini gösteriyor.
İlgili makale:
Uptime Kuma ile SSL sertifikasının geçerlilik süresinin nasıl izleneceği

İzleme ve uyarı türleri

Uptime Kuma'yı Docker ile kurmak sayısız avantaj sunar. HTTP/HTTPS kullanan basit web sitelerinden daha karmaşık web sitelerine kadar her şeyi izleyebilirsiniz. Belirli TCP portları, DNS sorguları Hatta diğer Docker konteynerlerinin durumunu bile gösterebilir. Çok kullanışlı bir özellik de anahtar kelime kontrolüdür: Bu özellik, web sitesi 200 kodu döndürdüğü için her şeyin yolunda olduğunu söylemesini engeller; gerçekte ise özel bir hata sayfası görüntülüyor olabilir.

Sistemin kullanışlı olması için size bildirim göndermesi gerekir. Telegram muhtemelen en uygun seçenektir. Sadece @BotFather ile bir bot oluşturmanız, token ve Sohbet Kimliğini almanız ve Bildirimler panelinde yapılandırmanız yeterlidir. Discord da webhook'lar kullanarak harika bir seçenektir, ancak dikkatli olmanız gerekir. mesaj hızı sınırları Eğer yüzlerce monitörünüz aynı anda çöküyorsa, özellikle de Uptime Kuma bildirim göndermez. doygunluk yoluyla doğru şekilde.

Özel içerik - Buraya Tıklayın  Samsung TV'de Copilot: Entegrasyon, özellikler ve uyumlu modeller

Başkaları için hizmet yönetiyorsanız, herkese açık Durum Sayfaları oluşturabilirsiniz. Bu sayfalar, yönetim panelinize kimsenin erişimi olmadan, hizmetlerinizin kullanılabilirliğini harici bir URL üzerinden görüntülemenizi sağlar. İdeal olarak, bir tane genel Durum Sayfanız olmalıdır. Müşteriler için herkese açık sayfa ve daha hassas monitörlere sahip, dahili kontrolünüz için ayrı bir özel monitör daha.

NTFy'de anlık bildirimlerin kurulumu ve sorun giderme
İlgili makale:
NTfy'nin Kapsamlı Kılavuzu: Anlık Bildirimleri Kurma ve Sorun Giderme

Sık karşılaşılan hatalar ve bakım

Kullanıcıların yaptığı en ciddi hata yedeklemeyi unutmaktır. Tüm ayarlar klasörde bulunur. /app/dataDisk arızalanırsa veya yanlışlıkla disk birimini silerseniz, tüm geçmişinizi ve izleme verilerinizi kaybedersiniz. Bunu yapan basit bir komut dosyası programlayın. o dizinin günlük yedeğinin alınması başka bir konuma veya buluta.

Bir diğer hata da sunucuyu yeniden başlatmadan önce bakım modunu etkinleştirmemektir. Bunu yapmazsanız, olay günlüğü yanlış çökmelerle dolacaktır ve Çok sayıda uyarı alacaksınız. Telefonunuzdaki gereksiz bildirimler. Bakım modunu etkinleştirmek, bildirimleri durdurur ve yönetimsel görevlerinizi yerine getirirken geçmişinizi temiz tutar.

Uptime Kuma'yı Docker ile kurmak, herhangi bir ev laboratuvarının veya küçük altyapının yönetimini dönüştürerek, reaktif bir yaklaşımdan proaktif bir yaklaşıma geçişi sağlar. Konteynerlerin hafif yapısını, gerçek zamanlı uyarıların gücünü ve birden fazla protokolü izleme esnekliğini birleştirerek, aşırı teknik karmaşıklık veya maliyet olmadan hizmet kullanılabilirliği üzerinde tam kontrol elde edersiniz.

Beszel ile Sunucu ve Docker İzleme
İlgili makale:
Beszel ile Sunucu ve Docker İzleme