İçeriğe atla
NETMETRİKDokümantasyon

DokümantasyonLinux kurulumu (NETMETRİK Server)

Linux kurulumu (NETMETRİK Server)

NETMETRİK Server, tek bir çalıştırılabilir dosya ile bir yapılandırma dosyasından oluşan hafif bir ölçüm sunucusudur. Kurulum tek satırlık komutla uçtan uca otomatiktir: sistem denetimleri, kayıt, DNS doğrulaması, TLS sertifikası (Let's Encrypt), kapasite ayarı, systemd servisi ve sağlık denetimi — hepsi betiğin işidir.

Son güncelleme: 14 Temmuz 2026
Önce sunucu kaydı
Kurulum komutu, portalda onaya girmemiş bir sunucu kaydı için üretilir. Henüz eklemediyseniz önce sunucu ekleme ve onay sürecini izleyin.

Desteklenen platformlar: Linux (x86_64, aarch64), macOS ve FreeBSD. Kurulum için curl veya wget ile sha256sum/shasum yeterlidir.

Kurulum

  1. Sunucu satırından kurulum komutunu alın

    Portalda Sunucular listesinde sunucunuzun satırını açın ve Kurulum komutu al'a tıklayın. Komut, tek kullanımlık ve 24 saat geçerli bir kurulum anahtarı içerir.

  2. Komutu sunucunuzda çalıştırın

    Root (veya sudo yetkili) bir kullanıcıyla:

    Terminal
    curl -fsSL https://install.netmetrik.com/netmetrikserver.sh | sh -s -- \
  install --lang tr --token <ANAHTAR>

    Sunucunuzda curl kurulu değilse (Debian minimal kurulumları ve Alpine genelde curl olmadan gelir) aynı kurulumu wget ile yapabilirsiniz:

    Terminal
    wget -q -O - https://install.netmetrik.com/netmetrikserver.sh | sh -s -- \
  install --lang tr --token <ANAHTAR>

    Alpine kullanıyorsanız HTTPS için sertifika deposu gerekir: apk add ca-certificates. Betik indirildikten sonra kalan indirmeleri sistemde hangisi varsa onunla yapar (curl, wget veya fetch); hiçbiri yoksa ilk adımda uyarıp durur.

    Betik 7 adımı uçtan uca yürütür ve her adımı ekranda gösterir:

    • Sistem denetimleri — araçlar, saat eşitlemesi, 443/80 portları, güvenlik duvarı (kural ekleme onayınızla), disk, Let's Encrypt erişimi,
    • paketi indirir ve SHA-256 özetini doğrular (kurulum dizini otomatik /opt/netmetrik),
    • sunucunuzu kaydeder; sunucu kimliğini NetmetrikServer.properties dosyasına yazar,
    • DNS'i doğrular — A kaydı sunucuyu göstermiyorsa net talimatla durur, hiçbir şey bozulmaz,
    • hattınıza göre kapasite/çekirdek ayarı önerir (onayınızla uygular; BBR için ayrı onay),
    • systemd servisini kurar (dedike kullanıcı, açılışta otomatik) ve başlatır,
    • TLS sertifikasını Let's Encrypt'ten otomatik alır ve sağlık denetimiyle bitirir: "✅ SUNUCUNUZ CANLI".

    Sonunda yapılanların özeti ekrana ve kurulum-raporu.txt dosyasına, ham kayıt kurulum.log dosyasına yazılır. Sorusuz tam otomatik kurulum için komuta --force --accept-terms ekleyin (sessiz kurulum, hizmet şartlarının açıkça kabulünü gerektirir).

  3. Sonucu doğrulayın

    Kurulum sonrası dilediğiniz an sağlık denetimini yeniden çalıştırabilirsiniz:

    Terminal
    /opt/netmetrik/netmetrikserver.sh selftest

    Tarayıcıdan https://alanadiniz/ açıldığında NetmetrikServer karşılama sayfasını geçerli (yeşil kilitli) sertifikayla görmelisiniz.

Zaten kurulu sunucuyu kaydetme (yeniden ekleme)

Makinede NetmetrikServer zaten kuruluysa — örneğin bir sunucuyu platformdan kaldırıp yeni bir başvuruyla geri ekliyorsanız — kurulumu baştan yapmayın. Yalnız kayıt yeterlidir; mevcut kurulumu yeni anahtarla yeni başvurunuza bağlar:

Terminal
curl -fsSL https://install.netmetrik.com/netmetrikserver.sh | sh -s -- \
  register --lang tr --token <ANAHTAR>

Önceki kurulumdan yönetim betiği makinede duruyorsa doğrudan da çalıştırabilirsiniz: /opt/netmetrik/netmetrikserver.sh register --token <ANAHTAR>. Kayıt başarılı olduğunda betik, systemd servisi kurulu değilse kurup başlatmayı da önerir. Not: yeniden eklenen sunucu platformda yeni bir kayıttır— bu kayıt komutu çalışana kadar panel, yazılım kurulu olsa bile "bu başvuruya bağlı kurulum yok" gösterir; çünkü mevcut kurulum hâlâ emekliye ayrılan eski kayda bağlıdır.

TLS tamamen otomatiktir
Sertifika kurulumda Let's Encrypt'ten alınır ve süresi dolmadan otomatik yenilenir — certbot ya da elle sertifika gerekmez. İstisnalar: kendi sertifikanızı kullanmak isterseniz server.tls.cert/server.tls.keyyollarını girin (öncelik ondadır); TLS'i nginx/Caddy/Cloudflare sonlandırıyorsa betik bunu kendisi algılar ve onayınızla server.plainHTTP = true moduna geçer.

Yapılandırma anahtarları

NetmetrikServer.properties içindeki en sık kullanılan anahtarlar. Diğer anahtarlar (hız sınırlama, güvenilen vekiller, origin listesi) dosyada açıklamalı olarak belgelenmiştir; varsayılanlar üretim için uygundur.

AnahtarAçıklama
server.hostnameKayıtlı alan adı — betik otomatik yazar; elle değiştirmeyin.
server.controlPlaneTokenBu sunucuya özel heartbeat anahtarı — betik otomatik yazar; paylaşmayın.
server.listenDinleme adresi — kurulum otomatik ayarlar (:443 üretim TLS, :8080 ters vekil arkası).
server.autoTLSOtomatik sertifika (Let's Encrypt) — varsayılan enabled; manuel sertifika yolları girilirse devre dışı kalır.
server.acmeEmailSertifika bildirimleri için e-posta (önerilir, zorunlu değil).
server.socketBufferTCP buffer ayarı: auto (hattınıza göre hesaplanır, varsayılan) / off / bayt değeri. Eş zamanlılık üst sınırı da donanımdan otomatik türetilir.
server.heartbeatIntervalDurum sinyali aralığı, saniye (varsayılan 30).
server.logFileGünlük dosyası ve dönüşüm sıklığı (server.logRotation).
Kimlik anahtarını koruyun
server.controlPlaneToken yalnızca bu sunucuyu tanımlar. Başka bir makineye kopyalamayın; her sunucu kendi kurulum komutuyla kendi anahtarını almalıdır.

Yönetim komutları

Kurulum betiği aynı zamanda yönetim aracıdır. Komutlar kurulum dizinini systemd kaydından kendileri bulur; yine de cd /opt/netmetrik içinden çalıştırmak en temizidir:

Komutİşlev
/opt/netmetrik/netmetrikserver.sh statusÇalışma durumu ve sürüm
/opt/netmetrik/netmetrikserver.sh selftestSağlık denetimi: süreç + genel HTTPS + sertifika
/opt/netmetrik/netmetrikserver.sh checkdnsAlan adının A/AAAA kaydını doğrular
/opt/netmetrik/netmetrikserver.sh preflightSistem denetimlerini yeniden çalıştırır
/opt/netmetrik/netmetrikserver.sh tuneKapasite denetimi + çekirdek ayarı (yeniden çalıştırılabilir)
/opt/netmetrik/netmetrikserver.sh restartYeniden başlat (systemd'li kurulumda systemd üzerinden)
/opt/netmetrik/netmetrikserver.sh updateYeni sürüme güncelle (başarısız olursa otomatik geri dönüş)
/opt/netmetrik/netmetrikserver.sh autoupdate-offOtomatik güncellemeyi kapat (kurulumda varsayılan açıktır; açmak: autoupdate-on)
/opt/netmetrik/netmetrikserver.sh installYeniden kur (ayarlar korunur; ikili de güncellenir)
/opt/netmetrik/netmetrikserver.sh service-removesystemd servisini kaldır (dosyalar yerinde kalır)
/opt/netmetrik/netmetrikserver.sh uninstallDurdur ve tamamen kaldır (çekirdek ayarı geri alınır)

Güncelleme

Güncellemeler varsayılan olarak otomatiktir: kurulum, günde bir kez rastgele saatte denetleyen bir zamanlayıcı kurar; güncelleme başarısız olursa önceki sürüme kendiliğinden dönülür. Normalde hiçbir şey yapmanız gerekmez. Elle denetleyip güncellemek için:

Terminal
/opt/netmetrik/netmetrikserver.sh update

Vazgeçmek için kurulumda --no-autoupdate kullanın ya da sonradan /opt/netmetrik/netmetrikserver.sh autoupdate-off çalıştırın (yeniden açmak: autoupdate-on). Kurulum komutunu yeniden çalıştırmak da ayarları koruyarak ikiliyi günceller.

Doğrulama ve kayıtlar

  • /opt/netmetrik/netmetrikserver.sh selftest — süreç, genel HTTPS erişimi ve sertifikayı tek komutla sınar.
  • Portalda Sunucular listesinde Sağlık sütunu ilk sinyalle Çalışıyor gösterir.
  • Kayıtlar: özet kurulum-raporu.txt, ham kurulum kaydı kurulum.log, servis logları journalctl -u netmetrikserver.
Kurulum bir adımda durdu mu?
Betik durduğu adımda nedenini ve çözüm komutunu ekrana yazar (en yaygın: DNS kaydı henüz yayılmamıştır — betik tam A-kaydı talimatı verir ve aynı komutla kaldığı yerden devam edilir). Ayrıntı için kurulum.log ve SSS'deki sorun giderme bölümüne bakın.