Some checks failed
Windows project source guards / test (push) Has been cancelled
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>
131 lines
8.7 KiB
Python
131 lines
8.7 KiB
Python
"""Сетевые вызовы приложения — только в известных местах.
|
||
|
||
Требование незаметности (шлюз проверок, ``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()
|