Xray-core — это открытое сетевое ядро проекта Project X, на котором построены многие клиенты для подписок, в том числе Happ и INCY. Само ядро — программа без привычного интерфейса, а обычному пользователю с готовой подпиской отдельно скачивать его, как правило, не нужно: достаточно клиента и ссылки подписки. Эта страница о ядре Xray в клиентах, а не об автомобиле Lada Xray и не о модах для игр. Ниже — что такое Xray-core, откуда его скачивают, если это действительно нужно, и что проверять при ошибке клиента. Актуально на 29.10.2026.
Что такое Xray-core
В репозитории github.com/XTLS/Xray-core проект описан как «открытая платформа для различных целей», а в README сказано, что Project X вырос из протокола XTLS и даёт набор сетевых инструментов, среди которых Xray-core и REALITY. Лицензия — MPL-2.0. В тематике репозитория указаны VLESS, VMess, Trojan, Shadowsocks, WireGuard, XHTTP и другие технологии. В выпусках репозитория есть архивы ядра для Windows, macOS, Linux, Android и других систем, а графические оболочки в README перечислены как сторонние клиенты.
Последняя версия в репозитории на 29.10.2026 — v26.10.29, опубликована в этот же день. Номера вида «1.21» или «26.2» в запросах «скачать xray» к ядру обычно отношения не имеют: в подсказках они соседствуют с запросами про игру Minecraft. У ядра версия выглядит как v26.10.29.
Ядро, клиент и подписка: кто за что отвечает
| Что | Роль | Пример |
|---|---|---|
| Ядро | Выполняет работу с протоколами и маршрутизацией | Xray-core |
| Клиент | Приложение с интерфейсом: читает ссылку, показывает серверы, запускает ядро | Happ, INCY, v2rayN, v2rayNG |
| Подписка | Ссылка с параметрами серверов, которую выдаёт сервис | Личная ссылка из бота |
README Xray-core перечисляет сторонние клиенты по платформам: для Windows — v2rayN и другие, для Android — v2rayNG и другие, для iOS и macOS — Happ, INCY и другие. Это список из репозитория проекта, а не гарантия, что приложение подходит именно вам. Про Happ разработчик пишет, что он работает на ядре Xray; про клиент v2rayNG его README сообщает, что тот поддерживает ядро Xray и ядро v2fly. Подробнее о приложениях: что такое Happ. Что означают VLESS и Reality внутри профиля, разобрано отдельно: VLESS Reality простыми словами.
Нужно ли обычному пользователю скачивать Xray-core отдельно
Короткий ответ: если вы пользуетесь готовым клиентом, нет, и в документации Happ, которую мы читали, такого шага нет: ни в README компьютерной версии, ни в перечне разделов справки. Но есть оговорка. Официальные README Happ, v2rayN и v2rayNG не говорят прямо, «встроено ли ядро в установщик». Поэтому надёжное правило такое: следуйте инструкции вашего клиента, а отдельный файл ядра качайте только если разработчик клиента прямо этого требует.
Чем является то, что вы скачаете в репозитории XTLS/Xray-core? По странице установки в документации, это ZIP-архивы с консольной программой (xray.exe на Windows, xray на других системах), которая запускается с файлом настроек. Графического окна у неё нет. В последнем выпуске 64 файла: архивы под Windows (включая arm64 и сборку для Windows 7 с суффиксом win7), macOS, Linux, Android и другие системы, рядом с каждым лежит файл .dgst с контрольными суммами. Такая загрузка нужна разработчикам, владельцам серверов и тем, кто сам собирает связку. Для пользователя подписки она, как правило, не нужна.
Откуда скачивать, если нужно
- Только официальные источники. Страница выпусков репозитория XTLS/Xray-core на GitHub и ссылки из его README. В документации сказано: готовые ZIP-архивы лежат в GitHub Releases.
- Клиенты — со страниц их разработчиков. Для Happ это happ.su и его репозиторий, для v2rayN и v2rayNG — репозитории проекта. Файлы из чатов, «сборки с ключами» и архивы со сторонних сайтов не используйте: по внешнему виду безопасный файл от подменённого не отличить.
- Сверяйте суммы. В документации Xray указаны контрольные суммы SHA1 и SHA256 как способ проверить архив, а README v2rayN сообщает, что файлы выпусков подписаны GPG.
Windows может предупредить об установщике. Этот вопрос разобран в статье SmartScreen и антивирус при установке клиента.
Типичные ошибки клиента и что проверять
В официальном разделе «Errors» справки Happ (happ.su/main/faq/errors) перечислены восемь сообщений при добавлении данных. Сообщений с названием «Xray core» в этом разделе нет, так что ошибки вида «критическая ошибка Xray core» или «Xray core returns empty string» в документации Happ не расшифрованы, и точной причины по тексту установить нельзя. Для того, что документировано, действия такие:
| Сообщение в Happ | Что сказано в справке | Что проверить |
|---|---|---|
| Clipboard is empty | Данные не скопированы перед импортом | Скопируйте ссылку и повторите |
| The subscription URL is not valid | В адресе ошибки или лишние символы | Проверьте ссылку в буфере обмена: без пробелов, целиком |
| Configuration … is not valid | В конфигурации ошибки или недопустимые символы | Скопируйте заново из источника |
| Timeout while adding a subscription | Сервер подписки не ответил за 9 секунд | Повторите позже, смените сеть; если не помогло, обратитесь в поддержку |
Остальные сообщения (JSON, deeplink, неизвестный тип данных, профиль маршрутизации) в справке описаны так же коротко. Если ошибка не из списка, действуйте по порядку:
- Обновите подписку в клиенте и выберите другой сервер из списка.
- Обновите клиент из официального источника: в новой версии могут быть исправления, а состав ядра определяет разработчик приложения.
- Смените сеть (мобильная или Wi-Fi) и перезапустите приложение и устройство.
- Попробуйте другой клиент из списка на странице подписки. Если подписка не добавляется, смотрите подписка не импортируется в Happ.
- Соберите данные для поддержки: точный текст ошибки, версию клиента, систему устройства. Саму ссылку подписки никому не отправляйте.
Подписка для клиента на ядре Xray
Подписку WorkVPN можно получить в Telegram-боте: @workvpn77_bot. Путь: «Устройства» → «Моя подписка» → личная ссылка. Её открывают в браузере (на странице выбирают платформу и клиент и нажимают «Добавить подписку») либо вставляют в приложение вручную через «+». Для Android на странице подписки указаны Happ, INCY и v2rayTun, для Windows — Happ, INCY, FlClashX, Koala Clash и Prizrak-Box; для iOS, macOS и ТВ список не подтверждён. Условия на 29.10.2026: новым пользователям 3 дня бесплатно, от 100 ₽ в месяц, безлимитный трафик; уточняйте их в боте. Какое ядро использует каждый из клиентов и на каком протоколе работает WorkVPN, мы не проверяли. Обзор приложений: клиенты для VLESS.
Частые вопросы
Что такое Xray-core простыми словами?
Это открытое ядро проекта Project X: программа, которая отвечает за работу с протоколами. Пользователь видит её через приложение-клиент, например Happ или v2rayN.
Нужно ли скачивать Xray-core отдельно?
Если вы пользуетесь готовым клиентом, как правило, нет. В документации Happ такого шага не найдено. Отдельное ядро скачивайте только по прямому указанию разработчика клиента.
Где скачать Xray-core безопасно?
Только со страницы выпусков репозитория XTLS/Xray-core на GitHub или по ссылкам из его README. Сверяйте контрольные суммы, а файлы из чатов и со сторонних сайтов не используйте.
Что значит «ошибка Xray core» в Happ?
В справке Happ такое сообщение не расшифровано, поэтому точной причины назвать нельзя. Обновите подписку и клиент, смените сервер и сеть, а при повторении отправьте в поддержку текст ошибки и версию приложения.
Это тот же Xray, что в Lada Xray или в Minecraft?
Нет. Имя совпадает случайно: автомобиль и игровые моды к проекту Xray-core не относятся.
Xray-core — это VPN?
Нет. Ядро только работает с протоколами. VPN-услугу даёт сервис, чью подписку вы добавляете в клиент.
Источники и что не подтверждено
- XTLS/Xray-core и его выпуски — описание, лицензия, клиенты, версия v26.10.29; обращение 29.10.2026.
- Документация Xray: установка; обращение 29.10.2026.
- Справка Happ: ошибки и Happ-proxy/happ-desktop; обращение 29.10.2026.
- 2dust/v2rayN и 2dust/v2rayNG; обращение 29.10.2026.
Не подтверждено: встроено ли ядро в каждый клиент, причины сообщения «Xray core» в Happ, версии ядра внутри клиентов. Если заметили неточность, напишите через страницу «Контакты».