← Cloudflare Email Service / email-service / reference

Řešení potíží

Ověření e-mailů je zásadní pro úspěšné doručení. Tato příručka vám pomůže vyřešit běžné problémy se SPF, DKIM a DMARC v Email Service.

Doména nesmí mít více záznamů SPF, jinak Email Service nebude fungovat správně. Pokud vaše doména má více záznamů SPF:

1. Přihlaste se do Cloudflare dashboardu, vyberte svůj účet a doménu a poté přejděte na DNS > Záznamy.

   Přejděte na Záznamy ↗

2. Vyhledejte více záznamů TXT začínajících na v=spf1.

3. Odstraňte nesprávný záznam SPF.

4. Zajistěte, že máte správné záznamy SPF:

   • Pro Email Routing (kořenová doména): v=spf1 include:_spf.mx.cloudflare.net ~all
   • Pro Email Sending (cf-bounce subdoména): v=spf1 include:_spf.mx.cloudflare.net ~all

Pokud si nejste jisti, který záznam SPF je ten správný, který si ponechat, můžete je všechny odstranit a nechat Cloudflare znovu vygenerovat požadované záznamy:

1. V DNS > Záznamy, smažte všechny TXT záznamy začínající na v=spf1 u dotčeného názvu.
2. Přejděte na Compute > Email Service a znovu nastavte nebo znovu povolte postiženou službu. Cloudflare automaticky obnoví správný záznam SPF.

Pokud jsou e-maily odmítány kvůli selhání SPF:

1. Přihlaste se do Cloudflare dashboardu, vyberte svůj účet a doménu a poté přejděte na DNS > Záznamy.

   Přejděte na Záznamy ↗

2. Přidejte záznamy TXT pro příslušnou službu:

   • Pro Email Routing: Název: @ (kořenová doména), Obsah: v=spf1 include:_spf.mx.cloudflare.net ~all
   • Pro Email Sending: Název: cf-bounce, Obsah: v=spf1 include:_spf.mx.cloudflare.net ~all

3. Pokud již máte záznam SPF v kořenové doméně, upravte ho tak, aby obsahoval include:_spf.mx.cloudflare.net

Časté problémy se syntaxí záznamu SPF:

• Chybí verze: Záznamy SPF musí začínat v=spf1
• Vícenásobné direktivy include: Zkombinujte více služeb pomocí samostatných include: příkazy
• Příliš mnoho vyhledávání DNS: Záznamy SPF jsou omezeny na celkem 10 vyhledávání DNS
• Nesprávný mechanismus all: Použijte ~all (SoftFail) nebo -all (Fail), nikoli +all

Správný formát:

v=spf1 include:_spf.mx.cloudflare.net include:other-service.com ~all

Ověřte, že je váš záznam SPF nakonfigurován správně:

dig TXT example.com +short | grep spf

Očekávaný výsledek by měl obsahovat:

"v=spf1 include:_spf.mx.cloudflare.net ~all"

Email Service automaticky generuje klíče DKIM pro vaši doménu, DNS záznamy je ale nutné správně nakonfigurovat. Email Sending a Email Routing používají oddělené selektory DKIM:

1. V Cloudflare dashboard ↗, přejděte na Compute > Email Service.
2. Vyberte svou doménu.
3. Zkontrolujte Nastavení stránku pro příslušnou službu:
   • Email Sending: Přejděte na Email Sending > Nastavení k vyhledání odesílacího záznamu DKIM (cf-bounce._domainkey).
   • Email Routing: Přejděte na Email Routing > Nastavení k vyhledání směrovacího záznamu DKIM (cf2024-1._domainkey).
4. Zkopírujte podrobnosti záznamu DKIM.
5. Přejděte na DNS > Záznamy a přidejte záznam DKIM TXT se správným názvem selektoru a veřejným klíčem.

Pokud potřebujete provést rotaci klíčů DKIM:

1. Kontaktujte podporu Cloudflare a požádejte o rotaci klíčů.
2. Jakmile obdržíte nový klíč DKIM, aktualizujte jím své záznamy DNS.
3. Sledujte doručování e-mailů během přechodného období.

Ověřte, že jsou vaše záznamy DKIM správně nakonfigurovány:

# Check Email Sending DKIM
dig TXT cf-bounce._domainkey.example.com +short

# Check Email Routing DKIM
dig TXT cf2024-1._domainkey.example.com +short

Očekávaný výsledek pro obě možnosti:

"v=DKIM1; h=sha256; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA..."

Pokud selhává ověření DKIM:

1. Ověřte, že záznam DKIM existuje v DNS
2. Zkontrolujte, že název záznamu odpovídá správnému selektoru:
   • Email Sending: cf-bounce._domainkey.yourdomain.com
   • Email Routing: cf2024-1._domainkey.yourdomain.com
3. Zajistěte, aby DNS záznam neobsahoval žádné nadbytečné mezery ani znaky
4. Počkejte na propagaci DNS (až 48 hodin)
5. K otestování konfigurace použijte online validátory DKIM

Ačkoli není povinný, DMARC výrazně zlepšuje doručitelnost e-mailů:

1. Přejděte na DNS > Záznamy na Cloudflare dashboardu.

   Přejděte na Záznamy ↗

2. Přidejte záznam TXT:

   • Název: _dmarc
   • Obsah: v=DMARC1; p=quarantine; rua=mailto:[email protected]

Pokud přísná zásada DMARC způsobuje problémy s doručováním:

1. Začněte s benevolentní politikou: p=none (pouze sledování)
2. Sledujte přehledy DMARC po dobu několika týdnů
3. Postupně zvyšujte přísnost: p=quarantine poté p=reject
4. Zajistěte, aby byly SPF i DKIM správně zarovnané

DMARC vyžaduje shodu se SPF nebo s DKIM:

Shoda SPF: Doména v Mail From hlavička se musí shodovat s doménou v From hlavička Shoda DKIM: Doména podpisu DKIM musí odpovídat doméně v From hlavička

Email Service zajišťuje správné zarovnání automaticky.

Ověřte svůj záznam DMARC:

dig TXT _dmarc.example.com +short

Příklad výsledku:

"v=DMARC1; p=quarantine; rua=mailto:[email protected]; ruf=mailto:[email protected]; sp=quarantine"

K této chybě dochází při předávání ArrayBuffer obsah v polích příloh během lokálního vývoje pomocí wrangler dev. Simulátor lokální e-mailové vazby (local email binding) neumí serializovat ArrayBuffer hodnoty.

Řešení: Nasaďte svého Workera pomocí npx wrangler deploy a otestujte binární přílohy (obrázky, PDF) oproti nasazené verzi. Obsah typu string pro textové přílohy funguje v místním vývoji normálně. Viz lokální vývoj pro odesílání e-mailů pro další podrobnosti.

Pokud e-maily končí ve složce spam:

1. Zkontrolujte autentizaci: ujistěte se, že jsou správně nakonfigurovány SPF, DKIM a DMARC
2. Reputace domény: nové domény mohou mít zpočátku nižší reputaci
3. Kvalita obsahu: Vyhněte se slovům spouštějícím spamové filtry a nadměrnému HTML formátování
4. Reputace odesílatele: sledujte míru nedoručených zpráv a stížností
5. Čistota seznamu: odstraňte vrácené a neplatné e-mailové adresy

Snížení míry bounce e-mailů:

1. Ověřování e-mailových adres: Použijte ověřování v reálném čase
2. Udržujte čisté seznamy: okamžitě odstraňujte adresy s trvalým selháním doručení
3. Sledujte zpětnovazební smyčky: přihlaste se k odběru zpětnovazebních smyček ISP
4. Postupné zahřívání: u nových domén začněte s malými objemy

Různí poskytovatelé internetových služeb mají specifické požadavky:

• Gmail: vyžaduje silnou reputaci domény a ověřování
• Outlook/Hotmail: citlivé na obsah a reputaci odesílatele
• Yahoo: přísné vynucování DMARC
• Firemní prostředí: Často mají přísná pravidla filtrování

K ověření nastavení e-mailové autentizace použijte tyto nástroje:

1. MX Toolbox: kontrola záznamů SPF, DKIM a DMARC
2. DMARC Analyzer: Ověření zásady DMARC a shody
3. Mail Tester: test doručitelnosti a ověřování e-mailů
4. Google Admin Toolbox: nástroj Google pro ověřování e-mailů

Pokud problémy s ověřováním přetrvávají:

1. Zkontrolujte Analytika Email Service pro metriky doručování
2. Zkontrolujte zprávy o nedoručení kvůli konkrétním chybovým kódům
3. Kontaktujte Cloudflare Support ↗ s:
   • Název domény
   • Příklad hlaviček e-mailu
   • Konkrétní chybové zprávy
   • Konfigurace záznamů SPF, DKIM a DMARC