Сеть и диагностика

Разобрать SPF-запись домена

Проверяет SPF, считает DNS-lookups, показывает механизмы и качество финального all.

Python Windows macOS Linux Средний
Скачать spf_check.py
Описание

Что делает скрипт

Скрипт находит SPF-запись, разбирает механизмы и рекурсивно учитывает include и redirect. Отдельно проверяется число DNS-lookups и квалификатор all. Результат помогает найти слишком сложные и потенциально неработающие политики.

Запуск

Быстрый старт

python spf_check.py example.com

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python spf_check.py example.com
  • python spf_check.py example.com --verbose
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
dnspython Модуль dns.resolver для DNS-запросов
Windows py -m pip install dnspython
macOS python3 -m pip install dnspython
Linux python3 -m pip install dnspython
Исходник

spf_check.py

#!/usr/bin/env python3
"""Разбор и проверка SPF-записи домена."""
from __future__ import annotations

import argparse
import sys

try:
    import dns.exception
    import dns.resolver
except ImportError:
    print("Нужен dnspython: python -m pip install dnspython", file=sys.stderr)
    sys.exit(2)

LOOKUP_MECHANISMS = {"a", "mx", "ptr", "exists"}
RESOLVER = dns.resolver.Resolver(configure=True)
RESOLVER.timeout = 4.0
RESOLVER.lifetime = 4.0


def get_txt(name: str) -> list[str]:
    try:
        answer = RESOLVER.resolve(name, "TXT", raise_on_no_answer=False)
    except dns.resolver.NXDOMAIN:
        return []
    except dns.resolver.NoNameservers:
        return []
    except dns.exception.Timeout:
        return []
    except dns.exception.DNSException:
        return []
    if answer.rrset is None:
        return []
    records = []
    for item in answer:
        records.append(b"".join(item.strings).decode("utf-8", "replace"))
    return records


def find_spf(domain: str) -> list[str]:
    return [record for record in get_txt(domain) if record.lower().startswith("v=spf1")]


def analyze(record: str, domain: str, depth: int = 0, seen: set[str] | None = None) -> tuple[int, list[str], str | None]:
    if seen is None:
        seen = {domain}
    if depth > 5:
        return 0, ["слишком глубокая цепочка include"], None

    tokens = record.split()
    if not tokens or tokens[0].lower() != "v=spf1":
        return 0, ["запись не начинается с v=spf1"], None

    lookups = 0
    notes: list[str] = []
    all_qualifier: str | None = None

    for token in tokens[1:]:
        low = token.lower()
        if low.startswith("include:"):
            target = token.split(":", 1)[1].rstrip(".")
            lookups += 1
            if not target:
                notes.append("пустой include")
                continue
            if target in seen:
                notes.append(f"цикл include на {target}")
                continue
            seen.add(target)
            nested = find_spf(target)
            if len(nested) == 0:
                notes.append(f"include без SPF: {target}")
            elif len(nested) > 1:
                notes.append(f"несколько SPF в include: {target}")
            else:
                sub_lookups, sub_notes, _ = analyze(nested[0], target, depth + 1, seen)
                lookups += sub_lookups
                notes.extend(sub_notes)
            continue

        if low.startswith("redirect="):
            target = token.split("=", 1)[1].rstrip(".")
            lookups += 1
            if not target:
                notes.append("пустой redirect")
                continue
            if target in seen:
                notes.append(f"цикл redirect на {target}")
                continue
            seen.add(target)
            nested = find_spf(target)
            if len(nested) == 1:
                sub_lookups, sub_notes, _ = analyze(nested[0], target, depth + 1, seen)
                lookups += sub_lookups
                notes.extend(sub_notes)
            else:
                notes.append(f"redirect без одной SPF: {target}")
            continue

        mechanism = low.split(":", 1)[0].split("/", 1)[0]
        if mechanism in LOOKUP_MECHANISMS:
            lookups += 1

        stripped = low.lstrip("+-~?")
        if stripped == "all":
            all_qualifier = low[0] if low[0] in "+-~?" else "+"

    return lookups, notes, all_qualifier


def main() -> int:
    parser = argparse.ArgumentParser(description="Проверить SPF-запись домена")
    parser.add_argument("domain", help="Домен для проверки")
    parser.add_argument("--verbose", action="store_true", help="Показать все TXT-записи")
    args = parser.parse_args()

    domain = args.domain.rstrip(".")
    if not domain or " " in domain:
        parser.error("Укажите домен без пробелов")

    records = find_spf(domain)
    if args.verbose:
        print("TXT-записи:")
        for record in get_txt(domain):
            print(f"  {record}")

    if not records:
        print("SPF не найден", file=sys.stderr)
        return 1
    if len(records) > 1:
        print(f"Найдено несколько SPF-записей: {len(records)}", file=sys.stderr)
        for record in records:
            print(f"  {record}", file=sys.stderr)
        return 1

    record = records[0]
    lookups, notes, qualifier = analyze(record, domain)

    print(f"Домен: {domain}")
    print(f"SPF: {record}")
    print(f"Механизмы: {' '.join(record.split()[1:])}")
    print(f"DNS-lookups: {lookups} из 10")
    print(f"Финальный all: {qualifier + 'all' if qualifier else 'не указан'}")

    failed = False
    if qualifier is None:
        print("Нет механизма all: политика может быть непредсказуемой", file=sys.stderr)
    elif qualifier == "+":
        print("Опасный +all: разрешает отправку с любых серверов", file=sys.stderr)
        failed = True
    elif qualifier == "?":
        print("Нейтральный ?all не даёт защиты от подделки", file=sys.stderr)
    if lookups > 10:
        print("Превышен лимит DNS-lookups, получатели могут отклонить письма", file=sys.stderr)
        failed = True
    elif lookups > 8:
        print("SPF близок к лимиту в 10 DNS-lookups", file=sys.stderr)
    for note in notes:
        print(f"Замечание: {note}", file=sys.stderr)

    return 1 if failed else 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get network-spf-check
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Сеть и диагностика

Проверка соединений, DNS, портов, скорости и сетевых настроек.

Теги