Skip to content

goshkow/Zapret-Hub

Repository files navigation

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

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

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

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

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

Zapret Hub banner

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

Автор: goshkow • GitHubЗадать вопрос

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

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

Zapret Hub объединяет в одном окне:

✅ запуск и остановку Zapret, TG-WS-Proxy и goshkow vpn
✅ быстрое переключение между Zapret и VPN одной кнопкой
✅ выбор сервисов, игр и сайтов, под которые нужно настроить обход
✅ автоматический подбор подходящей general-конфигурации для zapret
✅ настройку маршрутизации VPN, системного прокси и проксирования отдельных процессов
✅ гибкий импорт и создание модификаций прямо внутри приложения
✅ диагностику, тестирование, уведомления и расширенные логи
✅ просмотр логов и редактирование файлов
✅ автозапуск вместе с Windows и работу в трее
Дополнительно:
✅ Встроенный VPN-режим через подписку vpn.goshkow.ru с 10-ти дневным бесплатным периодом. Далее - 100 руб/мес за безлимит трафика, скорости и устройств.

goshkow VPN является необязательным платным функционалом - без него можно использовать абсолютно все другие функции абсолютно бесплатно.

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

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

Фича Описание
🎮 Единая кнопка Включение и отключение обходов одним кликом
🔁 Быстрое переключение Переключение между Zapret и VPN одной кнопкой в быстром доступе
🧭 Сервисы Быстрая настройка Zapret под выбранные сайты, игры и приложения
🧪 Автоподбор Приложение само проверяет конфигурации и помогает выбрать рабочий вариант
🧩 Маршрутизация VPN Global, RU blacklist, RU whitelist, системный прокси и выбор процессов
🎀 Компоненты Zapret, TG-WS-Proxy и goshkow vpn управляются из одного раздела
⚙️ Гибкая работа Можно включать и выключать компоненты отдельно
🔷 Остается в трее Не нужно держать окно постоянно открытым
❤️‍🩹 Настройки в трее Можно быстро менять состояние приложения через меню в трее
🌙 Работа в фоне Фоновые процессы запускаются только тогда, когда они действительно нужны
📦 Моды Импорт модификаций из папки, ZIP, GitHub и отдельных файлов
🛠️ Редактор модов Модификации можно создавать и настраивать прямо внутри приложения
📁 Файлы Возможность отдельно редактировать конфигурации Zapret
🎚️ Инструменты Тестирование general'ов, диагностика и обновления компонентов
🔔 Уведомления Встроенные уведомления о важных событиях, ошибках и завершении действий
🎨 UI 5 Тем на выбор, RU/EN языки, удобный и красивый интерфейс, функциональность
🚀 Автозапуск Можно включить запуск программы (и компонентов) вместе с Windows
📱 Форматы Portable + universal установщик для x64 и ARM64
🛡️ Безопасность Отдельный runtime, оригинальные компоненты, бэкапы и локальные настройки
💫 Обновления Автоматические обновления приложения и компонентов
Данные Приложение не собирает данные, даже анонимные

🧭 Сервисы и быстрый подбор

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

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

Приложение подберет правила и проверит подходящие конфигурации для выбранных сценариев. Встроенный подбор помогает быстро и удобно найти рабочую конфигурацию для конкретной сети и конкретных задач. Особенно это полезно для игр, голосовых чатов, лаунчеров, загрузок, CDN и сервисов авторизации.

🛡️ goshkow vpn

goshkow vpn - встроенный VPN-режим Zapret Hub, работающий через подписку vpn.goshkow.ru.

VPN можно использовать как альтернативу Zapret. В быстром доступе есть отдельная кнопка, которая позволяет одной кнопкой переключаться между Zapret и goshkow vpn.

Возможности goshkow vpn:

🔹 множество различных инбаундов
🔹 режим TUN для работы на уровне системы
🔹 настройка маршрутизации: global, RU blacklist, RU whitelist
🔹 режимы системного прокси: Clear system proxy, Set system proxy, Do not change system proxy, PAC mode
🔹 возможность проксировать только указанные процессы
🔹 локальный счетчик использованного трафика
🔹 10 дней бесплатного доступа

goshkow vpn не является универсальным импортом любых VPN-подписок. Компонент работает именно с подпиской vpn.goshkow.ru. Таким образом я могу быть уверен в качестве соединения и работы компонента, а так же это позволяет монетизировать полностью бесплатное приложение.

🎀 Компоненты

Раздел Компоненты предназначен для включения, выключения и настройки встроенных компонентов приложения.

В разделе можно:
🔹 Изменить general Zapret
🔹 Подключить TG-WS-Proxy к Telegram
🔹 Настроить и подключить goshkow vpn
🔹 Скачать последнюю версию Telegram Desktop
🔹 Обновить любой из компонентов
🔹 Открыть настройки нужного компонента одной кнопкой
🔹 Включить или отключить любой компонент

Компоненты Zapret Hub управляются внутри приложения и не требуют запуска отдельных интерфейсов.

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

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

Important

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

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

📁 Файлы

В файлах можно отдельно редактировать:
🔹 IP-листы
🔹 IP-исключения
🔹 Домены
🔹 Исключения доменов
🔹 Hosts

Для продвинутых пользователей доступен отдельный файловый редактор, который позволяет открывать конфигурационные файлы Zapret и модификаций.

📦 Portable и Installer

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

  • portable\win_x64 - portable для Windows x64
  • portable\win_arm64 - portable для Windows ARM64
  • install_zaprethub.exe - универсальный установщик, который установит подходящую версию

💻 Требования

  • 🪟 Windows 10/11

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

🐍 Python 3.11

⚡ PowerShell 5+ / 7+

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

Инструмент Автор
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 - потенциально нежелательных приложений. Например, в Kaspersky есть галочка "Обнаруживать легальные приложения, которые злоумышленники часто используют для нанесения вреда". При аккуратной настройке рекомендуется добавить исключение, но если вы не до конца понимаете, что делаете, рекомендуется отключить детект PUA.

Important

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

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

  1. Выбрать нужные сервисы и запустить подбор конфигурации
  2. Установить Gaming mode: tcp + udp
  3. Установить IPset Mode: Loaded или Any, если это нужно для выбранного сценария
  4. Проверить выбранную general-конфигурацию
  5. Запустить тест конфигураций в Инструментах
  6. Включить 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

Star History Chart