Найти признаки DNS-блокировки
Проверяет список доменов и отмечает NXDOMAIN, пустые ответы и адреса-заглушки.
Что делает скрипт
Скрипт запрашивает 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.compython dns_block_check.py --file domains.txtpython dns_block_check.py example.com --resolver 192.0.2.53
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
py -m pip install dnspython
python3 -m pip install dnspython
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.