Xray-core или sing-box: сравнение ядер

Xray-core и sing-box — два разных открытых ядра, которые решают похожую задачу: устанавливают защищённое соединение по нескольким прокси-протоколам и умеют маршрутизировать трафик по правилам.

Данные сверены 28 сентября 2026 по официальным страницам обоих проектов и документации Happ. Подробнее о самом Xray-core — на странице Xray-core.

Общий предок и разная история

Xray-core вырос из проекта V2Ray и со временем добавил собственные протоколы и функции — VLESS, Reality, XTLS Vision, транспорт XHTTP. Sing-box создан отдельно, без прямого наследования кода V2Ray, но реализует многие из тех же идей, включая совместимую поддержку VLESS с Reality и Vision. Общий набор протоколов у ядер во многом совпадает, но история и лицензии разные: MPL 2.0 у Xray-core и GPL версии 3 или новее у sing-box.

Что есть только у одного ядра

У sing-box шире набор редких протоколов — TUIC, Naive, Snell, ShadowTLS, AnyTLS, — которых нет в документации Xray-core. У Xray-core в ответ есть собственный транспорт XHTTP, передающий данные протоколов в виде HTTP-запросов. Обе стороны при этом поддерживают базовый набор, важный для Happ: VLESS, VMess, Trojan, Shadowsocks и Hysteria2.

Как sing-box связан именно с Happ

Happ — клиент на ядре Xray-core: соединение с сервером по любому протоколу подписки на всех платформах устанавливает именно оно. Sing-box в документации Happ упоминается отдельно и по другому поводу — как один из движков TUN-подключения на десктопе, наряду с Mux и другими внутренними механизмами Xray-core. Параметр подписки tun-type со значением singbox переключает то, какой код создаёт виртуальный сетевой интерфейс, а параметр custom-tunnel-config передаёт для этого ядра отдельную JSON-конфигурацию туннеля. Протокольная часть подключения при этом не меняется — ей всё равно занимается Xray-core.

Конфигурации не переносятся напрямую

Оба ядра используют похожую по идее структуру JSON с исходящими соединениями, но конкретные названия полей и вложенность отличаются. Администратору, который переносит сервер с одного ядра на другое, придётся переписать конфигурацию, а не просто скопировать файл: базовые параметры протокола — адрес, порт, UUID — переносятся по смыслу легко, а специфичные для ядра блоки нужно собирать заново по документации нового ядра.

Xray-core подойдёт, если:

• нужна оригинальная реализация Reality, XTLS Vision или транспорта XHTTP;
• сервер обслуживает клиентов Happ или другие приложения, построенные именно на этом ядре;
• важна максимальная совместимость с давно распространённым набором панелей и инструкций для VLESS и Trojan.

sing-box стоит рассмотреть, если:

• на сервере нужны протоколы, которых нет в Xray-core, например TUIC или ShadowTLS;
• удобнее вести правила маршрутизации и несколько разных протоколов в одном общем конфиге sing-box;
• на десктопе Happ нужно попробовать альтернативный движок TUN-подключения через параметр tun-type.

Для обычного пользователя Happ выбор ядра для протокола не требуется вообще — это решает Xray-core внутри приложения одинаково на всех платформах.

1. Провайдер подписки на десктопе может задать параметр tun-type со значением singbox, xray, tun2proxy или оставить значение по умолчанию — собственную реализацию Happ TUN.
2. Если выбран singbox, дополнительно может быть передан custom-tunnel-config с JSON-настройками именно для этого ядра.
3. Независимо от выбранного ядра TUN, соединение с сервером по протоколу подписки — VLESS, Trojan, Shadowsocks и другим — устанавливает Xray-core.
4. Обычному пользователю менять эти параметры вручную не нужно: они относятся к расширенным настройкам подписки на стороне провайдера.

Сравнение того, как TUN-режим в целом отличается от системного прокси в Happ, — на странице TUN или системный прокси.