İçeriğe geç
KVKK & GDPR Uyumlu Türkiye Veri Merkezi 7/24 Türkçe Teknik Destek destek@mxgate.com.tr
Yeni: IP itibar izleme artık tüm paketlerde ücretsiz 14 gün ücretsiz deneyin →
ENTEGRASYON REHBERİ · cPANEL / WHM

cPanel / WHM Smarthost Kurulumu

WHM’deki Exim Configuration Manager üzerinden üç bölüm tanımlarsınız: yönlendirme, taşıma ve kimlik doğrulama. Bu tanımlardan sonra sunucudan çıkan her e-posta, kimlik doğrulamalı ve şifreli bir bağlantıyla MXGate üzerinden iletilir. Gelen posta ayarlarınıza ve MX kaydınıza dokunulmaz.

Süre
Yaklaşık 10 dakika
Gereksinim
WHM root erişimi
Sürüm
cPanel 92+ · Exim 4.94+
Bağlantı
smtp.mxgate.com.tr · 587 · STARTTLS
Kapsam
Yalnızca giden posta
NE DEĞİŞİYOR

Değişen tek şey postanın çıkış yolu

Bugün cPanel sunucunuz e-postayı alıcının sunucusuna doğrudan gönderiyor; teslim edilip edilmeyeceğini tek başına sunucunuzun IP adresinin sicili belirliyor. Kurulumdan sonra aynı posta önce MXGate’e teslim edilir, orada denetlenir ve itibarı izlenen adreslerden çıkar.

Şu an cPanel / Exim Alıcı sunucu Posta doğrudan çıkar. Teslim edilip edilmeyeceğini yalnızca sunucunuzun IP adresinin sicili belirler.
Kurulumdan sonra cPanel / Exim MXGate :587 Alıcı sunucu Posta önce kimlik doğrulamalı ve şifreli bağlantıyla MXGate’e teslim edilir, denetlenir ve itibarı izlenen adreslerden çıkar.
Posta kutuları, hesaplar ve web sitesi ayarları yerinde kalır Uygulamalarınızın posta gönderme biçimi değişmez Gelen posta için MX kaydı ayrıca yönlendirilir; bu rehber onu kapsamaz Yönteme genel bakış için Smarthost sayfası, giden trafikte denetim için Outbound Filtreleme
KURULUM

Yedi adımda cPanel smarthost kurulumu

Adımlar WHM arayüzünde sırayla uygulanır. Kod bloklarını olduğu gibi kopyalayabilirsiniz; yalnızca beşinci adımdaki kullanıcı adı ve şifre yer tutucularını değiştirmeniz gerekir.

  1. WHM’de Exim Configuration Manager’ı açın

    WHM paneline root kullanıcısıyla girin ve üstteki arama kutusuna “Exim” yazarak Exim Configuration Manager’ı açın.

    WHM YOLU kopyalayın
    Home › Service Configuration › Exim Configuration Manager
  2. Advanced Editor sekmesine geçin ve yedek alın

    Advanced Editor sekmesi Exim yapılandırmasının bölümlerini doğrudan düzenlemenizi sağlar. Değişikliğe başlamadan önce sayfadaki Backup düğmesiyle mevcut yapılandırmanın yedeğini alın.

    Güncellemelerde silinmez: Advanced Editor’de yaptığınız eklemeler /etc/exim.conf.local dosyasında tutulur ve cPanel güncellemelerinde korunur. Ana /etc/exim.conf dosyası her derlemede yeniden üretilir, bu yüzden elle oraya yazmayın.
  3. ROUTERCONFIG: yönlendirme kuralını ekleyin

    ROUTERCONFIG bölümüne aşağıdaki router tanımını ekleyin. Bu tanım, yerel alan adlarına gitmeyen tüm postayı MXGate üzerinden yönlendirir.

    ROUTERCONFIG kopyalayın
    # MXGate smarthost router
    smarthost_router:
      driver = manualroute
      domains = ! +local_domains
      transport = mxgate_smtp
      route_list = * smtp.mxgate.com.tr::587
      no_more
    domains = ! +local_domains satırı, sunucudaki hesaplar arasındaki postanın dışarı çıkmadan yerelde teslim edilmesini sağlar. Bu satırı silmeyin.
  4. TRANSPORTCONFIG: taşıma tanımını ekleyin

    TRANSPORTCONFIG bölümüne, kimlik doğrulama ve TLS zorunluluğunu içeren taşıma tanımını ekleyin.

    TRANSPORTCONFIG kopyalayın
    # MXGate SMTP transport
    mxgate_smtp:
      driver = smtp
      hosts = smtp.mxgate.com.tr
      port = 587
      hosts_require_auth = smtp.mxgate.com.tr
      hosts_require_tls = smtp.mxgate.com.tr
    587 portu STARTTLS ile kullanılır; kimlik bilgileri ve ileti içeriği şifreli iletilir. hosts_require_tls satırı, şifresiz bağlantıya düşmeyi engeller.
  5. AUTH: kimlik doğrulama bilgilerini girin

    AUTH bölümüne, MXGate panelinden aldığınız kullanıcı adı ve şifreyi içeren istemci kimlik doğrulayıcısını ekleyin.

    AUTH kopyalayın
    # MXGate SMTP authentication
    smarthost_login:
      driver = plaintext
      public_name = LOGIN
      client_send = : MXGATE_KULLANICI_ADI : MXGATE_SIFRE
    Dikkat: client_send satırı iki nokta üst üste ile başlamak zorundadır: : kullanıcı : şifre. Yer tutucuların yerine panelden aldığınız gerçek bilgileri yazın; şifreyi tırnak içine almayın.
  6. Kaydedin ve Exim’i yeniden başlatın

    Sayfanın altındaki Save düğmesine basın. WHM yapılandırmayı doğrular, yeniden derler ve Exim’i başlatır. İsterseniz aynı doğrulamayı SSH üzerinden de yapabilirsiniz.

    SSH · DOĞRULAMA kopyalayın
    # Yapılandırmada sözdizimi hatası var mı?
    exim -bV
    
    # Gerekirse yeniden derleyip servisi başlatın
    /scripts/buildeximconf
    /scripts/restartsrv_exim
  7. Bir e-posta gönderip kaydı okuyun

    Sunucudaki bir hesaptan dışarıya e-posta gönderin ve Exim kaydında postanın MXGate üzerinden çıktığını doğrulayın. Kayıtta router adını görüyorsanız kurulum çalışıyor demektir.

    TEST · KAYIT kopyalayın
    # Kuyruğu ve canlı kaydı izleyin
    exim -bp
    tail -f /var/log/exim_mainlog
    
    # Kayıtta görmeniz gereken satır
    => kullanici@ornek.com R=smarthost_router T=mxgate_smtp
    Kurulum tamam. Bu satırı gördüğünüzde sunucudan çıkan tüm posta kimlik doğrulamalı ve şifreli olarak MXGate üzerinden gidiyor demektir.
SORUN GİDERME

Exim kaydında gördüğünüz hata ne anlama geliyor?

Aşağıdaki beş satır, cPanel smarthost kurulumundan sonra karşılaşılan hataların neredeyse tamamını kapsar. Kaydınızdaki metni soldaki sütunda arayın.

Kayıttaki hata Ne anlama gelir Çözüm
535 Authentication failed Kullanıcı adı veya şifre kabul edilmedi AUTH bölümündeki client_send satırının baştaki iki nokta ile başladığını doğrulayın ve bilgileri panelden yeniden kopyalayın. Şifrede tırnak veya boşluk bulunmamalı.
Connection refused / timed out 587 portuna çıkış engelleniyor Sunucu güvenlik duvarında ve sağlayıcınızın ağında giden 587 portuna izin verin. Bazı barındırma ağları bu portu varsayılan olarak kapatır.
TLS required but not supported Şifreli bağlantı kurulamadı TRANSPORTCONFIG bölümünde hosts_require_tls satırının bulunduğunu ve sunucudaki OpenSSL paketlerinin güncel olduğunu doğrulayın.
Posta yerelde kalıyor Router okunmuyor veya sıralama yanlış ROUTERCONFIG bölümüne smarthost_router tanımının eklendiğini ve girintilerin iki boşluk olduğunu kontrol edin. Exim girinti hatasında tanımı sessizce atlar.
Hesaplar arası posta da dışarı çıkıyor domains koşulu eksik Router’da domains = ! +local_domains satırının bulunduğunu doğrulayın. Bu satır olmadan sunucudaki hesaplar arasındaki posta da dışarıya yönlendirilir.

Geri dönüş

Kurulumdan vazgeçmek isterseniz Advanced Editor’de eklediğiniz üç bölümü kaldırıp kaydetmeniz yeterli. Yedeği geri yüklemek de aynı sonucu verir; yapılandırma yeniden derlendiğinde sunucu postayı önceki gibi doğrudan göndermeye döner.

SSH · GERİ DÖNÜŞ isteğe bağlı
# Yerel yapılandırmayı yedekleyip düzenleyin
cp /etc/exim.conf.local /etc/exim.conf.local.mxgate-bak

# Yapılandırmayı yeniden derleyip servisi başlatın
/scripts/buildeximconf
/scripts/restartsrv_exim
SIK SORULAN SORULAR

Sunucu yöneticilerinden gelen sorular

Bu kurulum gelen e-postaları etkiler mi?

Hayır. Yapılandırma yalnızca sunucudan çıkan postanın hangi yoldan gideceğini değiştirir. MX kayıtlarınız, posta kutularınız ve gelen posta ayarlarınız olduğu gibi kalır. Gelen tarafı da MXGate üzerinden geçirmek isterseniz bu ayrı bir adımdır ve MX kaydı üzerinden yapılır.

cPanel güncellemesi bu ayarları siler mi?

Hayır. Advanced Editor’de girdiğiniz bölümler /etc/exim.conf.local dosyasında saklanır ve güncellemelerde korunur. Silinen dosya, her derlemede yeniden üretilen /etc/exim.conf dosyasıdır; bu yüzden yapılandırmayı elle o dosyaya yazmamak gerekir.

Sunucudaki her hesap için ayrı kimlik bilgisi gerekiyor mu?

Hayır. Sunucu düzeyinde tek bir kimlik yeterlidir; tüm hesapların postası aynı bağlantıdan çıkar. Buna karşın panelde raporlama alan adı ve gönderen bazında ayrılır, dolayısıyla hangi hesabın ne gönderdiğini tek kimlikle de görebilirsiniz.

Kaydetme sırasında e-posta kesintisi olur mu?

Exim yeniden başlatılırken birkaç saniyelik bir duraklama olur. Bu sırada gelen bağlantılar yeniden denenir, kuyruktaki iletiler kaybolmaz. Yine de değişikliği yoğun gönderim saatleri dışında yapmak en iyisidir.

Kurulumdan geri dönebilir miyiz?

Evet. Advanced Editor’de eklediğiniz üç bölümü kaldırıp kaydetmeniz veya kurulum öncesi aldığınız yedeği geri yüklemeniz yeterlidir. Yapılandırma yeniden derlendiğinde sunucu, postayı önceki gibi doğrudan göndermeye döner.

Son güncelleme: · Geçerli sürümler: cPanel 92 ve üzeri · Exim 4.94+