Custom Neko-Client

Кастомная переделка NekoBox - VPN клиент на базе sing-box для Windows.

📋 Описание

Custom Neko-Client - это модифицированная версия NekoBox с расширенным функционалом, улучшенным интерфейсом и дополнительными возможностями безопасности. Клиент использует ядро nekobox_core.exe (sing-box) для работы VPN через TUN интерфейс.

📦 Установка

Требования

• Windows 10/11
• Python 3.13 (для сборки)

Сборка из исходников

1. Клонируйте репозиторий:

git clone <repository-url>
cd CustomNekobox

2. Установите зависимости:

pip install -r requirements.txt

3. Поместите необходимые файлы:

   • nekobox_core.exe в resources/core/
   • nekobox_core.sha256 в resources/core/
   • geoip.db и geosite.db в resources/data/
   • nekobox.png в resources/images/
   • success_start.mp3 и failed_start.mp3 в resources/sounds/

4. Соберите исполняемый файл:

.\build.ps1

Готовый .exe будет в папке dist/

⚙️ Настройки

Доступны в меню Settings:

• Traffic Rules - выбор режима маршрутизации
• Kill Switch - блокировка интернета при отключении VPN
• Auto Reconnect - автоматическое переподключение
• DNS Leak Protection - защита от утечек DNS
• Language - выбор языка
• Log Level - уровень детализации логов
• TUN/DNS - настройки TUN интерфейса и DNS серверов
• Autostart - автозапуск с Windows
• Tray - работа в системном трее

✅ Плюсы

1. Расширенная функциональность

   • Kill Switch для максимальной безопасности
   • DNS Leak Protection
   • Автоматическое переподключение
   • Health Check мониторинг

2. Удобный интерфейс

   • Современный дизайн
   • Локализация (RU/EN)
   • Работа в системном трее
   • Интуитивное управление

3. Гибкая настройка

   • Множество режимов трафика
   • Настройка TUN/DNS параметров
   • Структурированное логирование
   • Автоочистка логов

4. Безопасность

   • Проверка целостности ядра (SHA256)
   • Изолированное хранение данных
   • Защита от утечек DNS
   • Kill Switch для защиты данных

5. Мониторинг

   • Статистика трафика в реальном времени
   • Отображение IP и геолокации
   • Таймер сессии
   • Тесты соединения

6. Удобство использования

   • Автозапуск
   • Работа в трее
   • Быстрое переключение серверов
   • Автовыбор сервера

⚠️ Минусы

1. Платформа

   • Работает только на Windows

2. Зависимости

   • Требует внешний бинарный файл nekobox_core.exe
   • Зависит от баз данных geoip.db и geosite.db
   • Необходим Python 3.13 для сборки

3. Сложность настройки

   • Требует ручной настройки серверов
   • Для некоторых функций нужны дополнительные настройки
   • NekoBox-совместимый режим требует экспорта шаблона

4. Производительность

   • GUI на Tkinter (не самый быстрый фреймворк)
   • Может потреблять больше памяти чем нативный клиент

5. Функциональность

   • Kill Switch реализован упрощенно (Windows firewall API)
   • DNS Leak Protection базовая версия
   • Health Check требует доработки
   • Нет поддержки других протоколов кроме VLESS

6. Поддержка

   • Кастомная версия, не связана с официальным NekoBox
   • Возможны проблемы совместимости при обновлении ядра
   • Ограниченная документация

🔒 Безопасность

• Клиент использует проверенную криптографию через sing-box
• Все конфигурации хранятся локально
• Проверка целостности ядра перед запуском
• Логи не содержат чувствительных данных (UUID, ключи)

📝 Лицензия

Проект основан на NekoBox (GPL-3.0). Проверьте лицензию оригинального проекта.

🙏 Благодарности

• NekoBox - оригинальный проект
• sing-box - ядро VPN

---

Примечание: Это кастомная версия клиента. Используйте на свой риск. Для критически важных задач рекомендуется использовать официальные проверенные решения.