MailLandDocs
Alan Adları

DNS Yapılandırması

Gönderim alan adınız için SPF, DKIM ve DMARC kayıtlarını yapılandırın

Bir alan adı ekledikten sonra, e-posta kimlik doğrulaması için gerekli DNS kayıtlarını yapılandırın. MailLand, SPF, DKIM ve DMARC kayıtlarını gerektirir; gönderim yapabilmeniz için üçünün de doğrulanması gerekir. Özel dönüş yolu (geri dönüş) kaydı alan adı doğrulamasının parçasıdır ve yeni alan adları için varsayılan olarak açıktır; gönderimi engellemez ve doğrulanana kadar MailLand varsayılan Return-Path adresini kullanır. İzleme alan adı isteğe bağlıdır.

DNS Talimatlarını Alın

Alan adınız için tam kayıtları alın:

GET https://api.mail.land/v1/domains/{id}/dns-instructions

Authorization: Bearer <token> veya X-API-Key: <api key> ile kimlik doğrulaması yapın.

Get DNS instructions
curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/dns-instructions \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
DNS instructions response
{
  "domain": "yourdomain.com",
  "spfRecord": {
    "recordType": "TXT",
    "hostName": "@",
    "value": "v=spf1 include:spf.mlnd.net ~all",
    "status": "pending",
    "instructions": "Add this TXT record to your domain's root. If you have an existing SPF record, add 'include:spf.mlnd.net' to it instead of creating a new record."
  },
  "dkimRecord": {
    "recordType": "TXT",
    "hostName": "mlnd._domainkey",
    "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkq...",
    "status": "pending",
    "instructions": "Add this TXT record with hostname 'mlnd._domainkey' to enable DKIM signing."
  },
  "dmarcRecord": {
    "recordType": "TXT",
    "hostName": "_dmarc",
    "value": "v=DMARC1; p=quarantine; pct=100; adkim=r; aspf=r; rua=mailto:[email protected]; sp=none",
    "status": "pending",
    "instructions": "Add this TXT record at the '_dmarc' subdomain to enable DMARC policy. The rua tag sends aggregate reports to a MailLand address. MailLand stores the reports for this domain for your plan's retention period and makes their DMARC pass rate, sending sources and dispositions available through the API (GET /v1/domains/{id}/dmarc/summary and /dmarc/sources). To also receive the reports yourself, add your own address to the rua tag."
  },
  "trackingRecord": {
    "recordType": "CNAME",
    "hostName": "track",
    "value": "track.mlnd.net",
    "status": "pending",
    "instructions": "Custom Tracking Links"
  },
  "bounceRecords": [
    {
      "recordType": "CNAME",
      "hostName": "bounce",
      "value": "bounce.mlnd.net",
      "status": "pending",
      "instructions": "Bounce Domain (Return-Path) DNS-only (not proxied): a proxied record hides the CNAME from mail servers."
    }
  ],
  "notes": [
    "DNS changes can take up to 48 hours to propagate globally.",
    "After adding records, click 'Verify Domain' to check the configuration.",
    "All three records (SPF, DKIM, DMARC) must be verified to start sending emails.",
    "Use your DNS provider's documentation for specific instructions on adding TXT records."
  ]
}

Her kayıt, DNS'te tespit edilip edilmediğini belirten bir status alanı içerir:

DurumAçıklama
pendingHenüz kontrol edilmedi
validKayıt bulundu ve doğru
invalidKayıt yok veya hatalı

trackingRecord yalnızca özel izleme alan adı açıkken, bounceRecords ise yalnızca özel geri dönüş alan adı açıkken döner.

İzleme ve geri dönüş kayıtları, başarısız bir kontrolden sonra bile doğrulanana kadar pending gösterir.

Zorunlu Kayıtlar

SPF (Gönderen Politikası Çerçevesi)

SPF, MailLand sunucularının alan adınız adına e-posta göndermesine yetki verir.

AlanDeğer
TürTXT
Adyourdomain.com (veya @)
Değerv=spf1 include:spf.mlnd.net ~all
TTL3600

Zaten bir SPF kaydınız varsa, ~all veya -all mekanizmasından önce include:spf.mlnd.net ekleyin. SPF, alan adı başına yalnızca bir TXT kaydına izin verir: birden fazla SPF kaydı kimlik doğrulama hatalarına neden olur.

Mevcut SPF örneği:

# Before
v=spf1 include:_spf.google.com ~all

# After
v=spf1 include:_spf.google.com include:spf.mlnd.net ~all

DKIM (Alan Anahtarlarıyla Tanımlanmış Posta)

DKIM, her e-postaya kriptografik imza ekleyerek alıcıların iletinin iletim sırasında değiştirilmediğini doğrulamasına olanak tanır.

AlanDeğer
TürTXT
Admlnd._domainkey.yourdomain.com
Değerv=DKIM1; k=rsa; p=MIIBIjANBgkq... (genel anahtarınız)
TTL3600

MailLand, bir alan adı eklendiğinde 2048 bitlik RSA anahtar çifti oluşturur. Varsayılan seçici mlnd'dir. Tam genel anahtar değeri DNS talimatları yanıtında sağlanır.

DKIM genel anahtarları uzundur (yaklaşık 400 karakter). Bazı DNS sağlayıcıları TXT kayıtlarını 255 karakterlik parçalara böler. Çoğu sağlayıcı bunu otomatik olarak yönetir: sağlayıcınız yapmazsa, değeri çift tırnak içine alın ve sağlayıcı bunu birleştirmeli.

DMARC (zorunlu)

DMARC, alıcı posta sunucularına SPF veya DKIM kontrolleri başarısız olduğunda ne yapacaklarını söyler. DMARC zorunludur: v=DMARC1 ile başlayan ve p= içeren bir _dmarc kaydı olmadan doğrulama başarısız olur.

AlanDeğer
TürTXT
Ad_dmarc.yourdomain.com
DeğerYukarıdaki dns-instructions yanıtındaki tam değeri kullanın (alan adı başına benzersiz bir raporlama adresi içerir)
TTL3600

DMARC politika seçenekleri:

PolitikaDavranış
p=noneYalnızca izleme: başarısızlıklarda işlem yok (ilk kurulum için uygun)
p=quarantineBaşarısızlıkları spam klasörüne gönder (önerilen başlangıç noktası)
p=rejectBaşarısızlıkları tamamen engelle (en katı, en iyi koruma)

Mail.Land alan adınızın DMARC toplu raporlarını işler. dns-instructions yanıtındaki değeri olduğu gibi yayımlayın. İçindeki rua adresi (dmarc+<id>@rpt.mail.land) Mail.Land'in rapor alıcısıdır. Bu alan adının veya alt alan adlarından birinin raporları planınızın saklama süresi boyunca saklanır; DMARC başarı oranları, gönderim kaynakları ve uygulanan işlemler API üzerinden sunulur: GET /v1/domains/{id}/dmarc/summary ve GET /v1/domains/{id}/dmarc/sources. Bunlar için henüz bir panel sayfası yoktur. Raporları kendiniz de almak için kendi adresinizi aynı etikete ekleyin: rua=mailto:dmarc+<id>@rpt.mail.land,mailto:[email protected].

İsteğe Bağlı Kayıtlar

Özel Dönüş Yolu (geri dönüş alan adı)

Özel geri dönüş alan adı, alan adı doğrulamasının parçasıdır ve her yeni alan adı için varsayılan olarak açıktır: MailLand e-postalarınızı kendi alt alan adınızdaki bir Return-Path ("mailed-by" adresi) ile gönderir; böylece SPF alan adınızla hizalanır. Bir CNAME kaydı ekleyin:

AlanDeğer
TürCNAME
Adbounce.yourdomain.com
Değerbounce.mlnd.net
TTL3600

Posta sunucuları bu CNAME'i izleyerek MailLand'in posta sunucusuna ve SPF kaydına ulaşır; bu nedenle bu ada MX veya TXT kaydı eklemeyin.

Kayıt yalnızca DNS (proxy'siz) olmalıdır. Cloudflare'in turuncu bulutu gibi proxy'li bir kayıt, CNAME'i posta sunucularından gizler ve doğrulama başarısız olur. bounce.mlnd.net adresine işaret eden bir MX kaydı kullanmayın: bu sunucu posta kabul etmez.

MailLand bu kaydı düzenli olarak yeniden denetler. Kayıt silinir veya değiştirilirse özel geri dönüş alan adı artık doğrulanmış sayılmaz, bir bildirim alırsınız ve kaydı yeniden doğrulayana kadar e-postalarınız MailLand'in varsayılan Return-Path adresini kullanır. Ayarı kapatıp yeniden açmak da kaydın yeniden doğrulanmasını gerektirir.

Özel geri dönüş alan adını alan adı ayarlarından kapatabilirsiniz, ancak yalnızca bir uyarıyı onayladıktan sonra: alan adı bu durumda MailLand'in paylaşılan geri dönüş zarfı altında gönderir, SPF alan adınızla hizalanmaz ve zarfın itibarı diğer göndericilerle paylaşılır. Kapatılmış alan adları MailLand operatörlerine işaretlenir. Bu seçenek varsayılan olmadan önce oluşturulan alan adları mevcut ayarlarını korur; kaydı almak için alan adı ayarlarında açın.

İzleme CNAME'i

Özel bir izleme alt alanı kullanıyorsanız, bir CNAME ekleyin:

AlanDeğer
TürCNAME
Adtrack.yourdomain.com
Değertrack.mlnd.net
TTL3600

Kayıt yalnızca DNS (proxy'siz) olmalıdır. Cloudflare'in turuncu bulutu gibi proxy'li bir kayıt başka bir sertifikayla yanıt verir; izlenen bağlantılar ve abonelikten çıkma bağlantısı çalışmaz. CNAME doğrulandıktan sonra MailLand sertifikayı ister ve bu ana makinede HTTPS'i kontrol eder. Bu kontrol başarılı olana kadar bağlantılar MailLand'in varsayılan izleme ana makinesini kullanmaya devam eder. Kontrol başarısız olmaya devam ederse size bildirim gönderilir. CNAME her saat yeniden kontrol edilir. API üzerinden useCustomBounce: false değerini acknowledgeSharedBounceRisk: true ile birlikte gönderin; olmadan istek BOUNCE_OPT_OUT_NOT_ACKNOWLEDGED koduyla reddedilir.

Gelen MX

Gelen e-posta işleme kullanıyorsanız:

AlanDeğer
TürMX
Advarsayılan olarak kök (@), veya alan adı ayarlarında bir tane belirlediyseniz inboundSubdomain değeriniz (örneğin in). Alt alan adı, kökteki mevcut posta kutusu sağlayıcınızı korur; hem alt alan adına hem de köke gelen postalar kabul edilir.
Değermx.mlnd.net
Öncelik10
TTL3600

DNS Sağlayıcı Kılavuzları

  1. Cloudflare panosuna giriş yapın
  2. Alan adınızı seçin
  3. DNS → Records bölümüne gidin
  4. Her kayıt için Add Record'a tıklayın
  5. TXT kayıtları için proxy durumunu DNS only (gri bulut) olarak ayarlayın
  6. CNAME kayıtları için proxy durumunu DNS only olarak ayarlayın: proxy'li CNAME'ler e-posta kimlik doğrulamasını etkileyebilir

DNS Kayıtlarını Kontrol Edin

Kayıtları ekledikten sonra yayıldıklarını doğrulayın:

GET https://api.mail.land/v1/domains/{id}/dns-records
Check DNS records
curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/dns-records \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
DNS records response
{
  "domain": "yourdomain.com",
  "spfRecord": {
    "recordType": "TXT",
    "hostName": "@",
    "value": "v=spf1 include:spf.mlnd.net ~all",
    "status": "valid",
    "instructions": "Add this TXT record to your domain's root. If you have an existing SPF record, add 'include:spf.mlnd.net' to it instead of creating a new record."
  },
  "dkimRecord": {
    "recordType": "TXT",
    "hostName": "mlnd._domainkey",
    "value": "v=DKIM1; k=rsa; p=MIIBIjANBgkq...",
    "status": "valid",
    "instructions": "Add this TXT record with hostname 'mlnd._domainkey' to enable DKIM signing."
  },
  "dmarcRecord": {
    "recordType": "TXT",
    "hostName": "_dmarc",
    "value": "v=DMARC1; p=quarantine; pct=100; adkim=r; aspf=r; rua=mailto:[email protected]; sp=none",
    "status": "valid",
    "instructions": "Add this TXT record at the '_dmarc' subdomain to enable DMARC policy. The rua tag sends aggregate reports to a MailLand address. MailLand stores the reports for this domain for your plan's retention period and makes their DMARC pass rate, sending sources and dispositions available through the API (GET /v1/domains/{id}/dmarc/summary and /dmarc/sources). To also receive the reports yourself, add your own address to the rua tag."
  },
  "trackingRecord": {
    "recordType": "CNAME",
    "hostName": "track",
    "value": "track.mlnd.net",
    "status": "valid",
    "instructions": "Custom Tracking Links"
  },
  "bounceRecords": [
    {
      "recordType": "CNAME",
      "hostName": "bounce",
      "value": "bounce.mlnd.net",
      "status": "valid",
      "instructions": "Bounce Domain (Return-Path) DNS-only (not proxied): a proxied record hides the CNAME from mail servers."
    }
  ],
  "notes": [
    "DNS changes can take up to 48 hours to propagate globally.",
    "After adding records, click 'Verify Domain' to check the configuration.",
    "All three records (SPF, DKIM, DMARC) must be verified to start sending emails.",
    "Use your DNS provider's documentation for specific instructions on adding TXT records."
  ]
}

DNS yayılımı, DNS sağlayıcınıza ve mevcut kayıtların TTL'sine bağlı olarak birkaç dakikadan 48 saate kadar sürebilir. Çoğu sağlayıcı 5–15 dakika içinde yayar.

Sonraki Adımlar

Alan Adı Ekleme

Mail.Land çalışma alanınıza gönderim alan adı ekleme ve yapılandırma

Alan Adı Doğrulaması

DNS kaydı doğrulaması ile alan adı sahipliğinizi doğrulayın

Bu sayfada

DNS Talimatlarını AlınZorunlu KayıtlarSPF (Gönderen Politikası Çerçevesi)DKIM (Alan Anahtarlarıyla Tanımlanmış Posta)DMARC (zorunlu)İsteğe Bağlı KayıtlarÖzel Dönüş Yolu (geri dönüş alan adı)İzleme CNAME'iGelen MXDNS Sağlayıcı KılavuzlarıDNS Kayıtlarını Kontrol EdinSonraki Adımlar