zapret-kvn/xray_fluent/engines/xray_outbound_compat.py
loop-uh 9f0dca6f89
Some checks failed
Windows project source guards / test (push) Failing after 11s
Go 1.27.3 toolchain pin; plain VLESS/Trojan to a public address gets a clear reason
Xray 26.11 refuses VLESS/Trojan without TLS/Reality/encryption unless the server address is private.
The pool pre-check now reports that reason for such a node, mirroring Xray's rule, instead of relying on
the start failing first. The core lock moves the Amnezia build toolchain to go1.27.3 (needed by the
Android Xray v26.11.9 build; the pair shares one toolchain).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-09 12:33:15 -05:00

155 lines
6.8 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.

"""Совместимость сохранённых outbound'ов с текущим ядром Xray.
Xray 26.x отвергает целиком любой конфиг, где в ``kcpSettings`` есть ключ
``header`` или ``seed`` (даже ``{"type": "none"}``): «The feature mkcp header &
seed has been removed». Узлы же хранятся в том виде, в каком их когда-то
импортировали, а весь пул из сотен узлов идёт в одном конфиге — одна такая
запись останавливала запуск ядра для всех.
Здесь только чистые функции без Qt и без доступа к состоянию приложения:
* :func:`normalize_xray_outbound` — без потерь убирает то, что ядро больше не
принимает, но ничего не значит (``header: none``);
* :func:`xray_outbound_incompatibility` — причина, по которой узел ядро не соберёт
и пересобрать без потери смысла нельзя (маскировка ``srtp``/``utp``/… и
``seed`` в новом ядре переносятся в ``finalmask`` не один в один).
"""
from __future__ import annotations
import ipaddress
import re
from typing import Any
#: ``xray run`` называет несобираемый outbound по его тегу из конфига.
_FAILED_OUTBOUND_RE = re.compile(
r"failed to build outbound config with tag\s+(?P<tag>\S+)", re.IGNORECASE
)
_KCP_NETWORKS = {"kcp", "mkcp"}
_NO_HEADER_TYPES = {"", "none"}
def _kcp_settings(outbound: dict[str, Any]) -> dict[str, Any] | None:
stream = outbound.get("streamSettings")
if not isinstance(stream, dict):
return None
if str(stream.get("network") or "").strip().lower() not in _KCP_NETWORKS:
return None
settings = stream.get("kcpSettings")
return settings if isinstance(settings, dict) else None
def _kcp_header_type(settings: dict[str, Any]) -> str:
header = settings.get("header")
if isinstance(header, dict):
return str(header.get("type") or "").strip().lower()
return ""
#: Xray 26.11 отвергает VLESS/Trojan без TLS/Reality/шифрования, если адрес сервера
#: не частный (``infra/conf/xray.go: requiresTransportSecurity``). Правило повторено
#: здесь, чтобы такой узел не ронял запуск ядра для всего пула, а получал понятную причину.
_PRIVATE_DOMAIN_SUFFIXES = (
"lan", "localdomain", "example", "invalid", "localhost", "test", "local", "home.arpa", "internal",
)
_PRIVATE_NETWORKS = tuple(
ipaddress.ip_network(value) for value in ("10.0.0.0/8", "172.16.0.0/12", "192.168.0.0/16", "fc00::/7")
)
def _address_needs_transport_security(address: object) -> bool:
host = str(address or "").strip().strip("[]").lower().rstrip(".")
if not host:
return True
try:
ip = ipaddress.ip_address(host)
except ValueError:
if "." not in host:
return False # dotless name: private for Xray
return not any(host == suffix or host.endswith("." + suffix) for suffix in _PRIVATE_DOMAIN_SUFFIXES)
if ip.is_loopback or ip.is_link_local:
return False
return not any(ip in network for network in _PRIVATE_NETWORKS if network.version == ip.version)
def _plain_transport_reason(outbound: dict[str, Any]) -> str:
protocol = str(outbound.get("protocol") or "").strip().lower()
if protocol not in {"vless", "trojan"}:
return ""
stream = outbound.get("streamSettings")
security = str(stream.get("security") or "").strip().lower() if isinstance(stream, dict) else ""
if security not in {"", "none"}:
return ""
settings = outbound.get("settings")
if not isinstance(settings, dict):
return ""
entries: list[Any] = []
for key in ("vnext", "servers"):
value = settings.get(key)
if isinstance(value, list):
entries.extend(value)
entries.append(settings) # flat form: address at the top of settings
entry = next((item for item in entries if isinstance(item, dict) and item.get("address")), None)
if entry is None:
return ""
if protocol == "vless":
users = entry.get("users")
encryptions = [settings.get("encryption"), entry.get("encryption")]
if isinstance(users, list):
encryptions.extend(user.get("encryption") for user in users if isinstance(user, dict))
if any(str(value or "").strip().lower() not in {"", "none"} for value in encryptions):
return ""
if _address_needs_transport_security(entry.get("address")):
return f"{protocol.upper()} без TLS/Reality к публичному адресу запрещён в Xray 26.11 (включите TLS или Reality)"
return ""
def xray_outbound_incompatibility(outbound: object) -> str:
"""Пустая строка — узел собирается; иначе короткая причина для журнала и UI."""
if not isinstance(outbound, dict):
return ""
plain = _plain_transport_reason(outbound)
if plain:
return plain
settings = _kcp_settings(outbound)
if settings is None:
return ""
if str(settings.get("seed") or "").strip():
return "mKCP seed удалён в Xray 26.x (нужен finalmask)"
header_type = _kcp_header_type(settings)
if header_type not in _NO_HEADER_TYPES:
return f"mKCP header «{header_type}» удалён в Xray 26.x (нужен finalmask)"
return ""
def normalize_xray_outbound(outbound: dict[str, Any]) -> dict[str, Any]:
"""Убрать из kcp-настроек пустые ``header``/``seed``. Меняет словарь на месте.
Вызывается на копии: сохранённый ``node.outbound`` остаётся как был.
"""
settings = _kcp_settings(outbound)
if settings is None:
return outbound
if "header" in settings and _kcp_header_type(settings) in _NO_HEADER_TYPES:
del settings["header"]
if "seed" in settings and not str(settings.get("seed") or "").strip():
del settings["seed"]
return outbound
def failed_outbound_tag(lines: object, *, prefix: str = "") -> str:
"""Тег outbound'а, на котором ядро остановило разбор конфига, из его вывода.
Берётся последнее совпадение: предупреждения идут раньше самой ошибки.
"""
found = ""
for line in lines or ():
match = _FAILED_OUTBOUND_RE.search(str(line))
if match and match.group("tag").startswith(prefix):
found = match.group("tag")
return found