zapret-kvn/tests/test_network_egress_allowlist.py
loop-uh 65c13a3f80
Some checks failed
Windows project source guards / test (push) Has been cancelled
Block diagnosis after a failed connect, report button, freeze check
Same design as Android (owner decision 2026-11-19): after a failure,
while no TUN session is up, client_reports/probe.py checks control TCP
to our pool front, system DNS against DoH, TCP to IP:port and IP:443
and one ClientHello (byte-identical to Android) with the real name, a
neutral name and the real name on our front. diagnosis.py decides:
ip_blocked, port_blocked, tcp_reset, sni_blocked, tls_blocked,
dns_poisoned, dns_nxdomain, ...; on swapped probes only silence is a
filter. The verdict refines the report and shows on the dashboard
under the error for any server. After a success a 64 KB read through
the session catches the ~16 KB freeze, once per server per 10 minutes.

Every failed connect now reaches the reporter (AWG handshake silence
= udp_no_answer); «Отправить отчёт» sends the failure now, local
failures as local_*.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 10:40:17 -05:00

131 lines
8.7 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""Сетевые вызовы приложения — только в известных местах.
Требование незаметности (шлюз проверок, ``xray_fluent/network/probe_gate.py``):
приложение само не стучится ни к серверам, ни к сторонним сайтам, кроме мест,
которые прошли разбор. Новый ``create_connection``/``getaddrinfo``/``urlopen``
в другом модуле роняет этот тест: сначала реши, через какое правило шлюза идёт
новая проверка (текущий сервер — по сигналу, кандидат — в замене, по кнопке —
по одному), потом добавь модуль сюда с причиной.
"""
from __future__ import annotations
import ast
from pathlib import Path
import unittest
ROOT = Path(__file__).resolve().parents[1] / "xray_fluent"
PRIMITIVES = {
"create_connection", "getaddrinfo", "gethostbyname", "gethostbyname_ex",
"urlopen", "build_opener", "OpenerDirector", "HTTPSConnection", "HTTPConnection",
"socket", # только вызов socket.socket(...)
}
# модуль → разрешённые примитивы. Причина — в комментарии.
ALLOWED: dict[str, set[str]] = {
# Локальные порты: свободен ли порт на 127.0.0.1 перед запуском ядра.
"application/connection_service.py": {"socket"},
"application/controller.py": {"socket"},
"application/port_allocator.py": {"socket"},
"engines/singbox/runtime_planner.py": {"socket"},
# API ядра на 127.0.0.1 (clash/selector), готовность локальных портов;
# подтверждение обрыва — один запрос через локальный прокси ядра (внутри
# туннеля) и только по сигналу «запросы без ответа».
"diagnostics/live_metrics_worker.py": {"urlopen", "build_opener"},
"platform/windows/process_traffic_collector.py": {"urlopen"},
"engines/singbox/selector_api.py": {"build_opener"},
"engines/sidecar/readiness.py": {"create_connection"},
# Только 127.0.0.1: после отказа «xray api» — открыт ли локальный порт API ядра (в журнал).
"engines/xray/balancer_api.py": {"create_connection"},
"network/proxy_readiness.py": {"create_connection"},
# Проверки через локальный SOCKS ядра — внутри туннеля.
"engines/socks_probe.py": {"create_connection"},
# «Проверить сайт»: домен вводит пользователь, по нажатию.
"application/route_check.py": {"getaddrinfo"},
# Адрес выбранного сервера: DoH, системный резолвер — только если DoH не ответил.
"network/bootstrap_dns.py": {"HTTPSConnection", "getaddrinfo"},
# Подписка: https напрямую или через туннель; http:// — только через туннель.
"importer/subscription_http.py": {"build_opener"},
# Причина отказа подписки: один раз, когда ни один маршрут не ответил (сигнал
# «нет ответа»), и только к хосту самой подписки и к www.gstatic.com (та же
# цель, что у замера задержки). DNS → TCP → TLS напрямую и CONNECT через
# локальный прокси VPN; узлы-серверы не затрагиваются.
"network/fetch_diagnosis.py": {"create_connection", "getaddrinfo", "socket"},
# Отчёты о подключениях (решение владельца 19.11.2026, docs/CLIENT_REPORTS.md): только
# reports.zapret.moe и только после настоящей попытки подключения к серверу сервиса —
# отчёт напрямую, без ответа — через локальный прокси VPN; токен сети — только напрямую.
# Проверка VLESS идёт через engines/socks_probe.py (внутри туннеля).
"client_reports/reporter.py": {"build_opener"},
# Проверка пути после неудачного подключения (решение владельца 19.11.2026): только после
# отказа и не чаще раза в 10 минут на сервер, только без TUN. TCP до сервера и его IP на 443,
# один ClientHello с настоящим, нейтральным (ya.ru, vk.com, www.gosuslugi.ru) и настоящим
# именем на нашем фронте пула; системный DNS против DoH. Заморозка — до 64 КБ файла замера
# скорости через локальный прокси VPN, только после удачи у сервера сервиса.
"client_reports/probe.py": {"build_opener", "create_connection", "getaddrinfo"},
# Обновления приложения и ядер — наш сервер обновлений и GitHub, HTTPS.
"network/http_utils.py": {"build_opener", "urlopen"},
"updates/app_updater.py": {"build_opener"},
"updates/release_watch.py": {"urlopen"},
"updates/update_checker.py": {"urlopen"},
"engines/singbox/core_updater.py": {"urlopen"},
"engines/xray/core_updater.py": {"urlopen"},
# Смена сети: UDP connect без отправки пакетов (выбор интерфейса).
"network/network_monitor.py": {"socket"},
# Проверки серверов — правила шлюза: пинг по кнопке по одному с паузой,
# скорость по кнопке с паузой и кандидат умной замены в бюджете шлюза.
"network/ping_worker.py": {"create_connection"},
# Пинг: тёплый запрос через временное ядро проверяемого сервера (HTTP
# CONNECT к локальному прокси) — внутри туннеля, по кнопке, по одному.
"network/latency_probe.py": {"HTTPSConnection"},
"network/speed_test_worker.py": {"build_opener", "create_connection", "socket"},
# «Подобрать» маскировки: только по кнопке, через локальный прокси ядра (внутри туннеля) или TUN,
# одна цель (файл замера скорости), по одному, с паузами 1,5-4 с; к серверам VPN не обращается.
"application/masking_tune_service.py": {"build_opener"},
# Карточка сервисов в тесте скорости: HTTP CONNECT к известным сервисам через
# временный локальный прокси проверяемого узла — внутри туннеля, по кнопке.
"network/service_check.py": {"HTTPSConnection"},
"network/connectivity_test.py": {"build_opener"},
}
def _calls(path: Path) -> set[str]:
found: set[str] = set()
for node in ast.walk(ast.parse(path.read_text(encoding="utf-8"))):
if not isinstance(node, ast.Call):
continue
func = node.func
if isinstance(func, ast.Attribute):
name = func.attr
if name == "socket" and not (isinstance(func.value, ast.Name) and func.value.id == "socket"):
continue
elif isinstance(func, ast.Name):
name = func.id
if name == "socket":
continue
else:
continue
if name in PRIMITIVES:
found.add(name)
return found
class NetworkEgressAllowlistTest(unittest.TestCase):
def test_network_primitives_only_in_reviewed_modules(self) -> None:
unexpected: list[str] = []
for path in sorted(ROOT.rglob("*.py")):
if "__pycache__" in path.parts:
continue
module = path.relative_to(ROOT).as_posix()
extra = _calls(path) - ALLOWED.get(module, set())
if extra:
unexpected.append(f"{module}: {sorted(extra)}")
self.assertEqual(unexpected, [], "сетевой вызов вне разобранных мест — см. docstring теста")
def test_allowlist_has_no_stale_entries(self) -> None:
stale = [module for module in ALLOWED if not (ROOT / module).is_file() or not _calls(ROOT / module)]
self.assertEqual(stale, [])
if __name__ == "__main__":
unittest.main()