NekoBox GitHub: полное руководство по установке, настройке и использованию

Что такое NekoBox и зачем он нужен

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

Основное преимущество NekoBox — поддержка протоколов, устойчивых к активному сканированию трафика (DPI). Если ваш старый VPN-сервис перестал работать, скорее всего, его протокол был распознан и заблокирован. NekoBox умеет маскировать трафик под обычный веб-сёрфинг, что делает его незаменимым инструментом для обхода блокировок и ускорения доступа к зарубежным ресурсам, включая YouTube.

Клиент доступен для Windows (под названием NekoRay) и Android (NekoBox). Обе версии распространяются бесплатно через GitHub. NekoBox является форком SagerNet и заменой Matsuri, но с дополнительными функциями и улучшениями.

Где скачать NekoBox: официальные источники на GitHub

Единственный безопасный источник для загрузки NekoBox — официальный репозиторий на GitHub. Скачивание с сомнительных форумов может привести к установке вредоносного ПО.

Для Windows (NekoRay):

1. Перейдите на страницу релизов проекта MatsuriDayo/Nekoray.
2. Найдите файл с расширением .exe (обычно это архив nekoray-x.xx-windows64.zip).
3. Распакуйте архив в удобную папку. Установка не требуется — программа работает в портативном режиме.

Для Android (NekoBox):

1. Перейдите на страницу релизов MatsuriDayo/NekoBoxForAndroid.
2. Скачайте APK-файл, соответствующий архитектуре вашего устройства (arm64-v8a для большинства современных смартфонов).
3. Разрешите установку из неизвестных источников и дайте приложению разрешение на работу в фоне.

При первом запуске на Windows программа может запросить выбор ядра. Рекомендуется выбирать sing-box для новейших протоколов (Reality, VLESS) или Xray для классических задач.

Поддерживаемые протоколы и плагины

NekoBox поддерживает широкий спектр прокси-протоколов, что делает его универсальным инструментом. Встроенная поддержка включает:

• SOCKS (4/4a/5)
• HTTP(S)
• SSH
• Shadowsocks
• VMess
• VLESS
• WireGuard
• Trojan
• TUIC
• Trojan-Go
• NaiveProxy
• Hysteria 1/2
• AnyTLS
• ShadowTLS
• Mieru

Кроме того, для некоторых протоколов доступны плагины, расширяющие функциональность. Например, плагины для TUIC и Hysteria позволяют использовать продвинутые возможности, такие как port hopping (сканирование портов) без необходимости ручной настройки.

Важно отметить, что использование плагинов может ограничивать возможность построения прокси-цепочек. В некоторых случаях, например, при попытке создать цепочку Shadowsocks + WireGuard, плагины могут работать некорректно. В таких ситуациях рекомендуется использовать встроенную поддержку протоколов без дополнительных плагинов.

Как настроить NekoBox: импорт профиля и первичная настройка

Для работы NekoBox необходим конфигурационный файл сервера (ключ). Самый простой способ запустить VPN — скопировать ключ в буфер обмена и импортировать его в программу.

На Windows (NekoRay):

1. Скопируйте ключ (строка, начинающаяся с vless://, vmess:// или trojan://).
2. Запустите программу.
3. В верхнем меню выберите Program → Add profile from clipboard.
4. Сервер появится в списке. Нажмите на него правой кнопкой мыши и выберите Start.
5. Включите System Proxy в верхней панели, чтобы трафик браузера пошёл через VPN.

На Android:

1. Скопируйте ключ на телефоне.
2. Откройте приложение NekoBox. Оно часто само предлагает импортировать настройки из буфера. Если нет — нажмите иконку «плюс» и выберите Import from Clipboard.
3. Нажмите большую кнопку подключения внизу экрана.

Ручное добавление сервера: Если у вас нет готовой ссылки, а есть только параметры (IP, порт, UUID, Public Key), можно добавить сервер вручную:

1. Нажмите Server → Add profile.
2. Выберите тип протокола (VLESS, Trojan, Shadowsocks и т.д.).
3. Заполните поля: Address (IP сервера), Port, ID (UUID).
4. Для Reality заполните поля в разделе Stream Settings → Reality (Public Key, Short ID, SNI).

Автоматический импорт через буфер обмена предпочтительнее, так как исключает ошибки при ручном вводе.

Гибкая маршрутизация трафика: кастомные правила

Одна из ключевых возможностей NekoBox — настройка правил маршрутизации в формате JSON. Это позволяет, например, направлять трафик YouTube через VPN, а Госуслуги — напрямую.

Пример кастомных правил:

{
  "rules": [
    { "domain_suffix": ["google.com", "www.myip.com"], "outbound": "proxy" },
    { "domain_keyword": ["myip", "2ip"], "outbound": "proxy" },
    { "outbound": "proxy", "process_name": ["firefox.exe", "Guilded.exe"] }
  ]
}

• domain_suffix — направляет через прокси все домены, оканчивающиеся на указанные строки.
• domain_keyword — направляет через прокси домены, содержащие ключевые слова.
• process_name — направляет через прокси весь трафик указанных процессов.

Outbound по умолчанию — bypass, что обеспечивает корректную работу белого списка в настройках TUN-режима. Если правила не заданы для конкретного процесса или домена, трафик идёт напрямую.

Также поддерживаются правила на основе GEOIP (геолокации IP-адресов) и geosite (категорий сайтов). Например, можно закомментировать правила для RU и US, чтобы трафик на эти страны шёл через прокси или напрямую.

Режим TUN: полный перехват трафика

Режим TUN (Tunnel) создаёт виртуальный сетевой интерфейс, через который проходит весь трафик устройства, включая UDP-пакеты (важно для голосовых каналов, игр и стриминга). Это решает проблему, когда браузер работает через VPN, а приложение YouTube — нет.

Как включить TUN Mode:

1. В верхней панели найдите кнопку TUN Mode.
2. Нажмите её. Программа может запросить перезапуск с правами администратора — соглашайтесь.
3. После активации создаётся виртуальный адаптер, и NekoBox перехватывает все пакеты.

Проверка работы: В логах (внизу окна) должны появиться строки вида:

[Info] inbound/tun[tun-in]: inbound connection to 1.1.1.1:53
[Info] outbound/vless[proxy]: outbound connection to 1.1.1.1:53

Это означает, что перехват работает корректно.

Важно: Для работы TUN-режима при автозагрузке могут потребоваться права администратора. Если программа не запускается с TUN при старте системы, попробуйте добавить её в автозагрузку через планировщик задач Windows или настройки Android.

Решение проблем с YouTube через NekoBox

Главная причина установки NekoBox — замедление YouTube. Простое подключение к серверу может не дать желаемого эффекта. Для оптимальной работы необходимо:

1. Выбрать подходящий сервер:

• Используйте функцию URL Test (Ctrl+T на Windows), чтобы проверить задержку (ping) и скорость.
• Выбирайте серверы с минимальным пингом (зелёные значения).
• Для потокового видео 4K важна не только задержка, но и ширина канала.

1. Включить TUN Mode:

• Это заставит весь трафик устройства, включая фоновые процессы плеера, идти через зашифрованный канал.

1. Проверить синхронизацию времени:

• Протоколы VLESS и VMess критически зависят от времени на устройстве. Если часы отстают или спешат более чем на 90 секунд, соединение не установится. Синхронизируйте время в настройках ОС.

1. Использовать современные протоколы:

• Reality (разновидность VLESS) считается самым надёжным для скрытия факта использования VPN. Если провайдер блокирует стандартные протоколы, ищите именно Reality.

Если YouTube продолжает тормозить, попробуйте сменить локацию сервера. Некоторые провайдеры (например, ComfyVPN) предлагают серверы, оптимизированные под потоковое видео.

Частые ошибки и их решение

Даже у опытных пользователей возникают проблемы. Рассмотрим основные сбои и способы их устранения.

Не подключается VPN:

• Проверьте время на устройстве. Разница более 90 секунд блокирует VLESS/VMess.
• Антивирус может блокировать локальный порт прокси. Добавьте nekobox.exe в исключения.
• Убедитесь, что выбран правильный протокол и заполнены все поля (особенно для Reality).

Ошибка ядра (Core error):

• Зайдите в настройки: Preferences → Basic Settings.
• Нажмите Check Update напротив Core. Программа сама скачает актуальную версию sing-box или xray.

Зависание приложения:

• Некоторые версии NekoBox могут зависать при длительной работе. Попробуйте обновить клиент до последней версии с GitHub.
• Если проблема сохраняется, переключитесь на другую версию ядра (например, с Xray на sing-box).

Прокси-цепочка не работает:

• Плагины могут блокировать построение цепочек. Используйте встроенную поддержку протоколов без плагинов.
• Например, для цепочки Shadowsocks + WireGuard попробуйте импортировать WireGuard-профиль отдельно и настроить маршрутизацию вручную.

Проблемы с автозагрузкой:

• TUN-режим может не включаться при автозапуске из-за недостатка прав. Добавьте программу в автозагрузку через планировщик задач с правами администратора.

Где взять рабочие конфигурации

Сам по себе NekoBox — это «двигатель», которому нужно «топливо» в виде конфигураций серверов. Источников несколько:

1. Публичные списки: Бесплатно, но часто медленно и нестабильно. Ключи живут от нескольких часов до пары дней.

1. Свой сервер: Покупка VPS и развёртывание панели (например, 3X-UI). Надёжно, но требует знаний Linux.

1. Telegram-боты и провайдеры: Оптимальный вариант для большинства пользователей. Например, ComfyVPN предоставляет готовые ключи доступа с высокой скоростью и низким пингом. Это избавляет от необходимости администрировать сервер самостоятельно.

При выборе провайдера обращайте внимание на поддержку современных протоколов (Reality, VLESS) и наличие серверов, оптимизированных под стриминг. Некоторые боты предлагают пробный период для тестирования.

Заключение: итоговый чек-лист

NekoBox — это мощный инструмент для тех, кто хочет получить полный контроль над своим интернет-соединением. Он сложнее обычных VPN-приложений, но даёт несравнимо больше возможностей по настройке маршрутизации и выбору протоколов.

Итоговый чек-лист для быстрого старта:

1. Скачайте клиент с официального GitHub.
2. Получите рабочий ключ (например, через Telegram-бота).
3. Импортируйте ключ в программу.
4. Включите TUN Mode для полного перехвата трафика.
5. Настройте кастомные правила маршрутизации при необходимости.
6. Проверьте синхронизацию времени на устройстве.
7. Наслаждайтесь свободным и быстрым интернетом.

Если вам не хочется вникать в дебри маршрутизации и настройки ядер, существуют сервисы, которые предоставляют готовые решения. Однако для максимальной гибкости и контроля NekoBox остаётся одним из лучших выборов.

Вопросы и ответы