MailGuard Dokümantasyon

Kurulum kılavuzları

Aşağıdaki adımlar gerçek yapılandırma değerleridir. Hesabınız açıldığında domaininize özel DKIM kaydı ve kimlik bilgileri size iletilir; geri kalanı burada anlatıldığı gibidir.

Giden posta için önce SPF ve DKIM kayıtlarını ekleyip sunucunuzu smarthost olarak MailGuard'a yönlendirin; gelen filtreleme için MX kaydınızı bize çevirin. İkisini aynı anda yapmanız gerekmez.

1. DNS kayıtları

Giden posta için SPF ve DKIM, gelen posta için MX kaydı gerekir. Hepsini aynı anda uygulamanız gerekmez — önce giden, sonra gelen tarafa geçebilirsiniz.

SPF — mevcut kaydınıza ekleyin

Zaten bir SPF kaydınız varsa yeni bir kayıt oluşturmayın; bir domainde yalnızca tek SPF kaydı bulunabilir. Mevcut kaydın içine include ekleyin:

; ONCE
sizindomain.com.  TXT  "v=spf1 a mx ~all"

; SONRA
sizindomain.com.  TXT  "v=spf1 a mx include:spf.mailguard.com.tr ~all"

DKIM — tek CNAME

Anahtar çiftini biz üretiriz; siz yalnızca aşağıdaki CNAME'i eklersiniz. Anahtar yenilemesi gerektiğinde DNS'inize tekrar dokunmanız gerekmez.

mailguard._domainkey.sizindomain.com.  CNAME  mailguard.sizindomain-com.dkim.mailguard.com.tr.

DMARC — öneri

SPF ve DKIM oturduktan sonra izleme moduyla başlayın, rapor akışı sağlıklıysa sıkılaştırın:

_dmarc.sizindomain.com.  TXT  "v=DMARC1; p=none; rua=mailto:dmarc@sizindomain.com"

MX — yalnızca gelen filtreleme kullanacaksanız

sizindomain.com.  MX  10  mx01.mailguard.com.tr.
sizindomain.com.  MX  20  mx02.mailguard.com.tr.

2. cPanel / WHM

En kolay yol MailGuard cPanel/WHM eklentisidir: Exim yönlendirmesini tek tıkla yapar, bağlantıyı test eder ve gerektiğinde geri alır. Eklenti yerine elle kurulum için aşağıdaki manuel adımları kullanabilirsiniz. Her iki yolda da MailGuard DKIM'i sizin adınıza imzalar.

MailGuard Eklentisi en kolay

Eklenti WHM'de root'a, cPanel'de son kullanıcıya kendi domainlerinin giden/gelen istatistik ve maillog'larıyla görünür. Kurulum — WHM sunucusunda root SSH ile:

curl -sSL https://mailguard.com.tr/cpanel/install.sh | sh

Ardından WHM › Plugins › MailGuard:

1. Panelden aldığınız SMTP kimliğini (kullanıcı adı + parola) girin.
2. Bağlantıyı Test Et — 587/TLS + AUTH doğrulanır.
3. Uygula — Exim smarthost yönlendirmesi yazılır; mevcut yapılandırma otomatik yedeklenir.
4. Sorun olursa Geri Al — önceki Exim yapılandırması tek tıkla döner.

rootsunucu.example.comAlmaLinux 10WHM 136.0

Search Tools and Accounts (/)

outbound relay active

Route your cPanel/WHM server's outbound mail through MailGuard — authenticated (SASL); DKIM is signed for you.

Connection settings

Relay host

relay.mailguard.com.tr

Port

587

SMTP username

smtp-1@relay.mailguard.com.tr

SMTP password

••••••••••••

Test ConnectionSaveApply (outbound relay)Roll back

842

Outbound — delivered (861 total)

217

Inbound — accepted (233 total)

Recent messages

Search domain, recipient, status…

Time	Dir	Domain	Recipient	Status
2026-07-25 22:08	out	acme.com.tr	info@musteri.com	sent
2026-07-25 21:54	in	acme.com.tr	destek@acme.com.tr	delivered
2026-07-25 21:39	out	ornekfirma.com	bulten@liste.net	bounced

Manuel kurulum (eklentisiz)

WHM › Service Configuration › Exim Configuration Manager › Advanced Editor. Değişiklikten önce mevcut yapılandırmayı dışa aktarın (yedekleyin).

Yöntem A — SMTP kullanıcısı (önerilen)

Kullanıcı adı + parolanızı panelden SMTP Kimliği sayfasından alın. @AUTHSTART@ kısmına:

mailguard_login:
  driver = plaintext
  public_name = LOGIN
  client_send = : KULLANICI_ADI : PAROLA

@TRANSPORTSTART@ kısmına:

mailguard_smtp:
  driver = smtp
  port = 587
  hosts_require_auth = *
  hosts_require_tls = true

@ROUTERSTART@ kısmına:

mailguard_smarthost:
  driver = manualroute
  domains = !+local_domains
  transport = mailguard_smtp
  route_list = * relay.mailguard.com.tr::587
  no_more

Yöntem B — IP yetkilendirme (alternatif)

Sabit IP'li sunucularda parola yerine IP yetkilendirme kullanabilirsiniz: IP adres(ler)inizi bize bildirin, @AUTHSTART@ bölümü ve hosts_require_auth satırı gerekmez; transport'ta port 25, route relay.mailguard.com.tr::25 olur.

3. Plesk

Tools & Settings › Mail Server Settings › Relaying bölümünde giden postayı bize yönlendirin:

• "Use the specified outgoing SMTP server" seçeneğini işaretleyin
• Sunucu: relay.mailguard.com.tr — Port: 587
• IP yetkilendirme kullanıyorsanız kimlik doğrulamayı boş bırakın; aksi halde kullanıcı adı ve parolayı girin

Postfix tabanlı Plesk kurulumlarında aynı ayarı komut satırından da yapabilirsiniz:

postconf -e 'relayhost = [relay.mailguard.com.tr]:587'
postconf -e 'smtp_tls_security_level = encrypt'
systemctl reload postfix

4. SmarterMail

Settings › Gateways / Outbound Gateways bölümünden yeni bir çıkış geçidi tanımlayın:

• Adres: relay.mailguard.com.tr, port 587
• "Enable SMTP authentication" seçeneğini kimlik bilgileriyle işaretleyin (IP yetkilendirme kullanıyorsanız kapalı bırakın)
• TLS/SSL zorunlu olarak işaretlenmelidir

5. Microsoft Exchange

Yeni bir Send Connector oluşturun:

• Type: Internet, Address space: *
• "Route mail through smart hosts" → relay.mailguard.com.tr
• Smart host authentication: Basic authentication over TLS (IP yetkilendirme kullanıyorsanız None)
• Port 587, TLS etkin

PowerShell ile:

New-SendConnector -Name "MailGuard" -Internet -AddressSpaces "*" `
  -SmartHosts "relay.mailguard.com.tr" -Port 587 `
  -SmartHostAuthMechanism BasicAuthRequireTLS `
  -AuthenticationCredential (Get-Credential)

6. Postfix (bağımsız sunucu)

postconf -e 'relayhost = [relay.mailguard.com.tr]:587'
postconf -e 'smtp_sasl_auth_enable = yes'
postconf -e 'smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd'
postconf -e 'smtp_sasl_security_options = noanonymous'
postconf -e 'smtp_tls_security_level = encrypt'

echo '[relay.mailguard.com.tr]:587 KULLANICI:PAROLA' > /etc/postfix/sasl_passwd
postmap /etc/postfix/sasl_passwd
chmod 600 /etc/postfix/sasl_passwd*
systemctl reload postfix

IP yetkilendirme kullanıyorsanız smtp_sasl_* satırlarına gerek yoktur; yalnızca relayhost ve TLS ayarı yeterlidir.

7. Gelen filtreleme kurulumu

1. Domaininizi bize tanımlatın ve teslim edilecek sunucu adresini bildirin.
2. MX kayıtlarınızı mx01 / mx02 olarak değiştirin (yukarıda).
3. Kendi sunucunuzda bizim MX adreslerimizi güvenilir listeye ekleyin; aksi halde kendi filtreniz bizim IP'lerimizi puanlayabilir.
4. Sunucunuzun 25. portunu yalnızca bizim MX IP adreslerimize açın.

8. REST API

SMTP yerine HTTP üzerinden gönderim yapabilirsiniz. Aynı filtre ve imzalama hattından geçer.

curl -X POST https://api.mailguard.com.tr/v1/send \
  -H "Authorization: Bearer API_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "siparis@sizindomain.com",
    "to": ["musteri@ornek.com"],
    "subject": "Siparişiniz hazırlanıyor",
    "text": "Merhaba, siparişiniz alındı.",
    "html": "<p>Merhaba, siparişiniz alındı.</p>"
  }'

Webhook'lar

Teslim, erteleme, bounce ve şikayet olayları için webhook adresi tanımlayabilirsiniz. API anahtarları panelden üretilir ve istenirse IP kısıtı uygulanır.

API ve panel şu anda sınırlı erişimle çalışıyor. Erişim için bizimle iletişime geçin.

9. Sorun giderme

Çözemediğiniz bir durumda mesajın Message-ID değerini veya gönderim zamanını iletin; ilgili SMTP oturumunun tam dökümünü çıkarabiliyoruz.