← Cloudflare Email Service / email-service / reference

Устранение неполадок

Аутентификация писем критически важна для успешной доставки. Это руководство поможет устранить типичные проблемы с SPF, DKIM и DMARC в Email Service.

Наличие нескольких записей SPF в вашем домене не допускается и нарушает работу Email Service. Если в домене несколько записей SPF:

1. Войдите в панель управления Cloudflare, выберите свою учетную запись и домен, затем перейдите в DNS > Записи.

   Перейдите в Записи ↗

2. Найдите несколько TXT-записей, начинающихся с v=spf1.

3. Удалите неверную запись SPF.

4. Убедитесь, что у вас указаны правильные записи SPF:

   • Для Email Routing (корневой домен): v=spf1 include:_spf.mx.cloudflare.net ~all
   • Для Email Sending (cf-bounce поддомен): v=spf1 include:_spf.mx.cloudflare.net ~all

Если вы не уверены, какую именно запись SPF нужно оставить, можно удалить их все и позволить Cloudflare заново создать необходимые записи:

1. В DNS > Записи, удалите все записи TXT, начинающиеся с v=spf1 для затронутого имени.
2. Перейдите в Вычисления > Служба электронной почты и заново подключите или включите затронутую службу. Cloudflare автоматически восстановит правильную SPF-запись.

Если письма отклоняются из-за ошибок SPF:

1. Войдите в панель управления Cloudflare, выберите свою учетную запись и домен, затем перейдите в DNS > Записи.

   Перейдите в Записи ↗

2. Добавьте записи TXT для соответствующего сервиса:

   • Для Email Routing: Название: @ (корневой домен), Content: v=spf1 include:_spf.mx.cloudflare.net ~all
   • Для Email Sending: Название: cf-bounce, Content: v=spf1 include:_spf.mx.cloudflare.net ~all

3. Если у вас уже есть запись SPF в корневом домене, измените ее так, чтобы она включала include:_spf.mx.cloudflare.net

Частые ошибки синтаксиса записи SPF:

• Отсутствует версия: Записи SPF должны начинаться с v=spf1
• Несколько механизмов include: Объединяйте несколько сервисов с помощью отдельных include: инструкции
• Слишком много DNS-запросов: Записи SPF ограничены 10 DNS-запросами суммарно
• Некорректный механизм all: Используйте ~all (SoftFail) или -all (Fail), а не +all

Правильный формат:

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

Verify your SPF record is configured correctly:

dig TXT example.com +short | grep spf

Ожидаемый результат должен включать:

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

Email Service автоматически создаёт ключи DKIM для вашего домена, но DNS-записи нужно настроить правильно. Email Sending и Email Routing используют разные селекторы DKIM:

1. В Панель управления Cloudflare ↗, перейдите в Вычисления > Служба электронной почты.
2. Выберите свой домен.
3. Проверьте Настройки страницу для соответствующего сервиса:
   • Email Sending: Перейдите в Email Sending > Настройки чтобы найти запись DKIM для отправки (cf-bounce._domainkey).
   • Email Routing: Перейдите в Email Routing > Настройки чтобы найти запись DKIM для маршрутизации (cf2024-1._domainkey).
4. Скопируйте данные записи DKIM.
5. Перейдите в DNS > Записи и добавьте TXT-запись DKIM с правильным именем селектора и открытым ключом.

Если нужно выполнить ротацию ключей DKIM:

1. Обратитесь в поддержку Cloudflare, чтобы запросить ротацию ключей.
2. Обновите записи DNS новым ключом DKIM, когда он будет предоставлен.
3. Отслеживайте доставку писем в переходный период.

Убедитесь, что записи DKIM настроены правильно:

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

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

Ожидаемый результат для обоих вариантов:

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

Если проверка DKIM не проходит:

1. Убедитесь, что запись DKIM существует в DNS
2. Убедитесь, что имя записи соответствует правильному селектору:
   • Email Sending: cf-bounce._domainkey.yourdomain.com
   • Email Routing: cf2024-1._domainkey.yourdomain.com
3. Убедитесь, что в DNS-записи нет лишних пробелов или символов
4. Дождитесь распространения DNS-записей (до 48 часов)
5. Используйте онлайн-валидаторы DKIM для проверки конфигурации

DMARC не является обязательным, но значительно повышает доставляемость писем:

1. Перейдите в DNS > Записи в Cloudflare dashboard.

   Перейдите в Записи ↗

2. Добавьте запись TXT:

   • Название: _dmarc
   • Content: v=DMARC1; p=quarantine; rua=mailto:[email protected]

Если строгая политика DMARC вызывает проблемы с доставкой:

1. Начните с нестрогой политики: p=none (только мониторинг)
2. Отслеживайте отчёты DMARC в течение нескольких недель
3. Постепенно повышайте строгость: p=quarantine затем p=reject
4. Убедитесь, что SPF и DKIM правильно выровнены

DMARC требует согласования либо с SPF, либо с DKIM:

Согласование SPF: Домен в Mail From заголовок должен совпадать с доменом в From заголовок Выравнивание DKIM: Домен подписи DKIM должен совпадать с доменом в From заголовок

Email Service автоматически обеспечивает правильное выравнивание.

Проверьте запись DMARC:

dig TXT _dmarc.example.com +short

Пример результата:

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

Эта ошибка возникает при передаче ArrayBuffer содержимое в полях вложений при локальной разработке с помощью wrangler dev. Локальный симулятор email-привязки не может сериализовать ArrayBuffer значения.

Решение: Разверните ваш Worker с помощью npx wrangler deploy и протестируйте бинарные вложения (изображения, PDF) на развёрнутой версии. Строковое содержимое для текстовых вложений работает как обычно при локальной разработке. См. локальная разработка для отправки писем для дополнительных сведений.

Если письма попадают в папку «Спам»:

1. Проверьте аутентификацию: убедитесь, что SPF, DKIM и DMARC настроены правильно
2. Репутация домена: у новых доменов репутация изначально может быть ниже
3. Качество контента: избегайте спам-триггеров и избыточного HTML-форматирования
4. Репутация отправителя: отслеживайте долю отказов и жалоб
5. Чистка списка: удаляйте адреса с ошибками доставки и недействительные адреса

Чтобы снизить долю отказов:

1. Проверяйте адреса электронной почты: используйте проверку в реальном времени
2. Поддерживайте чистоту списков: немедленно удаляйте адреса с жесткими отказами
3. Отслеживайте цепочки обратной связи: подпишитесь на цепочки обратной связи интернет-провайдеров
4. Постепенный прогрев: для новых доменов начинайте с небольших объёмов

У разных почтовых провайдеров есть особые требования:

• Gmail: требует высокой репутации домена и надёжной аутентификации
• Outlook/Hotmail: чувствителен к содержимому и репутации отправителя
• Yahoo: строгое применение DMARC
• Корпоративные почтовые системы: часто имеют строгие правила фильтрации

Используйте эти инструменты для проверки настройки аутентификации электронной почты:

1. MX Toolbox: проверка записей SPF, DKIM и DMARC
2. DMARC Analyzer: проверка политики и выравнивания DMARC
3. Mail Tester: проверка доставляемости и аутентификации писем
4. Google Admin Toolbox: инструмент Google для проверки аутентификации почты

Если проблемы с аутентификацией сохраняются:

1. Проверьте Аналитика Email Service для метрик доставки
2. Анализируйте сообщения об отказах доставки на предмет конкретных кодов ошибок
3. Обратитесь в Служба поддержки Cloudflare ↗ с:
   • Имя домена
   • Пример заголовков письма
   • Конкретные сообщения об ошибках
   • Настройка записей SPF, DKIM и DMARC