SSD Nodes Learn Hosting plans →
Rehberler Matt ConnorYazan Matt Connor

Docker ile kendi ntfy sunucunuzu kurma ve güvenliği

Ubuntu 24.04 veya Debian 13 üzerinde ntfy’yi Docker Compose ve TLS ile çalıştırın. Users ve ACL ile topic erişimini sınırlandırıp cron ile bildirim gönderin.

Kendi barındırdığınız ntfy sunucusu ne yapar

Kendi barındırdığınız bir ntfy sunucusu, HTTP POST isteğini telefonunuza gönderilen bir push bildirimine dönüştürür. curl ile mesaj yayımlanır ve mesaj Android uygulamasına, iOS uygulamasına, bir tarayıcı sekmesine veya açık bir HTTP bağlantısını sürdürebilen başka herhangi bir istemciye ulaşır. İstemci kitaplığı kurulması veya mesaj aracısı çalıştırılması gerekmez.

ntfy, mesajları topic üzerinden adresler. Topic, https://ntfy.example.com/alerts gibi URL yolunda yer alan bir addır ve birisi bu topic'e mesaj yayımladığı anda oluşur. Varsayılan kurulumda, bu adı bilen herkes topic'i okuyabilir ve topic'e yazabilir. Bu nedenle projenin kendi belgelerinde topic adı bir parolaya benzetilir. Bu model genel ntfy.sh hizmeti için uygundur. Yedekleme hatalarınızı taşıyan bir sunucu için uygun değildir. Bu nedenle bu kılavuzda, ilk mesaj gönderilmeden önce kimlik doğrulama etkinleştirilir.

Başlamadan önce gerekenler

Ubuntu 24.04 veya Debian 13 çalıştıran, Docker Engine ve Compose eklentisi kurulu bir VPS'e, bir alan adına ve çok az miktarda RAM'e ihtiyacınız vardır. Sunucunun genel IP adresini işaret eden bir DNS (alan adı sistemi) A kaydı oluşturun ntfy.example.com ve başka bir işleme başlamadan önce kaydın çözümlendiğini doğrulayın.

dig +short ntfy.example.com
sudo ufw allow 80,443/tcp
sudo ufw status

dig komutu sunucunuzun IP adresini döndürmelidir. Sertifika düzenleme işlemi, ana bilgisayar adının bir A veya AAAA kaydı aracılığıyla sunucuya genel olarak çözümlenmesini gerektirir. Let's Encrypt protokolünün arkasındaki teknoloji olan ACME (otomatik sertifika yönetim ortamı), HTTP sınaması için 80 numaralı portu kullandığından bu port açık kalmalıdır. ntfy container'ının kendisi hiçbir zaman genel bir port üzerinden erişime açılmaz.

ntfy yapılandırma dosyasını oluşturma

Docker imajı bir yapılandırma dosyası içermediğinden, bir tane oluşturmanız gerekir. Bu kılavuzdaki sonraki tüm komutlar bu dosyayı okuyacaktır. Öncelikle, container'ın çalışacağı kullanıcı kimliğini (UID) ve grup kimliğini (GID) bulun.

id -u
id -g
sudo install -d -o "$(id -u)" -g "$(id -g)" /etc/ntfy /var/cache/ntfy /var/lib/ntfy
sudo nano /etc/ntfy/server.yml
base-url: "https://ntfy.example.com"
listen-http: ":2586"
behind-proxy: true
cache-file: "/var/cache/ntfy/cache.db"
cache-duration: "12h"
auth-file: "/var/lib/ntfy/user.db"
auth-default-access: "deny-all"
enable-login: true
enable-signup: false

Bu satırlardan dördü kritik öneme sahiptir. base-url, ntfy tarafından oluşturulan ek bağlantıları ve self-hosted iOS anlık bildirimleri için kullanıldığından, tam HTTPS genel adresi olmalıdır. listen-http: ":2586", container içindeki tüm arayüzlere bağlanır; bu durum ilk bakışta güvensiz görünse de doğrudur: container kendi ağ ad alanına (network namespace) sahiptir, bu nedenle orada 127.0.0.1 adresine bağlanmak portu ana makineden erişilemez kılar ve Docker'ın yayınladığı port asla bağlantı kuramaz. auth-default-access: "deny-all" tüm güvenlik duruşunu belirler, çünkü açık bir yetkilendirme olmadan kimsenin okuma veya yazma yapmasına izin vermez. behind-proxy: true, ntfy'ye istemci adresini X-Forwarded-For başlığından almasını söyler; böylece hız sınırlamaları (rate limits), reverse proxy'yi tek bir yoğun istemci olarak saymak yerine gerçek ziyaretçileri sayar.

enable-login: true, kullanıcıların web uygulaması veya API üzerinden giriş yapmasına olanak tanır. enable-signup, özel bir sunucuda kendi kendine hesap oluşturma özelliği ek bir güvenlik riski oluşturduğundan false olarak bırakılmalıdır.

sudo chown "$(id -u):$(id -g)" /etc/ntfy/server.yml
sudo chmod 600 /etc/ntfy/server.yml

Docker Compose ile ntfy çalıştırma

Bunu /opt/ntfy/compose.yaml içine yerleştirin ve 1000:1000 kısmını yukarıda yazılı olan id -u ve id -g sayılarıyla değiştirin.

services:
  ntfy:
    image: binwiederhier/ntfy:v2.36.0
    container_name: ntfy
    command: serve
    user: "1000:1000"
    environment:
      - TZ=UTC
    volumes:
      - /etc/ntfy:/etc/ntfy
      - /var/cache/ntfy:/var/cache/ntfy
      - /var/lib/ntfy:/var/lib/ntfy
    ports:
      - "127.0.0.1:2586:2586"
    restart: unless-stopped
cd /opt/ntfy
sudo docker compose up -d
sudo docker compose logs ntfy
curl -s http://127.0.0.1:2586/v1/health

Sağlıklı bir sunucu {"healthy":true,"role":"active"} yanıtını verir. Compose dosyasındaki iki detay kasıtlıdır. İmaj, latest yerine 1 Kasım 2026 itibarıyla güncel kararlı sürüm olan v2.36.0 sürümüne sabitlenmiştir. Çünkü latest ile bir sonraki docker compose pull komutu mevcut imajı indirir ve ardından gelen docker compose up -d komutu container'ı bununla yeniden oluşturur; sadece pull işlemi çalışan sunucu sürümünü değiştirmez. Sabitlemenin yine de güncellenmesi gerekir. Sadece Ekim 2026'da on sürüm yayınlandı: 7 Ekim'de v2.29.0, 12 Ekim'de v2.30.0, 16 Ekim'de v2.31.0 ve v2.31.1, 18 Ekim'de v2.32.0, 23 Ekim'de v2.33.0 ve v2.33.1, 24 Ekim'de v2.34.0, 30 Ekim'de v2.35.0 ve 31 Ekim'de v2.36.0. v2.31.0, bir istemci mesaj önbelleğine ulaşmadan önce yeniden bağlandığında kaybolan mesajları düzeltir ancak since=<message ID> ile yapılan yeniden bağlanma işlemleri konudaki her mesajı veritabanından okur ve ntfy.sh bu sürümden geri dönmüştür. v2.31.1 bu yükü yeni bir dizin ile düzeltir ve v2.34.0, iptal edilen veya silinen kullanıcıların bazı abonelikleri tutmaya devam etmesi sorununu giderir. v2.35.0, eşzamanlı isteklerin geçerli kimlik bilgilerini anonim olarak değerlendirmesini ve SQLite üzerindeki bir Matrix push gateway yetkilendirme atlatmasını düzeltir, bu nedenle eski sabitlemeleri v2.36.0 sürümüne taşıyın. Port 127.0.0.1:2586:2586 olarak yayınlanır, böylece container'a yalnızca ana makinenin loopback adresinden ulaşılabilir. Bunun yerine 2586:2586 yazarsanız, Docker kendi güvenlik duvarı kurallarını sizinkilerin önüne ekler; bu da ufw status portun kapalı olduğunu söylese bile portun internetten yanıt vermesi anlamına gelir. Her iki alışkanlık da eklediğiniz bir sonraki container'a taşınır: kendi kendine barındırılan bir RustDesk relay imaj etiketini aynı şekilde sabitler ancak sinyal ve relay portlarının internetten yanıt vermesi gerektiğinden loopback arkasına saklanamaz.

Eğer curl Connection refused çıktısı verirse, container günlüğünü okuyun. /var/lib/ntfy/user.db üzerindeki bir izin hatası, user: satırının bu dizinlerin sahibiyle eşleşmediği anlamına gelir; bu nedenle süreç kendi veritabanını oluşturamaz ve sonlanır. VPS için Docker Compose temel kılavuzu, birim sahipliği ve yeniden başlatma politikalarını daha ayrıntılı olarak ele alır.

TLS'i Caddy ile öne alın

Caddy, sertifikayı kendi başına talep eder ve yeniler; bu, çalışan bir TLS (taşıma katmanı güvenliği) yapısına ulaşmanın en kısa yoludur.

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy

/etc/caddy/Caddyfile içeriğini üç satır ile değiştirin.

ntfy.example.com {
    reverse_proxy 127.0.0.1:2586
}
sudo systemctl reload caddy
curl -s https://ntfy.example.com/v1/health

HTTPS üzerinden aynı {"healthy":true,"role":"active"}, tüm yolun çalıştığı anlamına gelir. Caddy'den gelen bir 502, genellikle ntfy'nin dinleme yapmadığı anlamına gelir: sudo ss -lntp | grep 2586 ile kontrol edin. Eğer ntfy dinleme yapıyorsa ve 502 devam ediyorsa, Caddy karşılaştığı yukarı akış hatasını (örneğin bağlantı sıfırlama) günlüğe kaydeder. Bir sertifika hatası genellikle DNS kaydının yanlış olduğu veya sertifika doğrulamasının 80 ya da 443 numaralı portlar üzerinden sunucuya ulaşamadığı anlamına gelir; doğrulama hatası için sudo journalctl -u caddy -n 50 dosyasını inceleyin. Daha sonra başka bir servis eklemek, aynı Caddyfile içinde bir ana makine bloğu daha eklemeyi gerektirir; Jellyfin kütüphaneniz için 90'lardan kalma bir video mağazası arayüzü olan Halcyon gibi bir uygulamanın aynı sunucuda ikinci bir alt alan adında bu şekilde çalışması sağlanır.

Halihazırda nginx çalıştırıyorsanız, ntfy dokümanlarında belirtilen proxy ayarlarını kopyalayın: proxy_http_version 1.1, proxy_buffering off, proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for ve en az üç dakikalık okuma ve gönderme zaman aşımları ayarlayın. Bir abone, dinleme yaptığı sürece bir HTTP bağlantısını açık tutar. nginx'in varsayılan proxy_read_timeout değeri olan 60 saniye, yalnızca iki okuma arasındaki süreyi sayar ve ntfy, aracıların bağlantıyı hareketsizlik nedeniyle kapatmaması için varsayılan olarak her 45 saniyede bir (keepalive-interval) canlı tutma mesajı gönderir. Bu nedenle sessiz bir abone, standart nginx arkasında bile bağlı kalır; daha uzun zaman aşımları, bağlantıyı canlı tutan şey değil, sadece bir güvenlik payıdır. Eğer keepalive-interval değerini yükseltirseniz, bunu proxy'nizin okuma zaman aşımı değerinin altında tutun.

Kullanıcı oluşturma ve konu erişimlerini kısıtlama

Kimlik doğrulama etkinleştirildi ve henüz kimsenin hiçbir şeye erişimi yok; amaç da zaten bu. Kendiniz için bir yönetici hesabı ve betikler için bir makine hesabı oluşturun. Bu komutlar /etc/ntfy/server.yml dosyasını container içinden okur, bu nedenle yapılandırma dosyası bir volume mount olarak tanımlanmıştır.

sudo docker compose exec ntfy ntfy user add --role=admin admin
sudo docker compose exec ntfy ntfy user add robot
sudo docker compose exec ntfy ntfy user list

Her user add komutu bir parola ister. Yönetici, erişim listesini göz ardı eder ve her konuyu okuyup yazabilir; bu yüzden bu hesabı kendiniz ve mobil uygulama için saklayın. robot, siz izin verene kadar hiçbir erişimi olmayan sıradan bir kullanıcıdır.

sudo docker compose exec ntfy ntfy access robot alerts write
sudo docker compose exec ntfy ntfy access robot "alerts_*" write
sudo docker compose exec ntfy ntfy access

Bir ACL (erişim kontrol listesi) girdisi; bir kullanıcı, bir konu ve bir izinden oluşur. Konu, doğrudan bir isim veya * ifadesinin her şeyle eşleştiği bir desen olabilir; bu sayede alerts_*, her ana bilgisayar için ayrı komut girmeye gerek kalmadan alerts_backup ve alerts_db konularını kapsar. write izni yalnızca yayınlama (publish) anlamına gelir; böylece bir cron job üzerinden çalınan token, abone olup gönderilen verileri okuyamaz. Özel everyone kullanıcı adı, kimliği doğrulanmamış bir ziyaretçinin neler yapabileceğini belirler. Varsayılan olarak deny-all kullanıldığında, bunu genellikle ntfy access everyone status read gibi kasıtlı olarak herkese açık bir alan oluşturmak için kullanırsınız; ayrıca anonim ziyaretçileri bir konudan uzak tutan açık bir kural istediğinizde deny değerini de kabul eder.

Betikler parolanızı değil, bir token taşımalıdır.

sudo docker compose exec ntfy ntfy token add robot

Komut, tk_ ile başlayan bir token çıktısı verir. Bir token, ait olduğu kullanıcının erişim haklarını aynen devralır; bu nedenle bu token yalnızca alerts konularına yayın yapabilir ve başka hiçbir işlem yapamaz. ntfy token list mevcut olanları listeler, ntfy token remove ise kullanıcının parolasına dokunmadan bir token'ı iptal eder.

İlk mesajı gönderin ve kilidin çalıştığını doğrulayın

Önce kapının kapalı olduğunu kontrol edin.

curl -s -o /dev/null -w '%{http_code}\n' -d "hello" https://ntfy.example.com/alerts

Bu komut 403 çıktısını verir ve 403 doğru yanıttır: auth-default-access: "deny-all" anonim publish işlemini reddeder. Şimdi gerçek bir mesaj gönderin.

curl -H "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN" \
  -H "Title: Nightly backup finished" \
  -H "Priority: default" \
  -H "Tags: white_check_mark" \
  -d "42 GB copied in 11 minutes" \
  https://ntfy.example.com/alerts

Sunucu, kaydedilen mesajı JSON olarak yanıtlar. Mesajın yok sayılmak yerine kabul edildiği bu şekilde anlaşılır. Title kalın yazılan ilk satırdır. Priority değeri 1 ile 5 arasında olabilir veya adla min ile urgent arasında belirtilebilir; bu değer, telefonda ses çalınıp çalınmayacağını belirler. Ad bilinen bir emoji kısa koduyla eşleştiğinde Tags bildirimde emojiye dönüşür. Eşleşme olmadığında düz metin olarak kalır.

Bir terminalden topic izlemek için akışı başlatın:

curl -s -u admin https://ntfy.example.com/alerts/raw

curl parola ister. Her mesaj tek satır olarak gelir. Arada görünen boş satırlar keepalive iletileridir. Bir tarayıcıda https://ntfy.example.com adresini açıp aynı hesapla oturum açıldığında aynı akışın web uygulaması sürümü görüntülenir.

Bir betiğin sunucuyu kilitlememesi için hız sınırlarını ayarlama

Varsayılan olarak her ziyaretçi 60 isteklik bir kovaya sahiptir ve her 5 saniyede bir istek ile dolar. Bu, özel bir sunucu için cömerttir ve yeniden deneme döngüsüne takılan bir betik bunun tamamını kullanacaktır. server.yml içine limitler ekleyin.

visitor-request-limit-burst: 30
visitor-request-limit-replenish: "10s"
visitor-message-daily-limit: 500
sudo docker compose restart ntfy

Limiti aşan bir ziyaretçi, teslim edilen bir mesaj yerine HTTP 429 hatası alır. Limit, ziyaretçi adresi başına sayılır; behind-proxy: true ayarının bu kadar önemli olmasının nedeni budur: bu ayar olmadan ntfy yalnızca Caddy'nin adresini görür, her istemci aynı ziyaretçi olarak sayılır ve gürültülü bir betik, telefonunuzun ve diğer sunucularınızın paylaştığı kovayı tüketir. v2.36.0 sürümünden itibaren günlük sayımlar kullanıcı veritabanında yeniden başlatmalardan etkilenmez ve her ziyaretçinin kotası, UTC gece yarısı yerine kendi 24 saatlik döngüsünde sıfırlanır.

Cron işinden gelen hata bildirimi

Token'ı komut satırında tutmayın. ps aux, sistemde çalışan her işlemin tam komut satırını tüm kullanıcılara gösterir. Bu nedenle -H ile iletilen token, curl çalıştığı sürece herhangi bir yerel hesap tarafından okunabilir. Bunun yerine curl yapılandırma dosyası kullanılmalıdır.

sudo install -d -m 700 /etc/ntfy-alert
printf 'header = "Authorization: Bearer tk_REPLACE_WITH_YOUR_TOKEN"\n' | sudo tee /etc/ntfy-alert/curlrc
sudo chmod 600 /etc/ntfy-alert/curlrc

Şimdi işi bir sarmalayıcıyla çalıştırın. Bunu /usr/local/bin/backup-with-alert.sh olarak kaydedin ve chmod 750 ile çalıştırılabilir hale getirin.

#!/bin/bash
out=$(/usr/local/bin/backup.sh 2>&1)
code=$?
if [ "$code" -ne 0 ]; then
  printf '%s' "$out" | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
    -H "Title: backup.sh failed with exit $code" \
    -H "Priority: high" \
    -H "Tags: warning" \
    --data-binary @- \
    https://ntfy.example.com/alerts
fi
exit "$code"
17 3 * * * /usr/local/bin/backup-with-alert.sh >> /var/log/backup-alert.log 2>&1

$?, komuttan hemen sonraki satırda alınır. Bunun nedeni, çalıştırılacak sonraki komutun bu değerin üzerine yazacak olmasıdır. Çıktı tail -c 1000 üzerinden gönderilir. Çünkü ntfy ileti boyutuna üst sınır uygular ve bildirim bir log görüntüleyici değildir. Kapanıştaki exit "$code" özgün durumu korur. Böylece bu işi izleyen diğer bileşenler hâlâ hata görüyor olur. Tüm yapıyı test etmek için bir çalıştırmada script'i /bin/false hedefine yönlendirin.

Hiç çalışmayan bir hata dalı, bildirim mekanizmasının hiç olmamasından daha kötüdür. Çünkü sessizliğin başarı anlamına geldiği izlenimini yaratır. Cron, işinize neredeyse boş bir ortam ve login shell'inizden çok daha kısa bir PATH sağlar. Bu nedenle elle çalıştırıldığında çalışan bir script, curl satırına ulaşmadan önce sonlanabilir. Bir cron işinin neden çalışmadığını açıklayan kılavuz, bu ortam kaynaklı sorunları ele alır. Her yerde mutlak yollar kullanın. İlk zamanlanmış çalıştırmadan sonra log dosyasını okuyun; varsayımda bulunmayın.

Bir systemd birimi başarısız olduğunda uyarı alma

Cron, zamanlanmış işleri kapsar. Uzun süre çalışan servisler, bir birim failed durumuna girdiğinde systemd tarafından çalıştırılan OnFailure= mekanizmasına ihtiyaç duyar. Bir adet şablon birim oluşturun ve bunu sunucudaki her servis için yeniden kullanın. Bunu /etc/systemd/system/ntfy-unit-failed@.service olarak kaydedin.

[Unit]
Description=Send an ntfy alert because %i failed

[Service]
Type=oneshot
ExecStart=/usr/local/bin/ntfy-unit-failed %i

Ardından /usr/local/bin/ntfy-unit-failed komutunu 750 modunda çalıştırın:

#!/bin/bash
unit="$1"
journalctl -u "$unit" -n 15 --no-pager -o cat | tail -c 1000 | curl -K /etc/ntfy-alert/curlrc \
  -H "Title: $unit failed on $(hostname -s)" \
  -H "Priority: urgent" \
  -H "Tags: rotating_light" \
  --data-binary @- \
  https://ntfy.example.com/alerts

Bunu bir drop-in dosyası ile servise bağlayın; böylece paket yükseltmeleri yaptığınız düzenlemeyi üzerine yazamaz.

sudo systemctl edit myapp.service
[Unit]
OnFailure=ntfy-unit-failed@%n.service

%n tam birim adına genişletilir, bu nedenle örneklendirilen birim ntfy-unit-failed@myapp.service.service olur ve şablon içindeki %i, myapp.service değerini betiğe ilk argüman olarak iletir. Tek bir şablonun her birime hizmet etmesini sağlayan budur. /etc/systemd/system/ntfy-selftest.service olarak kaydedilen ve kasten başarısız olan bir birimle çalıştığını doğrulayın.

[Unit]
Description=Deliberately failing unit
OnFailure=ntfy-unit-failed@%n.service

[Service]
Type=oneshot
ExecStart=/bin/false
sudo systemctl daemon-reload
sudo systemctl start ntfy-selftest.service

Başlatma komutu sıfır olmayan bir değerle çıkar ve Job for ntfy-selftest.service failed because the control process exited with error code çıktısını verir; telefonunuz yaklaşık bir saniye sonra titremelidir. Test birimini sonrasında silin.

Bir tuzak dikkat gerektirir. OnFailure= yalnızca bir birim failed durumuna ulaştığında çalışır; RestartMode=direct ise otomatik yeniden başlatmalar sırasında bu durumu atlar, dolayısıyla hata işleyiciyi de atlar. Varsayılan RestartMode=normal ayarında, otomatik yeniden başlatmalar başarısız durumundan geçer. StartLimitBurst ve StartLimitIntervalSec, tekrarlanan başlatmaların ne zaman reddedileceğini kontrol eder; bunları, bir çökme döngüsünün sonunda duracak şekilde ayarlayın. Zamanlayıcılar (timers), yukarıdaki cron modelinin daha temiz bir alternatifidir; çünkü bir zamanlayıcının servis birimi aynı OnFailure= drop-in yapısını destekler ve VPS üzerinde systemd servisleri ve zamanlayıcıları rehberi, bir servisin dönüştürülme sürecini adım adım açıklar.

Uptime izleyicisini aynı konuya bağlayın

Kendi kendine barındırılan durum izleyicisi Uptime Kuma, yerleşik bir ntfy bildirim türü ile gelir. Ayarlar (Settings) kısmını açın, ardından Bildirimler (Notifications) ve Bildirim Kurulumu (Setup Notification) yolunu izleyin. Ntfy seçeneğini belirleyin, sunucu URL adresini https://ntfy.example.com olarak ayarlayın ve konuyu alerts olarak girin. Bir öncelik seviyesi seçin ve robot erişim belirtecini (access token) yapıştırın. Kaydetmeden önce test bildirimini gönderin; çünkü hatalı bir konu adı, onu kapsamayan bir write yetkilendirmesi üzerinde hata döndürür.

Bu kurulumun doğal sınırı şudur: Aynı VPS üzerinde çalışan bir izleyici, VPS'in kapandığını size bildiremez; ntfy ise ntfy servisinin çöktüğü bilgisini iletemez. İzleyiciyi farklı bir makinede çalıştırın ve ntfy servisini gözlemleyen izleyici için e-posta gibi ikinci bir bildirim kanalı tanımlayın. Uptime Kuma'nın Push izleyici türü, diğer kör noktayı kapsar: cron işiniz başarılı bir çalışmanın ardından bir push URL adresini tetikler ve Kuma, bu çağrılar kesildiğinde uyarı verir. Hata dalı yalnızca iş çalıştığında tetiklendiği için, hiç başlamayan bir iş hakkında bilgi sağlamaz.

Self-hosted ntfy, Android ve iPhone üzerinde çalışır mı?

Android üzerinde, evet, hiçbir kısıtlama olmaksızın çalışır. Uygulamayı Google Play veya F-Droid üzerinden yükleyin, Ayarlar'ı açın, varsayılan sunucuyu https://ntfy.example.com olarak ayarlayın, kullanıcı yönetimi ekranından hesabınızı ekleyin ve ardından alerts kanalına abone olun. Anlık teslimat, bir ön plan servisini çalışır durumda tutar; böylece telefon uyku modundayken bile mesajlar ulaşır. Bununla birlikte gelen kalıcı bildirim, bir hata değil, Android'in ön plan servisleri için zorunlu kıldığı bir gereksinimdir. F-Droid sürümü hiçbir Firebase kodu içermez, bu nedenle tüm abonelikler anlık teslimat kullanır. ntfy ayrıca, Google'ın push servisine açık bir alternatif olan UnifiedPush dağıtıcısı olarak da görev yapabilir; böylece UnifiedPush destekleyen diğer uygulamalar da mesajlarını sizin sunucunuz üzerinden iletebilir.

Resmi iOS uygulamasında ise, kaldıramayacağınız bir bağımlılıkla çalışır. iOS, arka plana alınan uygulamaları askıya alır. Apple'ın izin verdiği arka plan modları (ses çalma, konum güncellemelerini alma, zamanlanmış görevleri işleme), bir uygulamanın sunucunuzdan mesaj beklemesine olanak tanımaz. Bu nedenle, uygulamanın hızlıca uyanması için APNs (Apple push notification service) üzerinden bir tetikleme gelmesi gerekir. Yalnızca uygulama için yetkilendirilmiş kimlik bilgilerine sahip bir sağlayıcı bildirim gönderebilir; bu yüzden sunucunuzun resmi uygulamaya doğrudan ulaşma yolu yoktur. ntfy bunu bir röle ile çözer: sunucunuz, mesaj kimliğini içeren bir poll_request paketini ntfy.sh adresine gönderir; burası da Firebase ve APNs aracılığıyla uygulamayı uyandırır ve uygulama daha sonra mesaj içeriğini sunucunuzdan çeker.

upstream-base-url: "https://ntfy.sh"

Bunun maliyeti konusunda net olun. Mesaj içeriği sizin sunucunuzda kalır, ancak bir mesajın ulaştığı bilgisi ve mesaj kimliği, sizin yönetmediğiniz bir altyapı üzerinden geçer. Bu ayar olmadan, self-hosted bir sunucudan iPhone'a gelen bildirimler yine de ulaşır ancak ntfy belgeleri, uygulamayı anında uyandıracak bir mekanizma olmadığı için gecikmenin saatleri bulabileceği konusunda uyarır. ntfy.sh rölesi olmadan yerel bir iOS uygulaması kullanmak isterseniz, uygulamayı kendi Apple geliştirici hesabınız ve kendi APNs anahtarlarınızla derleyip yayınlamanız gerekir; bu da yıllık bir ücret ve her güncelleme için yeniden derleme anlamına gelir. Bir diğer yol ise iOS 16.4 veya sonraki sürümlerde ntfy'nin PWA sürümüdür: uygulamayı ana ekrana ekleyin ve sunucunuzda Web Push yapılandırmasını yapın. Bu yöntem ntfy.sh rölesini devre dışı bırakır ancak yine de tarayıcının push altyapısını kullanır. Eğer röle kullanımı sizin için kabul edilemezse, uyarıları Android veya masaüstü web uygulaması üzerinde tutun.

Yedekler, yükseltmeler ve imaj sabitleme

İki yol yeniden oluşturulamaz: /etc/ntfy/server.yml ve /var/lib/ntfy/user.db. İkincisi her kullanıcıyı, parola özetini, ACL girişini ve belirteci tutar, bu yüzden onu özel bir anahtar gibi ele alın.

sudo tar czf ntfy-backup.tgz -C / etc/ntfy var/lib/ntfy
sudo chmod 600 ntfy-backup.tgz

Bu dosyayı sunucudan kopyalayın. cache.db, yukarıdaki cache-duration ile 12 saatlik mesajları ve teslimat için planlanan, teslim edildikten sonra 12 saat boyunca kalan tüm mesajları tutar. Mesajları önceden planlamadığınız sürece, bunu kaybetmenin korunmaya değer bir maliyeti yoktur. Yükseltme yapmak, compose dosyasındaki etiketi düzenlemek, imajı çekmek ve container'ı yeniden oluşturmak anlamına gelir.

sudo docker compose pull
sudo docker compose up -d
curl -s https://ntfy.example.com/v1/health

Önce sürüm notlarını okuyun. SQLite veritabanları başlangıçta göç eder, bu nedenle şema değişikliğinden sonra eski bir etikete geri dönmek güvenli değildir. Örneğin v2.31.1, mesaj önbelleğini şema sürümü 17'ye taşıdı ve yükseltme notları, v2.31.0 veya daha eski bir sürüme düşürmek için bu sürümün manuel olarak 16'ya ayarlanması gerektiğini belirtir. v2.36.0 sürümüne yükseltme, herkesin mevcut günlük sayımlarını bir kez sıfırlar. Yeni sürüm bir gün boyunca çalışana kadar aldığınız yedeği saklayın. Notlar ayrıca davranış değişikliklerini de işaretler. v2.31.0 sürümünden itibaren, since=<message ID> ile yeniden bağlanan bir istemci, aynı saniyede yayınlanan mesajları da alır, bu nedenle kopya görebilir. ntfy uygulamaları ve web uygulaması kopyaları mesaj kimliğine göre eler, ancak bir konuyu tekrar oynatan kendi betiğinizin de aynısını yapması gerekir. Sunucudaki her servisin yeniden oluşturulamayan kısa bir yol listesi vardır ve PhotoPrism ve Immich karşılaştırması, aynı türdeki bir VPS üzerinde bir fotoğraf kütüphanesi için bu listeyi ve beraberindeki yedekleme komutlarını belirler.

Gotify ve Apprise

Gotify daha küçük bir seçenektir: web arayüzüne ve Android uygulamasına sahip tek bir binary dosyasıdır; mesajlar uygulama bazında düzenlenir. Bu yapı, tek hedefin Android olduğu kişisel sunucular için uygundur. Apprise, bir Python kütüphanesi ve komut satırı aracıdır; ayrıca ayrı bir Apprise API sunucusu mevcuttur. Tek bir mesajı ntfy dahil yüzden fazla servise dağıtabilir; bu özellik, aynı anda birden fazla yere ulaşması gereken betikler için uygundur. ntfy, size bir sunucu, HTTP API ve her iki mobil platformda da uygulama sunan çözümdür; bu nedenle kiralanan bir sunucudan bildirim göndermek için genellikle tercih edilen yöntemdir.

FAQ

ntfy sunucuma yayın yaparken neden 403 hatası alıyorum?

auth-default-access: "deny-all" ayarı server.yml içinde aktif olduğunda, anonim yayınlar reddedilir; bu beklenen bir davranıştır. Kimlik bilgilerinizi -u user:pass veya -H "Authorization: Bearer tk_..." ile gönderin. Zaten bir token gönderiyor ve yine de 403 alıyorsanız, kullanıcının ilgili konu (topic) üzerinde yazma izni veren bir ACL kaydına sahip olup olmadığını kontrol edin: eşleşen bir kayıt yoksa, read-only veya deny yayını reddeder. v2.34.0 sürümünde, aynı IP adresinden gelen eşzamanlı istekler, geçerli kimlik bilgilerinin anonim olarak algılanmasına neden olabilir; v2.35.0 bu hatayı giderir, bu nedenle geçici bir 403 hatasını ACL sorunu olarak değerlendirmeden önce sürümünüzü yükseltin. Tam listeyi yazdırmak için ntfy access komutunu çalıştırın. write izninin abone olmayı kapsamadığını unutmayın; bu nedenle yayın yapabilen bir hesap, aynı konuyu okumaya çalıştığında reddedilecektir.

Kendi barındırdığım ntfy sunucusu ile iPhone'da bildirimler çalışır mı?

Resmi iOS uygulamasını kullandığınızda bildirimler bir aktarıcı (relay) üzerinden çalışır. Askıya alınmış bir iPhone uygulamasının hızlıca uyandırılması APNs (Apple push notification service) üzerinden gerçekleşmelidir. Resmi uygulamaya gönderim yapmak, yayıncının push kimlik bilgilerini gerektirir; bu nedenle ntfy, mesaj kimliğini içeren bir poll_request paketini ntfy.sh adresine iletir ve o da cihazınıza aktarır. upstream-base-url: "https://ntfy.sh" ayarını server.yml içinde yapılandırın ve container'ı yeniden başlatın. Mesaj içeriğinin kendisi yine de doğrudan sizin sunucunuzdan çekilir. Bu ayar yapılmadığında iOS bildirimleri yine de ulaşır ancak ntfy belgeleri gecikmenin saatleri bulabileceği konusunda uyarmaktadır. PWA, iOS 16.4 veya sonraki sürümlerde Web Push yapılandırıldığında alternatif bir yöntem sunar.

Cron işimden gelen ntfy uyarısı neden hiç ulaşmadı?

Token ve konu bilgilerinin doğruluğunu kanıtlamak için önce curl satırını manuel olarak çalıştırın. Manuel çalışıyor ancak cron üzerinden çalışmıyorsa, hata uyarının kaynağındadır: cron işleri kısıtlı bir ortam ve kısa bir PATH ile çalıştırır; bu nedenle komutu sadece ismiyle çağıran bir betik, curl satırına ulaşamadan sonlanabilir. Mutlak yolları (absolute paths) kullanın, işin çıktısını bir log dosyasına yönlendirin ve bir sonraki çalıştırmadan sonra bu dosyayı inceleyin. Teslimat yerine 429 yanıtı alınması, bir limitin isteği reddettiği anlamına gelir. Genellikle betik çok hızlı yeniden deneme yapıyordur, ancak yukarıda belirtilen mesaj limiti gibi günlük kotasını doldurmuş bir ziyaretçi, tek bir istekte bulunsa dahi aynı şekilde reddedilir.

ntfy'yi genel internete açmalı mıyım?

Telefon uygulamalarının sunucuya mobil ağlardan erişebilmesi gerekir; bu nedenle auth-default-access: "deny-all" ve konu bazlı ACL'lere sahip genel bir HTTPS uç noktası standart kurulumdur. Hiçbir konu everyone tarafından okunabilir olmadığı sürece bu yapı güvenlidir. Yalnızca VPN üzerinden erişilen bir kurulum, tüm abonelerin kontrolünüz altındaki makineler olduğu durumlar için mantıklıdır. Telefonlar için uygun bir yöntem değildir, çünkü uygulama yalnızca tünel aktifken veri alabilir; bu nedenle uyarılar telefon tekrar bağlanana kadar kuyrukta bekler.

Bu yazı işinize yaradı mı?