Комплекс NekoBox является графической оболочкой для мощных ядер маскировки трафика (sing-box или Xray). Если клиент не работает как VPN или выдает системные сбои, корень проблемы кроется либо в краше встроенного ядра из-за конфликта портов, либо в отсутствии прав администратора для инициализации виртуального сетевого адаптера.

Почему не запускается или не устанавливается

• Не устанавливается / Не запускается на ПК: архиважная деталь для ОС Windows — клиенту требуются установленные компоненты .NET Desktop Runtime и Microsoft Visual C++ Redistributable. без них ядро программы просто не сможет инициализироваться, выдавая системную ошибку сразу при старте.
• Блокировка Защитником Windows: из-за того, что NekoBox глубоко взаимодействует с сетевыми интерфейсами, встроенный антивирус часто блокирует исполняемые файлы ядра
  nekobox.exe
  и
  sing-box.exe
  . Добавьте всю папку программы в исключения.

Разбор сетевых ошибок в логах (тайм-аут, отказано в соединении, GET)

Откройте вкладку «Логи» (Log) в нижней части интерфейса программы. Поведение NekoBox при сбоях четко типизируется:

1. Ошибка «в соединении отказано» (Connection refused): означает, что графическая оболочка пытается отправить трафик на локальный порт (например, 2080), но само ядро sing-box остановлено или упало. Проверьте, не занят ли этот порт другой программой (например, v2rayNG или Amnezia).
2. Ошибка «тайм аут» (Connection timeout): пакеты до удаленного сервера доходят, но ответ не возвращается. Это главный признак того, что IP-адрес вашего прокси заблокирован ТСПУ провайдера, либо конфигурация ключа (Reality/VLESS) устарела.
3. Ошибка GET (ошибка загрузки подписки): если при обновлении профилей вылетает ошибка get, это значит, что домен, на котором размещена ваша подписка, заблокирован вашим провайдером. Для первоначального обновления требуется использовать альтернативное интернет-подключение.

Конфликты режимов — системный прокси или TUN

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

• Режим системного прокси: Меняет настройки проксирования в самой ОС. Этот режим не работает с http запросами в старых программах и играх, так как они игнорируют настройки системы и пускают трафик напрямую. Он работает преимущественно только в веб-браузерах.
• Режим TUN (виртуальная сетевая карта): перехватывает вообще весь трафик устройства на уровне драйвера (как полноценный VPN). Если TUN выдает ошибку, значит у NekoBox нет прав администратора (нажмите правой кнопкой мыши -> Запуск от имени администратора) или в системе поврежден компонент
  wintun.dll
  .

Что делать, если не работает YouTube и мобильный интернет

Почему NekoBox не работает на мобильном интернете?

Мобильные операторы связи гораздо жестче фильтруют трафик, чем домашние провайдеры. Если на Wi-Fi всё подключается, а на сотовой сети — нет:

1. Зайдите в настройки профиля в NekoBox и принудительно отключите IPv6 (оставьте только IPv4).
2. Измените размер MTU в настройках TUN-режима на
   1280
   или
   1360
   . мобильные вышки часто дропают слишком крупные зашифрованные пакеты.

Не работает YouTube через NekoBox

Если прокси активен, сайты открываются, но не работает YouTube (бесконечное колесико загрузки видео), дело в некорректных правилах маршрутизации (Routing):

• Для ПК: зайдите в Настройки -> Маршрутизация. Убедитесь, что правила GEOIP и GEOSITE для сервисов Google и YouTube перенаправляют трафик в категорию Proxy, а не в Direct (напрямую).
• Для смартфонов: на Android приложение YouTube работает в обход системного прокси. Чтобы заставить его работать, в настройках NekoBox необходимо обязательно включить Режим TUN и в пункте «Проксируемые приложения» отметить галочкой YouTube.

Как исправить системные ошибки

Симптом ошибки	Техническая причина	Метод решения (Фикс)
Connection refused / Отказано	Конфликт локальных портов входящего трафика	В настройках NekoBox изменить порт по умолчанию (например, с 2080 на 3080).
Режим TUN выдает ошибку	Недостаточно прав в ОС Windows / Отсутствует драйвер	Перезапустить программу от имени Администратора, обновить wintun.dll.
Сайты открываются, игры нет	Включен «Системный прокси» вместо сквозного туннеля	Выключить системный прокси, активировать режим TUN.