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

Найти признаки DNS-блокировки

Проверяет список доменов и отмечает NXDOMAIN, пустые ответы и адреса-заглушки.

Python Windows macOS Linux Продвинутый
Скачать dns_block_check.py
Описание

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

Скрипт запрашивает A-записи через dnspython и сравнивает результат с типичными признаками фильтрации DNS. NXDOMAIN, пустой ответ и адреса 0.0.0.0 или 127.0.0.1 считаются подозрительными. Можно указать свой DNS-сервер и включить ненулевой код возврата при находках.

Перед запуском
  • Результат зависит от настроек DNS и может давать ложные срабатывания при локальных заглушках.
Запуск

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

python dns_block_check.py example.com --fail-on-blocked

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

Примеры

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

  • python dns_block_check.py example.com
  • python dns_block_check.py --file domains.txt
  • python dns_block_check.py example.com --resolver 192.0.2.53
Зависимости

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

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
Исходник

dns_block_check.py

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

import argparse
import ipaddress
import re
import sys
from pathlib import Path

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

SINKHOLE = {
    ipaddress.ip_address("0.0.0.0"),
    ipaddress.ip_address("127.0.0.1"),
    ipaddress.ip_address("::"),
    ipaddress.ip_address("::1"),
}
DOMAIN_RE = re.compile(r"^[A-Za-z0-9]([A-Za-z0-9.-]*[A-Za-z0-9])?$")


def load_domains(arguments: list[str], file_path: Path | None) -> list[str]:
    domains = []
    for item in arguments:
        domains.append(item.strip())
    if file_path:
        if not file_path.is_file():
            raise SystemExit(f"Файл не найден: {file_path}")
        for line in file_path.read_text(encoding="utf-8").splitlines():
            line = line.split("#", 1)[0].strip()
            if line:
                domains.append(line)
    result = []
    seen = set()
    for domain in domains:
        domain = domain.rstrip(".")
        if not DOMAIN_RE.fullmatch(domain):
            print(f"Пропуск неверного домена: {domain}", file=sys.stderr)
            continue
        if domain not in seen:
            seen.add(domain)
            result.append(domain)
    return result


def check_domain(resolver: dns.resolver.Resolver, domain: str) -> tuple[str, list[str], str]:
    try:
        answer = resolver.resolve(domain, "A", raise_on_no_answer=False)
    except dns.resolver.NXDOMAIN:
        return "NXDOMAIN", [], "домен не существует или заблокирован"
    except dns.resolver.NoNameservers:
        return "SERVFAIL", [], "сервер не дал ответ"
    except dns.exception.Timeout:
        return "TIMEOUT", [], "истекло время ожидания"
    except dns.exception.DNSException as error:
        return "ERROR", [], str(error)

    if answer.rrset is None:
        return "EMPTY", [], "нет A-записей"
    addresses = [ipaddress.ip_address(item.address) for item in answer]
    if any(address in SINKHOLE for address in addresses):
        return "SINKHOLE", [str(item) for item in addresses], "адрес-заглушка"
    return "OK", [str(item) for item in addresses], ""


def main() -> int:
    parser = argparse.ArgumentParser(description="Проверить домены на признаки DNS-блокировки")
    parser.add_argument("domains", nargs="*", help="Домены для проверки")
    parser.add_argument("--file", type=Path, help="Файл со списком доменов")
    parser.add_argument("--resolver", help="IP DNS-сервера, по умолчанию системный")
    parser.add_argument("--timeout", type=float, default=3.0, help="Таймаут запроса в секундах")
    parser.add_argument("--fail-on-blocked", action="store_true", help="Вернуть код 1 при находках")
    args = parser.parse_args()

    domains = load_domains(args.domains, args.file)
    if not domains:
        parser.error("Укажите домен или --file")

    resolver = dns.resolver.Resolver(configure=True)
    resolver.timeout = args.timeout
    resolver.lifetime = args.timeout
    if args.resolver:
        try:
            ipaddress.ip_address(args.resolver)
        except ValueError:
            parser.error("--resolver должен быть IP-адресом")
        resolver.nameservers = [args.resolver]

    blocked = 0
    print(f"{'Домен':32} {'Статус':10} {'Адреса':28} Примечание")
    for domain in domains:
        status, addresses, note = check_domain(resolver, domain)
        if status in {"NXDOMAIN", "EMPTY", "SINKHOLE"}:
            blocked += 1
        print(f"{domain:32} {status:10} {', '.join(addresses) or '-':28} {note}")

    print(f"Проверено: {len(domains)}, подозрительных: {blocked}")
    if blocked and args.fail_on_blocked:
        return 1
    return 0


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

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

CLI 1.0.0

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

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

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

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

Категория

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

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