Zapret Hub is a Windows application designed to simplify the management of zapret and TG WS Proxy from a single graphical interface. It eliminates the need for manual batch file execution, folder searches, or configuration edits in text editors, offering an intuitive and free solution for users.
Key Features:
Unified interface with one-click controls for starting/stopping proxies.
Automatic background processes and system tray integration.
Flexible configuration options, including support for multiple modifications (mods).
Language themes and customization options for both dark and light modes.
Diagnostic tools and log viewers for troubleshooting.
Import functionality for mods from GitHub, ZIP files, or local folders.
Audience & Benefit:
Ideal for Windows users who need a user-friendly yet powerful tool to manage network proxies without complex setups. Zapret Hub saves time and effort by consolidating proxy management into a single, accessible interface.
README
Официальный сайт проекта и дополнительный источник актуальных сборок:
👇👇👇
👆👆👆
⭐️ Пожалуйста, поставьте звезду этому репозиторию, чтобы бесплатно поддержать проект.
Zapret Hub — единое Windows-приложение для управления сетевыми подключениями, DNS и совместимыми компонентами.
Вместо ручного поиска скриптов и конфигураций можно выбрать подходящий способ подключения, доверить настройку автоматике и управлять всем из одного окна. В приложении доступны Zapret, Zapret 2, goshkow VPN, DNS-серверы и TG WS Proxy.
Zapret Hub подходит и опытным пользователям, и тем, кому нужен понятный интерфейс для настройки соединения без ручного редактирования скриптов и конфигураций.
✅ объединяет несколько независимых способов подключения в одном интерфейсе;
✅ помогает выбрать подходящий вариант при первом запуске;
✅ автоматически проверяет конфигурации и запоминает рабочую;
✅ позволяет в любой момент переключить способ подключения в Быстром доступе;
✅ устанавливает и обновляет дополнения через встроенный Zapret Marketplace;
✅ работает в трее, показывает понятные статусы и хранит настройки локально;
✅ не использует рекламную аналитику; технические данные Marketplace и диагностики описаны в пользовательском соглашении.
> [!NOTE]
> Выбор при первом запуске определяет только то, какой способ будет настроен первым. Позже между режимами можно свободно переключаться.
🧭 Первый запуск
Онбординг проводит пользователя через настройку без необходимости редактировать bat-файлы или разбираться во внутреннем устройстве компонентов.
Выберите основной сетевой компонент. Доступны Zapret, Zapret 2, goshkow VPN и вариант «Без основного компонента».
Ответьте на несколько вопросов. Набор шагов зависит от выбранного способа.
Дождитесь проверки. Для Zapret и Zapret 2 оркестратор переберёт конфигурации и выберет рабочую.
Запустите приложение. Готовый режим появится на странице быстрого доступа.
Если выбран Zapret
Можно отметить нужные сайты и приложения вручную или оставить автоматическую настройку. Программа подготовит правила для выбранных сервисов, проверит доступные general-конфигурации и сохранит лучший результат.
Если выбран Zapret 2
Оркестратор проверит стратегии Zapret 2 и подготовит рабочую конфигурацию автоматически. При необходимости параметры и дополнения можно изменить позже.
Если выбран goshkow VPN
Потребуется ключ подписки vpn.goshkow.com. Его можно вставить из буфера обмена прямо в приложении. Для новых пользователей доступен бесплатный пробный период.
Если выбран режим «Без основного компонента»
Zapret, Zapret 2 и VPN запускаться не будут. При этом можно отдельно использовать DNS или TG WS Proxy.
🔀 Способы подключения
Способ
Для чего нужен
Как настраивается
🛡️ Zapret
Локальная обработка сетевого трафика без передачи всего соединения через VPN
Выбор сервисов, модификаций и general; ручная настройка или оркестратор
🔷 Zapret 2
Новое поколение Zapret на winws2 с Lua-стратегиями
Автоматический анализ стратегий или ручная настройка
🟣 goshkow VPN
VPN-подключение для всего устройства или выбранных процессов
Ключ подписки, выбор локации и режима маршрутизации
🌐 DNS
Замена системных DNS-серверов
DHCP, Xbox DNS, Cloudflare, AdGuard, Google или Яндекс
✈️ TG WS Proxy
Локальный прокси для Telegram Desktop
Подключение Telegram из раздела компонентов
⚪ Без основного компонента
Работа без Zapret, Zapret 2 и VPN
Можно оставить только вспомогательные компоненты
> Запуск одного режима не ограничивает доступ к остальным. Активный способ можно быстро изменить на главной странице или через меню в трее.
🧠 Автоматическая настройка
Встроенный оркестратор избавляет от бесконечного ручного перебора конфигураций.
Для Zapret он учитывает выбранные сервисы, последовательно проверяет general-конфигурации и сохраняет рабочий вариант. Для Zapret 2 он анализирует доступные стратегии и применяет подходящую. Результат остаётся доступен для ручной корректировки: автоматика помогает начать работу, но не забирает контроль у пользователя.
🛍️ Zapret Marketplace
Zapret Marketplace — встроенный каталог дополнений для Zapret и Zapret 2. Больше не нужно вручную искать архивы, определять совместимую версию и раскладывать файлы по папкам.
Через Marketplace можно:
🔹 просматривать каталог и страницы проектов;
🔹 устанавливать дополнения в Zapret Hub одним нажатием;
🔹 получать подходящую версию для Zapret или Zapret 2;
🔹 обновлять уже установленные дополнения;
🔹 публиковать собственные проекты.
Marketplace имеет открытый API и не привязан исключительно к Zapret Hub. Другие GUI-приложения и независимые клиенты тоже могут использовать каталог, получать сведения о проектах и работать с дополнениями. Zapret Hub предлагает нативную интеграцию как самый простой путь, но не ограничивает пользователей одной программой.
✨ Возможности
Функция
Описание
🎮 Единая кнопка
Включение и отключение выбранного способа подключения одним нажатием
🔁 Быстрое переключение
Смена Zapret, Zapret 2, VPN и режима без основного компонента без поиска настроек
🧠 Оркестратор
Автоматический подбор рабочих конфигураций для Zapret и Zapret 2
🧭 Сервисы
Настройка под конкретные сайты, игры, приложения, CDN и лаунчеры
🛍️ Marketplace
Нативная установка и обновление дополнений из открытого каталога
🧩 Маршрутизация VPN
Системный прокси, TUN, правила маршрутизации и выбор процессов
🌐 DNS
Быстрый выбор системного DNS-провайдера или возврат к DHCP
📦 Модификации
Импорт из Marketplace, ZIP, папки, GitHub или отдельных файлов
📁 Файлы
Редактирование пользовательских списков и конфигураций Zapret
📋 Логи
Раздельные журналы компонентов с переходом к последним событиям
🔔 Уведомления
Сообщения внутри приложения и уведомления Windows
🔊 Звуки
Звуковое сопровождение действий и состояний с возможностью отключения
🎨 Интерфейс
Темы Aurora, Obsidian и Concrete, русский и английский языки
🔷 Трей
Управление состоянием и способом подключения без открытия окна
🚀 Автозапуск
Запуск программы и выбранных компонентов вместе с Windows
💫 Обновления
Обновление приложения, компонентов и Marketplace-дополнений
📱 Архитектуры
Отдельные portable-сборки для Windows x64 и ARM64
🎀 Компоненты
Раздел Компоненты показывает состояние каждого встроенного инструмента и открывает его настройки.
В нём можно обновить Zapret и Zapret 2, повторно запустить настройку Zapret, подключить ключ goshkow VPN, связать TG WS Proxy с Telegram и выбрать DNS-провайдера. Основной способ подключения переключается через быстрый доступ, а вспомогательные компоненты управляются отдельно.
🛡️ goshkow VPN
goshkow VPN — встроенный VPN-режим, работающий с подпиской vpn.goshkow.com.
Он поддерживает:
🔹 выбор доступной локации;
🔹 TUN для системного подключения;
🔹 глобальную маршрутизацию, чёрный и белый списки;
🔹 системный прокси и PAC;
🔹 проксирование только выбранных процессов;
🔹 локальный счётчик использованного трафика;
🔹 бесплатный пробный период на 10 дней.
> goshkow VPN — необязательный платный компонент. Zapret, Zapret 2, DNS, TG WS Proxy, Marketplace и остальные функции приложения доступны независимо от подписки.
🌐 DNS
Компонент DNS меняет системные DNS-серверы без ручного открытия настроек Windows. Доступны системный DHCP, Xbox DNS, Cloudflare, AdGuard, Google и Яндекс. Приложение показывает конкретные адреса перед выбором и позволяет в любой момент вернуться к автоматическим настройкам роутера или провайдера.
DNS можно использовать самостоятельно или вместе с Zapret, Zapret 2 и VPN.
🛠️ Модификации
🔹 базовые файлы и пользовательские дополнения хранятся отдельно;
🔹 несколько включённых модификаций собираются в единый runtime;
🔹 поддерживаются Marketplace, ZIP, папки, GitHub и отдельные файлы;
🔹 модификации можно создавать и редактировать внутри приложения;
🔹 при изменениях merged runtime пересобирается автоматически.
📁 Файлы
Встроенный редактор позволяет работать с пользовательскими доменами, IP-адресами, исключениями, hosts и другими конфигурационными файлами Zapret. Раздел предназначен для продвинутой настройки; для обычного запуска редактировать файлы вручную не требуется.
📦 Установка
В релизе публикуются:
zapret_hub_<версия>_portable_win_x64.zip — portable для большинства компьютеров Windows;
zapret_hub_<версия>_portable_win_arm64.zip — portable для Windows on ARM;
install_zaprethub_<версия>.exe — slim-установщик, который определяет архитектуру и загружает подходящую сборку;
winget-manifests-<версия>.zip — манифесты автоматической установки через WinGet.
Для обычной установки скачайте install_zaprethub_<версия>.exe из последнего релиза. Portable-версию достаточно распаковать в отдельную папку.
После публикации пакета в общем каталоге WinGet установка будет доступна командой:
winget install --id Goshkow.ZapretHub
💻 Требования
Windows 10 или Windows 11;
права администратора для управления сетевыми компонентами;
подключение к интернету для slim-установщика, Marketplace и обновлений.
> [!CAUTION]
> Zapret Hub — интерфейс и менеджер поверх перечисленных инструментов. Приложение не присваивает авторство встроенных проектов; сведения об авторах и исходниках доступны в самом приложении.
⚖️ Условия использования
Устанавливая или используя Zapret Hub, пользователь принимает пользовательское соглашение. Программа предназначена для законного управления сетевыми подключениями, DNS и совместимыми компонентами; пользователь самостоятельно проверяет допустимость выбранной конфигурации.
Для каталога дополнений действует отдельное соглашение Zapret Marketplace. Сообщения о нарушениях прав, незаконных материалах и уязвимостях принимаются по адресу iagoshkow@gmail.com.
↪️ Для разработчиков
> [!IMPORTANT]
> При разработке проектов на основе Zapret Hub указывайте автора приложения и авторов используемых инструментов в соответствии с их лицензиями.
📁 Структура проекта
Основные каталоги:
src/zapret_hub — прикладная логика, Web UI bridge и сервисы;
web_ui — интерфейс на React, TypeScript и CSS;
installer — slim-установщик и деинсталлятор;
packaging — конфигурация сборки;
runtime — встроенные runtime-файлы компонентов;
sample_data — стартовые данные;
ui_assets — иконки и ресурсы интерфейса.
Рабочие данные создаются отдельно в каталогах data, logs, cache, mods, merged_runtime и backups.
🧪 Запуск в разработке
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .[dev]
cd web_ui
npm install
npm run build
cd ..
python -m zapret_hub.main
> [!WARNING]
> ### Антивирус сообщает об угрозе
>
> В Zapret и Zapret 2 используется WinDivert - драйвер для перехвата и фильтрации трафика. Без него локальная обработка трафика в Windows работать не может. Некоторые антивирусы относят такие инструменты к PUA/RiskTool или эвристически блокируют неподписанные сборки.
>
> Загружайте приложение только с официального сайта или из раздела Releases. Если антивирус удалил WinDivert, восстановите файл из карантина и добавьте папку Zapret Hub в исключения. Не отключайте защиту целиком, если не понимаете последствия.
> [!IMPORTANT]
> ### Не открывается нужный сервис
>
> 1. Откройте настройки Zapret или Zapret 2 и повторно запустите автоматический подбор.
> 2. Проверьте, что нужный сайт или приложение отмечены в выборе сервисов.
> 3. Попробуйте другой способ подключения через быстрый доступ.
> 4. Проверьте уведомления и логи приложения: там будет указана причина ошибки запуска.
> 5. Обновите приложение, компоненты и установленные Marketplace-дополнения.
> 6. Если проблема сохраняется, создайте issue или напишите в поддержку.
