zapret-kvn/xray_fluent/engines/xray/balancer_api.py
loop-uh 8f90cdc322 Подписка: где оборвалось и кто виноват, журнал с маской адреса; кнопка «Поддержка»; торренты напрямую
- fetch_diagnosis: при отказе всех маршрутов проверка DNS/TCP/TLS сервера и контрольного узла
  напрямую и через VPN, вердикт (бот, отказ клиенту, блокировка сети, VPN, интернет); журнал
  с маской хоста и отпечатком, без пути и токена
- ответ сервера с кодом называет виновника по коду (403/HWID — отказ клиенту, 404/5xx — бот)
- xray api bo: --timeout=8, повтор «failed to dial», диагностика порта API в журнале
- установщик: честный текст после 90 с без движения, дамп стеков update_stall.log через 120 с
- шаблоны sing-box и Xray: BitTorrent (протокол, клиенты, порты) всегда напрямую
- кнопка «Поддержка» на странице «О проекте»: редактированный архив журналов и страница
  обращений на открытом зеркале сайта

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-04 09:26:56 -05:00

137 lines
6 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 через его gRPC API.
``xray api bo`` фиксирует выбор балансировщика на конкретном outbound'е. Ядро при
этом не перезапускается, конфиг на диске не переписывается, уже установленные
соединения не рвутся — новые сразу идут через выбранный сервер. Это и есть механизм
переключения серверов при активной ротации.
Команда требует ``"RoutingService"`` в секции ``api.services`` конфига; его добавляет
:func:`xray_fluent.application.outbound_pool_service.ensure_xray_pool_control_plane`
вместе с самим балансировщиком, когда ноды загружаются в ядро пулом.
"""
from __future__ import annotations
import os
import socket
import time
from pathlib import Path
from ...constants import PROXY_HOST
from ...platform.windows.subprocess_utils import CREATE_NO_WINDOW, result_output_text, run_text, run_text_pumped
#: Таймаут самого вызова API внутри ``xray api`` (по умолчанию у ядра 3 с: на
#: загруженном ПК рукопожатие gRPC с локальным API не успевало, и запуск VLESS
#: падал с «failed to dial»).
API_CALL_TIMEOUT_SEC = 8
#: Потолок на процесс: вызов + запас на запуск exe (антивирус сканирует его при каждом старте).
COMMAND_TIMEOUT_SEC = API_CALL_TIMEOUT_SEC + 6.0
#: Отказ «не дозвонились» повторяют: сразу после старта ядро может ещё не принимать gRPC.
DIAL_ATTEMPTS = 3
DIAL_RETRY_PAUSE_SEC = 0.5
_PROXY_ENV_NAMES = (
"HTTP_PROXY", "HTTPS_PROXY", "ALL_PROXY", "NO_PROXY", "GRPC_PROXY",
"http_proxy", "https_proxy", "all_proxy", "no_proxy",
)
def build_balancer_override_command(
xray_path: str | Path,
api_port: int,
balancer_tag: str,
outbound_tag: str = "",
*,
remove: bool = False,
timeout: float | None = None,
) -> list[str]:
"""Собрать argv для ``xray api bo``. Без ``outbound_tag`` требуется ``remove=True``.
``timeout`` (с) — флаг ``--timeout`` самого вызова; без него у ядра 3 с.
"""
if not str(xray_path or "").strip():
raise ValueError("Путь к xray не задан")
if int(api_port) <= 0:
raise ValueError("Порт API xray не задан")
if not str(balancer_tag or "").strip():
raise ValueError("Тег балансировщика не задан")
command = [
str(xray_path),
"api",
"bo",
f"--server={PROXY_HOST}:{int(api_port)}",
"-b",
str(balancer_tag),
]
if timeout is not None:
command.insert(4, f"--timeout={int(timeout)}")
if remove:
command.append("-r")
return command
if not str(outbound_tag or "").strip():
raise ValueError("Тег outbound не задан")
command.append(str(outbound_tag))
return command
def apply_balancer_override(
xray_path: str | Path,
api_port: int,
balancer_tag: str,
outbound_tag: str = "",
*,
remove: bool = False,
pump: bool = True,
) -> tuple[bool, str]:
"""Применить (или снять) фиксацию выбора. Возвращает ``(успех, текст вывода)``.
``pump=True`` прокачивает события Qt на время ожидания: вызов идёт из главного
потока, и без этого зависший процесс подморозил бы интерфейс.
"""
try:
command = build_balancer_override_command(
xray_path, api_port, balancer_tag, outbound_tag, remove=remove, timeout=API_CALL_TIMEOUT_SEC
)
except ValueError as exc:
return False, str(exc)
runner = run_text_pumped if pump else run_text
# Повторы только в рабочем потоке: из главного ждать между ними нельзя.
attempts = 1 if pump else DIAL_ATTEMPTS
output = ""
for attempt in range(attempts):
try:
result = runner(command, timeout=COMMAND_TIMEOUT_SEC, creationflags=CREATE_NO_WINDOW)
except Exception as exc:
return False, f"{type(exc).__name__}: {exc}"
output = result_output_text(result).strip()
if result.returncode == 0:
return True, output
if "failed to dial" not in output or attempt + 1 >= attempts:
break
time.sleep(DIAL_RETRY_PAUSE_SEC)
if "failed to dial" in output:
output = f"{output} [{describe_api_reachability(api_port)}]"
return False, output
def describe_api_reachability(api_port: int) -> str:
"""Что видно с этого ПК про порт API: для журнала, когда «xray api» не дозвонился.
Различает «порт не слушает / закрыт» и «TCP есть, а gRPC не отвечает», а
заодно называет (без значений) переменные окружения прокси — частая
причина странных отказов локальных клиентов.
"""
started = time.monotonic()
try:
with socket.create_connection((PROXY_HOST, int(api_port)), timeout=2.0):
tcp = f"TCP до порта API {api_port} есть ({int((time.monotonic() - started) * 1000)} мс), gRPC не ответил"
except OSError as exc:
tcp = f"TCP до порта API {api_port} не открылся: {type(exc).__name__}"
names = [name for name in _PROXY_ENV_NAMES if os.environ.get(name)]
env = "прокси в окружении: " + (", ".join(names) if names else "нет")
return f"{tcp}; {env}"