Xray и sing-box в NekoBox: выбор core и совместимость

При настройке NekoBox вы столкнетесь с выбором core — движка, который непосредственно обрабатывает подключение. В приложении доступны Xray и sing-box. Оба поддерживают популярные протоколы, но по-разному интерпретируют конфигурацию, правила и логи. Если вы импортируете профиль, созданный для Xray, и переключаетесь на sing-box, возможны ошибки или потеря части настроек. Эта статья поможет разобраться, какой core выбрать и как настроить профиль так, чтобы он корректно работал в NekoBox.

Чем отличаются Xray и sing-box в NekoBox

Xray — это преемник V2Ray, широко используемый для проксирования и обхода блокировок. sing-box — универсальное ядро, которое поддерживает не только прокси-протоколы, но и VPN-технологии, включая WireGuard. В NekoBox оба ядра работают с одними и теми же протоколами (VLESS, VMess, Trojan, Shadowsocks), но конфигурация у них разная. Xray использует JSON-файлы с полями inbounds, outbounds и routing. sing-box тоже использует JSON, но структура и названия полей отличаются: например, вместо routing используется route, а правила имеют другую логику сопоставления.

На практике это означает, что профиль, скачанный с панели, может быть в формате Xray или sing-box. NekoBox автоматически определяет тип при импорте, но если вы вставляете ссылку напрямую, важно следить, чтобы выбранный core соответствовал формату. В большинстве случаев.

Форматы профилей: как импортировать без ошибок

NekoBox поддерживает импорт по ссылке (vless://, vmess://), из буфера обмена и из файла. Если вы используете ссылку, приложение само преобразует её в конфигурацию текущего core. Однако при ручном редактировании JSON нужно учитывать синтаксис конкретного ядра.

Для Xray типичная структура профиля включает:

{
  "dns": {},
  "inbounds": [{}],
  "outbounds": [{}],
  "routing": {}
}

Для sing-box структура выглядит иначе: inbounds и outbounds есть, но вместо routing используется route, а правила задаются через rules с другими условиями. При переключении core в приложении профиль может не конвертироваться автоматически. Рекомендуется хранить отдельные профили для Xray и sing-box либо использовать генераторы, которые выдают конфиг под выбранный core. Перед импортом проверяйте, какой core выбран в NekoBox в настройках подключения.

Правила маршрутизации: что важно знать

Правила определяют, какие адреса или домены пойдут через прокси, а какие напрямую. В Xray правила задаются в блоке routing.rules с полями domain, ip, port и действиями proxy или direct. sing-box использует более гибкий синтаксис: правила могут быть объединены в цепочки, поддерживают гео-данные (geosite, geoip) и действуют по принципу “первое совпадение”.

Если вы переносите правила из Xray в sing-box, обратите внимание на типы полей. Например, в Xray domain может быть строкой или массивом, а в sing-box требуется использовать domain_suffix или domain_keyword. Игнорирование этих различий приведет к тому, что правило не сработает, и трафик пойдет по неверному маршруту. В NekoBox при выборе core автоматически подсказывается формат, но лучше проверить документацию.

Логи: где искать ошибки

Логи помогают диагностировать проблемы с подключением, маршрутизацией и DNS. В NekoBox логи доступны через меню “Логи” (или “Журнал”). Уровень логирования можно настроить в настройках приложения: от error до debug. При выборе core логи будут выводиться в общем интерфейсе, но формат сообщений отличается. Xray пишет более подробные строки с указанием времени и уровня, sing-box использует компактный формат.

Если подключение не работает, включите debug-логи и посмотрите на последние записи. Ошибки вида connection rejected или failed to handshake указывают на проблему с протоколом или сервером. Также логи помогут понять, срабатывают ли правила: в режиме debug вы увидите, какое правило применено к запросу. Это особенно полезно при переносе конфигурации между core.

Какой core выбрать в NekoBox

Выбор core зависит от ваших задач. Если вы используете стандартные протоколы и не нуждаетесь в тонкой настройке, оба ядра работают одинаково. Xray более распространен в готовых конфигурациях, особенно из панелей, поэтому для быстрого импорта выбирайте Xray. sing-box может быть полезен, если вы используете WireGuard или другие технологии, которые Xray не поддерживает. Также sing-box часто называют более производительным на слабых устройствах, но в NekoBox разница незначительна.

Если вы планируете использовать расширенные правила маршрутизации, ознакомьтесь с документацией выбранного ядра. В NekoBox можно переключать core в любой момент, но профиль нужно будет адаптировать. Для этого удобно держать оба варианта конфигурации или использовать инструменты конвертации.

Совместимость с протоколами и настройками

Оба core поддерживают VLESS, VMess, Trojan, Shadowsocks, а также WebSocket, gRPC и другие транспорты. Однако есть нюансы. Например, Xray поддерживает флаг flow для VLESS (XTLS), а sing-box также поддерживает, но синтаксис может отличаться. При использовании reality или vision обязательно сверяйте версию ядра и наличие поддержки в вашей сборке NekoBox.

Если вы создаете профиль вручную, используйте только безопасные плейсхолдеры. Не вставляйте реальные ключи и токены. Также не забывайте, что NekoBox — клиент, и он должен быть совместим с сервером. Если сервер настроен на Xray, а вы используете sing-box, это обычно работает, но некоторые расширенные параметры могут игнорироваться. В спорных случаях оставляйте core, рекомендованный серверной панелью.

Пошаговая диагностика при переключении core

Если вы переключили core, и соединение перестало работать, выполните следующие шаги:

1. Проверьте, какой формат профиля импортирован: JSON Xray или sing-box. Откройте профиль и посмотрите на корневые ключи.
2. Сверьте версию NekoBox с актуальной: в новых версиях синтаксис ядер может отличаться.
3. Включите подробные логи (уровень debug) и воспроизведите подключение. Изучите ошибки.
4. Если ошибка связана с маршрутизацией, упростите правила до минимума и добавляйте по одному.
5. При использовании VLESS с flow проверьте, что параметры совпадают с серверными.

В большинстве случаев проблема решается пересозданием профиля под выбранный core. Не пытайтесь редактировать конфиг вручную, если не уверены в синтаксисе.

Для углубленного изучения VLESS в NekoBox читайте нашу инструкцию по настройке VLESS-профиля. Если вы используете прокси в браузере, обратите внимание на настройку браузерного прокси. Общие принципы работы с приложением описаны на главной странице NekoBox Wiki.