https://github.com/goshkow/zapret-hub
Windows-приложение для удобного управления zapret и tg-ws-proxy из единого интерфейса.
https://github.com/goshkow/zapret-hub
arm discord-youtube dpi-bypassing dpi-circumvention portable-app python russian telegram-proxy tg-ws-proxy unblocker windivert windows windows-10 windows-11 x64 youtube-unblocker zapret zapret-discord-youtube zapret-hub zaprethub
Last synced: 16 days ago
JSON representation
Windows-приложение для удобного управления zapret и tg-ws-proxy из единого интерфейса.
- Host: GitHub
- URL: https://github.com/goshkow/zapret-hub
- Owner: goshkow
- License: mit
- Created: 2026-04-14T19:02:15.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-24T17:45:51.000Z (about 2 months ago)
- Last Synced: 2026-04-24T19:28:05.125Z (about 2 months ago)
- Topics: arm, discord-youtube, dpi-bypassing, dpi-circumvention, portable-app, python, russian, telegram-proxy, tg-ws-proxy, unblocker, windivert, windows, windows-10, windows-11, x64, youtube-unblocker, zapret, zapret-discord-youtube, zapret-hub, zaprethub
- Language: Python
- Homepage:
- Size: 21.2 MB
- Stars: 82
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
⭐️ Пожалуйста, поставьте звезду этому репозиторию, чтобы бесплатно поддержать меня.
**Это - версия для Windows**
# 🚀 [Zapret Hub](https://github.com/goshkow/Zapret-Hub)
**Zapret Hub** - Windows-приложение для **удобного управления** `zapret` и `tg-ws-proxy` из **одного интерфейса**.
**Для обычных пользователей** - без bat-файлов, поиска папок и правки конфигов в блокноте, абсолютно бесплатно!
**Автор**: goshkow • [GitHub](https://github.com/goshkow/Zapret-Hub) • [Задать вопрос](https://t.me/zzaprethub)
Что-то не работает? • [Исправить](#не-работает) • [Создать issue](https://github.com/goshkow/Zapret-Hub/issues) • [Поддержка](https://t.me/zzaprethub)
## 💡 Что это такое
Проект объединяет в **одном окне**:
✅ запуск/остановку `Zapret` и `TG WS Proxy`
✅ автоматическую загрузку и работу в трее
✅ выбор `general`-конфигураций для `zapret`
✅ гибкий импорт модификаций
✅ диагностику и тестирование
✅ просмотр логов и редактирование файлов
✅ возможность настраивать как `Zapret`, так и `TG WS Proxy`
> Приложение не скачивает и не запускает дополнительные программы, все обходы встроены и не требуют настройки вне основного приложения.
## ✨ Возможности
| Фича | Описание |
|------|----------|
| 🎮 **Единая кнопка** | Включение/отключение обходов одним кликом |
| 🎀 **Компоненты** | TG-WS-Proxy и Zapret работают не конфликтуя |
| ⚙️ **Гибкая работа** | Можно включать и выключать компоненты отдельно |
| 🔷 **Остается в трее** | Не нужно держать окно постоянно открытым |
| ❤️🩹 **Настройки в трее** | Можно быстро менять конфиги через меню в трее |
| 🌙 **Работа в фоне** | Оставляет фоновые процессы только при работе обходов |
| 📦 **Моды** | Импорт модификаций из Папки/ZIP/GitHub/файлов |
| 📁 **Файлы** | Возможность отдельно редактировать конфигурации Zapret |
| 🎚️ **Инструменты** | Тестирование general'ов, настроек, обновления |
| 🎨 **UI** | На выбор есть 3 темные и 2 светлые темы, RU/EN языки |
| 🚀 **Автозапуск** | Можно включить запуск программы вместе с Windows |
| 📱 **Форматы** | Portable + universal установщик (x64/ARM64) |
| 🛡️ **Безопасность** | Отдельный runtime, оригинальные компоненты, бэкапы |
| 💫 **Обновления** | Автоматичесие обновления, компоненты обновляются вручную |
| ❌ **Данные** | Приложение не собирает данные, даже анонимные |
## 🎀 Компоненты
Раздел **Компоненты** предназначен для включения/выключения, удобной настройки компонентов внутри приложения.
В разделе можно:
🔹 Изменить `general` Zapret
🔹 Подключить TG-WS-Proxy к Telegram
🔹 Скачать последнюю версию Telegram Desktop
🔹 Обновить любой из компонентов
🔹 Включить/Отключить любой из компонентов
> Компоненты Zapret Hub никак не модифицированы изнутри, они содержат оригинальный релиз или исходный код от самих авторов.
## 🛠 Модификации
🔹 Программа хранит все моды **отдельно** от других файлов
🔹 **Не трогает** базовые файлы, поэтому использование нескольких модификаций безопасно
🔹 Собирает модификации в одну - позволяет выбрать один из запретов, а списки собирает из всех включенных модификаций
🔹 Позволяет импортировать general/списки из GitHub/ZIP/Папок и файлы отдельно
> [!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](https://github.com/Flowseal/zapret-discord-youtube) | **Flowseal** |
| [tg-ws-proxy](https://github.com/Flowseal/tg-ws-proxy) | **Flowseal** |
| [zapret](https://github.com/bol-van/zapret-win-bundle) экосистема | **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`
## 🧪 Запуск в разработке
```powershell
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -e .[dev]
python -m zapret_hub.main
```
## 🔨 Сборка
### Приложение
```powershell
.venv\Scripts\python.exe -m PyInstaller -y packaging\zapret_hub.spec
```
**Результат**: `dist\zapret_hub\`
### Установщик
```powershell
.venv\Scripts\python.exe -m PyInstaller -y packaging\install_zaprethub.spec
```
**Результат**: `dist\install_zaprethub.exe`
# Не работает
> [!WARNING]
>
> ### Ругается антивирус
> В программу встроен WinDivert - это инструмент для перехвата и фильтрации трафика, необходимый для работы компонента [zapret](https://github.com/Flowseal/zapret-discord-youtube).
>
> Его могут использовать злоумышленники, но сам по себе он не является вирусом.
>
> Некоторые антивирусы склонны относить файлы 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`