Skip to content

goshkow/Zapret-Hub

Repository files navigation

⭐️ Пожалуйста, поставьте звезду этому репозиторию, чтобы бесплатно поддержать меня.

Это - версия для Windows

Скачать последнюю версию

Zapret Hub - Windows-приложение для удобного управления zapret и tg-ws-proxy из одного интерфейса.

Для обычных пользователей - без bat-файлов, поиска папок и правки конфигов в блокноте, абсолютно бесплатно!

Zapret Hub banner

Скачать последнюю версию

Отправить пожертвование

Автор: goshkow • GitHub

Что-то не работает? • ИсправитьСоздать issue

💡 Что это такое

Проект объединяет в одном окне:

✅ запуск/остановку Zapret и TG WS Proxy
✅ автоматическую загрузку и работу в трее
✅ выбор general-конфигураций для zapret
✅ гибкий импорт модификаций
✅ диагностику и тестирование
✅ просмотр логов и редактирование файлов
✅ возможность настраивать как Zapret, так и TG WS Proxy

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

✨ Возможности

Фича Описание
🎮 Единая кнопка Включение/отключение обходов одним кликом
⚙️ Гибкая работа Можно включать и выключать компоненты отдельно
🔷 Остается в трее Не нужно держать окно постоянно открытым
❤️‍🩹 Настройки в трее Можно быстро менять конфиги через меню в трее
🌙 Работа в фоне Оставляет фоновые процессы только при работе обходов
📦 Моды Импорт модификаций из папки/ZIP/GitHub/файлов
🔍 Диагностика Тестирование general'ов + логи
🎨 UI На выбор есть 3 темные и 2 светлые темы, RU/EN языки
🚀 Автозапуск Можно включить запуск программы вместе с Windows
📱 Форматы Portable + universal установщик (x64/ARM64)
🛡️ Безопасность Отдельный runtime, бэкапы базовых файлов

🛠 Модификации

🔹 Программа хранит все моды отдельно от других файлов
🔹 Не трогает базовые файлы, поэтому использование нескольких модификаций безопасно
🔹 Собирает модификации в одну - позволяет выбрать один из запретов, а списки собирает из всех включенных модификаций
🔹 Позволяет импортировать general/списки из GitHub/ZIP/Папок и файлы отдельно

Important

Из модификаций не подтягиваются настройки ipset mode и gaming mode - их можно настроить отдельно в настройках (шестеренка сверху справа)

Меню модификаций

💻 Требования

  • 🪟 Windows 10/11

Для разработки:

🐍 Python 3.11

⚡ PowerShell 5+ / 7+

📦 Portable и Installer

В проекте используются три основных формата поставки:

  • portable\win_x64 — portable для Windows x64;
  • portable\win_arm64 — portable для Windows ARM64;
  • install_zaprethub.exe — установщик.

🔗 Используемые проекты

Инструмент Автор
zapret-discord-youtube Flowseal
tg-ws-proxy Flowseal
zapret экосистема bol-van

Caution

Авторство

Zapret Hub = интерфейс + менеджер поверх этих инструментов.

В самой программе дважды указаны инструменты и их авторство.

↪️ Для разработчиков

Important

При разработке проектов на основе Zapret Hub обязательно указывайте оригинального автора и авторов инструментов, перечисленных выше. Этого требует лицензия MIT

📁 Структура проекта

Основные каталоги:

  • 📂 src/zapret_hub — прикладная логика, UI и сервисы;
  • 📂 installer — код установщика;
  • 📂 packaging.spec-файлы PyInstaller;
  • 📂 runtime — встроенные runtime-файлы bundled-инструментов;
  • 📂 sample_data — стартовые данные проекта;
  • 📂 ui_assets — иконки и UI-ресурсы.

Рабочие каталоги, которые появляются во время использования приложения:

  • 📂 data
  • 📂 logs
  • 📂 cache
  • 📂 mods
  • 📂 merged_runtime
  • 📂 backups

🧪 Запуск в разработке

python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .[dev]
python -m zapret_hub.main

🔨 Сборка

Приложение

.venv\Scripts\python.exe -m PyInstaller -y packaging\zapret_hub.spec

Результат: dist\zapret_hub\

Установщик

.venv\Scripts\python.exe -m PyInstaller -y packaging\install_zaprethub.spec

Результат: dist\install_zaprethub.exe

Не работает

Warning

Ругается антивирус

В программу встроен WinDivert - это инструмент для перехвата и фильтрации трафика, необходимый для работы компонента zapret.

Его могут использовать злоумышленники, но сам по себе он не является вирусом.

Некоторые антивирусы склонны относить файлы WinDivert к классам повышенного риска или хакерским инструментам. Происходит удаление файла и помещение его в карантин. При этом детект обязательно имеет название WinDivert или Not-a-virus:RiskTool.Multi.WinDivert

В случае проблем с антивирусом добавьте папку с Zapret Hub в исключения, либо отключите детектирование PUA (потенциально нежелательных приложений). Например, в касперском есть галочка "Обнаруживать легальные приложения, которые злоумышленники часто используют для нанесения вреда". При аккуратной и правильной настройке исключений - рекомендуется настроить исключение, но если вы не до конца понимаете что делаете - рекомендуется отключить детект PUA.

Important

Не работают обходы

При любых ошибках и подтормаживаниях попробуйте:

  1. Установить Gaming mode: tcp + udp
  2. Установить IPset Mode: Loaded
  3. Включить Unified модификацию
  4. Запустить тест конфигураций в Инструментах (Иконка рядом с шестеренкой сверху справа приложения)
  5. Включить Secure DNS в Windows:
    IPv4: 8.8.8.8 и доп: 8.8.4.4
    IPv6: 2001:4860:4860::8888 и доп: 2001:4860:4860::8844
    Запасной вариант - IPv4: 77.88.8.1 и доп: 1.1.1.1