Xray-core: что это за ядро, на котором работают Happ, INCY и V2RayTun

Xray-core, это открытое ядро для проксирования трафика, которое умеет десяток протоколов (VLESS, VMess, Trojan, Shadowsocks, SOCKS, HTTP), маскировку Reality и XTLS, маршрутизацию по доменам и адресам, и именно оно делает всю работу внутри Happ (хапп), INCY, V2RayTun, Hiddify и Streisand: клиент, это интерфейс с кнопкой и списком серверов, а подключается, шифрует и сортирует трафик ядро. Из этого следуют вещи, которые объясняют половину вопросов про клиенты: почему подписка одна на всех, почему ошибки в логах выглядят одинаково, почему антивирус ругается на файл xray в папке Happ, что за «конфиг JSON» и зачем INCY умеет его импортировать. Ниже: откуда Xray взялся и чем отличается от V2Ray и sing-box, какие протоколы поддерживает, как клиент и ядро делят обязанности, как выглядит конфигурация, какие ошибки ядра встречаются чаще всего и что они означают.

Попробовать бесплатно подписка, которая работает в любом клиенте на Xray-core, пробный период без карты

Откуда взялся Xray и чем отличается от V2Ray и sing-box

V2Ray (Project V) появился в 2016 году как универсальная платформа проксирования с протоколом VMess. В 2020 году часть разработчиков сделала форк Xray с протоколом VLESS и технологией XTLS, которая убирает двойное шифрование, а в 2023 году в Xray добавили Reality, маскировку под настоящий чужой сайт. Сегодня Xray, самое распространённое ядро в российских клиентах обхода. Параллельно существует sing-box, другое ядро с похожими возможностями, на нём работают Hiddify и часть других клиентов; протоколы у них совместимые, поэтому подписка с VLESS Reality работает и там, и там. Разница для пользователя минимальна: интерфейс клиента важнее, чем ядро под ним. Что такое Reality на уровне протокола: VLESS Reality.

Какие протоколы умеет Xray

Hysteria2 в Xray нет, это отдельное ядро, и клиенты вроде INCY подключают его дополнительно. Сравнение того, что проходит фильтрацию: ТСПУ и DPI.

Как клиент и ядро делят обязанности

Клиент делает то, что видит пользователь: скачивает подписку по ссылке и разбирает список серверов, показывает пинг, хранит правила маршрутизации в удобном виде, создаёт TUN-адаптер или системный прокси, рисует кнопку. Потом он собирает из всего этого конфигурацию в формате JSON и запускает ядро с этой конфигурацией. Ядро устанавливает соединение с сервером по выбранному протоколу, шифрует, применяет маршрутизацию к каждому соединению и пишет лог. Когда вы меняете сервер, клиент перезапускает ядро с новым конфигом. Отсюда: если два клиента показывают одинаковую ошибку, дело в ядре или сервере, а не в интерфейсе; если один подключается, а другой нет, дело в клиенте (права, адаптер, настройки). Про режимы и права: TUN или прокси.

Что такое конфиг JSON и зачем он нужен

Конфигурация Xray, это текстовый файл JSON с разделами inbounds (откуда ядро принимает трафик: TUN, SOCKS), outbounds (куда отправляет: сервер VLESS, напрямую, блокировка), routing (правила, по которым выбирается outbound), dns. Ключ vless://…, это компактная запись одного outbound; подписка, это список таких записей; правила в интерфейсе Happ, это раздел routing в удобной форме. Обычному пользователю JSON не нужен: клиент собирает его сам. Он нужен, когда сервис даёт нестандартную схему (несколько серверов в цепочке, особые правила, свои DNS), и тогда INCY импортирует полный JSON целиком, а Happ принимает конфигурации по ссылке. Что такое конфигурация с точки зрения пользователя: конфигурация для Happ; как устроены правила: geosite и geoip.

Частые ошибки ядра и что они значат

• failed to dial / connection refused. Сервер не отвечает на этом адресе и порту: умер, сменил параметры или закрыт фильтрацией. Смените сервер, обновите подписку.
• i/o timeout, context deadline exceeded. Соединение установилось, но ответ не пришёл: фильтрация режет трафик после рукопожатия, типично для серверов без Reality в мобильной сети. Направление для мобильных сетей.
• invalid request / rejected. Сервер не принял идентификатор: ключ скопирован не целиком или подписка истекла.
• tls: handshake failure, REALITY: processed invalid connection. Параметры маскировки не совпали: устаревший ключ, изменённый sni или pbk. Обновите подписку.
• tun: failed to create / operation not permitted. Ядро не может создать TUN-адаптер: нет прав администратора на Windows или root на Linux.
• Антивирус удалил xray.exe. Ядро лежит отдельным файлом в папке клиента, и часть антивирусов считает его подозрительным. Папку в исключения, клиент переустановить.

Коды ошибок Happ с расшифровкой и решениями: ошибки Happ; диагност: Happ не работает.

Обновления ядра: зачем обновлять клиент

Reality, XTLS Vision, новые способы маскировки, исправления под очередное обновление фильтрации, всё это приходит с новыми версиями Xray, а клиенты подтягивают ядро вместе со своими обновлениями. Старая версия клиента с ядром двухлетней давности может не понимать параметры в свежих ключах (например, новые значения flow) и молча не подключаться. Поэтому «обновите приложение» в чек-листах, это не дежурная фраза, а обновление ядра. Официальные источники клиентов: скачать Happ, INCY.

Как посмотреть версию ядра и лог

В Happ версия ядра показана в разделе «О приложении» или в настройках рядом с версией самого клиента; INCY и V2RayTun показывают её там же. Лог ядра открывается из настроек или из меню подключения: именно в нём видны строки вроде failed to dial или REALITY: processed invalid connection, по которым выше разобраны причины. Если пишете в поддержку сервиса, приложите версию ядра и десяток последних строк лога: это ускоряет ответ сильнее, чем скриншот пустого списка.

Почему подписка одна на всех клиентов

Потому что ядро одно, а ключи, это стандартная запись его outbound. Ссылка от сервиса возвращает список vless://-строк, и любой клиент на Xray (или на sing-box с совместимыми протоколами) разберёт его одинаково. Переезд между Happ, INCY и V2RayTun занимает минуту и не требует новой подписки. Пробная подписка X Rocket выдаётся на 24 часа без карты и работает во всех трёх: @X_Rocket_VPN_bot или xrocket.live. Как устроена сама ссылка: ссылка-подписка изнутри.

Частые вопросы