Kurulum
DeepFilter kurulumu tek komutla yapılır. Kurulum script'i sunucunuzu denetler, gerekli paket depolarını tanımlar ve ürünün tüm bileşenlerini kurar. Bu sayfa kurulum öncesi kontrol listesini, kurulum komutunu, kurulum sonrası erişim adreslerini ve kurulumun durduğu durumlarda ne yapmanız gerektiğini anlatır.
Kurulum Öncesi Kontrol Listesi
Kuruluma başlamadan önce aşağıdaki maddelerin tamamının sağlandığından emin olun. Bu maddelerin bir kısmı kurulum script'i tarafından otomatik denetlenir ve sağlanmıyorsa kurulum durur.
| Konu | Gereksinim | Sağlanmazsa |
|---|---|---|
| İşletim sistemi | Rocky Linux 9 Minimal, x86_64 | Kurulum durur |
| Mimari | Yalnızca x86_64 (ARM desteklenmez) | Kurulum durur |
| Erişim | Root kullanıcısı | Kurulum yapılamaz |
| Disk | En az 100 GB önerilir; 50 GB altında kurulum yapılmaz | 50 GB altında kurulum durur |
| vCPU | En az 4 (toplam mantıksal işlemci) | Uyarı verir, devam eder |
| RAM | En az 8 GB | Uyarı verir, devam eder |
| Sistem saati | Senkron olmalı | Sapma varsa kurulum durur |
| DNS | Çalışan bir ad çözücü | Kurulum tamamlanamaz |
| Güvenlik duvarı | firewalld kurulu ve çalışır durumda | Port kuralları yazılamaz |
| İnternet | Paket depolarına erişim şart | Kurulum tamamlanamaz |
İşletim sistemi kurulumunda Minimal Install seçeneğini kullanın. Masaüstü ortamı veya sunucu rolleri içeren tam kurulumlarda önceden gelen servisler DeepFilter'ın kullandığı portları tutabilir. Kurulum bu durumu tespit ettiğinde uyarı verir ancak durmaz; çakışan servisin kapatılması yöneticiye kalır. Ayrıntılar için Sistem Gereksinimleri sayfasına bakın.
Disk hesabında günlük e-posta hacmini de dikkate alın. Yıllık log saklama için günlük her 10.000 e-posta başına 100 GB'ın üzerine 50 GB ekleyin. Örneğin günde 30.000 e-posta işleyecek bir sunucuda 250 GB disk hedefleyin.
Kurulum internet bağlantısı gerektirir. Paketler beş ayrı uzak depodan indirilir. İnternet erişimi olmayan (air-gapped) bir sunucuya kurulum yapılamaz.
Ağ tarafında açılması gereken portlar ve dışarı çıkması gereken bağlantılar için Ağ Gereksinimleri sayfasına bakın.
Tek Komutla Kurulum
Sunucuya root olarak bağlanın ve aşağıdaki komutu çalıştırın:
curl -s https://central.deepfilter.io/repo/packages/install.sh -o /tmp/install.sh && bash /tmp/install.sh
Komut önce kurulum script'ini indirir, ardından çalıştırır. Script çalıştığı sırada
sunucudan ayrılmayın; oturum kopmasına karşı screen veya tmux içinde çalıştırmanız
önerilir.
Sunucuda halihazırda bir DeepFilter kurulumu varsa script kurulumu başlatmaz ve sizi uyarır. Var olan bir kurulumu yükseltmek için aşağıdaki Güncelleme bölümüne bakın.
Kurulum Ne Yapar
Script sırasıyla şu işleri yürütür:
- Sunucunun işletim sistemi, mimari, disk, CPU, RAM ve saat senkronu denetimlerini yapar.
- Gerekli paket depolarını sunucuya tanımlar.
- DeepFilter'ın 7 modüler paketini ve bağımlılıklarını indirip kurar.
- Servisleri başlatır ve güvenlik duvarı kurallarını yazar.
- Yönetim paneli için geçici, kendinden imzalı bir sertifika üretir.
Kurulan bileşenler ve görevleri:
| Bileşen | Görevi |
|---|---|
| E-posta aktarım servisi | E-posta alımı ve teslimi |
| Tarama motoru | Spam, kimlik doğrulama ve itibar denetimi |
| Antivirüs motoru | Zararlı yazılım taraması |
| Uygulama veritabanı | Ayarlar, kullanıcılar, karantina kayıtları |
| Analitik veritabanı | E-posta trafiği analitiği |
| Önbellek ve kuyruk servisi | Hızlı erişimli veri ve iş kuyruğu |
| Yerel DNS çözücü | İtibar, SPF ve MX sorgularının çözümü |
| Yönetim API'si ve arka plan görevleri | Panelin arkasındaki servisler |
| Yapay zekâ değerlendirme servisi | Yapay öğrenme tabanlı sınıflandırma |
| Web sunucusu (ters vekil) ve web arayüzü | Yönetim paneli ve son kullanıcı portalı |
Kurulum süresi sunucunun internet hızına ve disk performansına göre değişir. İndirilen paket hacmi nedeniyle kurulumun onlarca dakika sürmesi normaldir.
Kurulum Sonrası İlk Erişim
Kurulum tamamlandığında iki adres kullanıma hazırdır:
| Adres | Ne için |
|---|---|
https://<SUNUCU_IP>:9443/setup | Yönetim paneli — kurulum sihirbazı buradan başlar |
https://<SUNUCU_IP>:9445 | Son kullanıcı portalı |
<SUNUCU_IP> yerine sunucunuzun IP adresini yazın. İlk açılışta tarayıcı sertifika
uyarısı gösterir; bu beklenen bir durumdur çünkü sistem henüz kendinden imzalı sertifika
kullanmaktadır. Uyarıyı kabul edip devam edin.
Port 443 kullanılmaz. Yönetim paneline https://sunucu-adresi şeklinde port belirtmeden
erişmeye çalışırsanız bağlantı kurulamaz. Port numarasını yazmayı unutmayın.
Sihirbazı tamamlamadan önce elinizde lisans anahtarınızın ve sunucuya vereceğiniz tam
alan adının (örneğin mail.alanadi.com) hazır olması gerekir.
Güncelleme
Kurulu bir sistemi yeni sürüme yükseltmek için kurulum script'ini tekrar çalıştırmayın. Bunun yerine sunucuda şu komutu kullanın:
dnf update deepfilter-*
Komut tüm DeepFilter paketlerini günceller ve etkilenen servisleri yeniden başlatır. Güncelleme sırasında e-posta akışında kısa bir kesinti olabilir; yoğun olmayan bir saat seçmeniz önerilir.
Kurulum Durursa
Kurulum script'i belirli koşullarda tasarım gereği durur. En sık karşılaşılan sebepler ve çözümleri aşağıdadır.
Sistem saati sapması
Saat sapması sertifika doğrulamasını bozduğu için kurulum durdurulur. Sunucuda saat senkronizasyonunu kontrol edin ve etkinleştirin:
timedatectl status
timedatectl set-ntp true
System clock synchronized: yes görene kadar bekleyin, ardından kurulumu tekrar
başlatın. Sunucunun dışarı 123/UDP (NTP) çıkışının açık olması gerekir.
Disk alanı 50 GB'ın altında
Kurulum durur. Diski büyütün veya yeterli boş alana sahip bir sunucu kullanın. Mevcut durumu görmek için:
df -h /
İşletim sistemi uyumsuz
Rocky Linux 9 dışında bir dağıtımda veya farklı bir major sürümde kurulum durur. ARM mimarisi desteklenmez. Sürümünüzü doğrulayın:
cat /etc/rocky-release
uname -m
Çıktı Rocky Linux 9 ve x86_64 olmalıdır. Farklıysa sunucuyu uygun sürümle yeniden
kurmanız gerekir.
vCPU veya RAM yetersiz
Kurulum durmaz, yalnızca uyarı verir ve devam eder. Ancak yetersiz kaynakla çalışan bir sunucuda tarama gecikmeleri yaşanır. Uyarı aldıysanız vCPU ile RAM'i birlikte artırmayı planlayın; RAM tek başına düşük kalırsa eşzamanlı işleyici sayısı da düşük kalır. Boyutlandırma için Sistem Gereksinimleri sayfasına bakın.
Paket indirme hatası
Sunucunun internet erişimini ve DNS çözümlemesini kontrol edin. Kurulum sırasında dışarı 443/tcp ve 53 (UDP/TCP) erişimi açık olmalıdır. Bağlantıyı doğruladıktan sonra kurulum komutunu tekrar çalıştırabilirsiniz.
Kurulum başarıyla tamamlandıktan sonraki adım, yönetim panelindeki dört adımlık kurulum sihirbazını tamamlamaktır: Lisans, Yönetici Hesabı, Sunucu Adı ve Tamamla.