Zapretify

Единый графический центр управления обходом блокировок для Windows и macOS

Симбиоз технологий `zapret` и `tg-ws-proxy` в одном приложении

Легковесное десктопное приложение на Go (WebView2 на Windows, нативное окно на macOS), объединяющее низкоуровневую десинхронизацию DPI (YouTube, Discord) и защищенный WebSocket-прокси для Telegram.

О концепции • Интерфейс • Два ядра проекта • macOS • Возможности • Планы развития • Установка • Использование • Сборка • Первоисточники

О концепции Zapretify

Большинство существующих решений для обхода цензуры решают задачи фрагментарно:

Для оживления YouTube и Discord пользователи запускают консольные .bat-скрипты на базе zapret.
Для стабильной работы Telegram в условиях блокировок протокола MTProto и IP-адресов дата-центров поднимают отдельные WebSocket-мосты (tg-ws-proxy) или ищут сторонние прокси.

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

Zapretify решает эту проблему, объединяя под единым управлением два принципиально разных инструмента обхода блокировок:

Низкоуровневый драйверный перехватчик zapret (ядро bol-van + пакет актуальных стратегий Flowseal).
Прикладной прокси-мост tg-ws-proxy (WebSocket / Fake-TLS туннелирование для Telegram).

Оба инструмента управляются единым оркестратором на Go, имеют независимые тумблеры переключения, не конфликтуют между собой и доступны через современный графический интерфейс с поддержкой системного трея Windows и строки меню macOS.

С версии 1.5.0 Zapretify работает и на macOS 14+ (Apple Silicon и Intel): тот же интерфейс, те же стратегии Flowseal, своя служба обхода для macOS. Подробнее — в разделе Zapretify для macOS.

Интерфейс приложения

Главный экран: общий статус, переключатели Zapret и Telegram-прокси, подключение Telegram в один клик

С версии 1.4.0 у Zapretify компактный интерфейс в окне 720×380: всё управление — на одном экране, настройки открываются в окнах-диалогах, а редкие действия собраны в меню «Стратегии и дополнительные действия».

_{Подбор стратегии: таблица лидеров обновляется на лету}	_{Итог подбора с разбивкой по YouTube, Discord и остальным сайтам}
_{Настройки Zapret: стратегия, служба Windows, Game Filter, IPSet}	_{Настройки Telegram-прокси: порт и скрытый секретный ключ}
_{Списки доменов: свои сайты не перезаписываются при обновлении баз}	_{Диагностика системы и аварийные действия}

Два фундаментальных ядра проекта

graph TD
    subgraph Zapretify["Zapretify — Единая платформа на Go"]
        subgraph Core1["ЯДРО 1: zapret (bol-van и Flowseal)"]
            Z_Level["Уровень: L3 / L4 / L7 (Сетевой стек Windows)"]
            Z_Driver["Драйвер: WinDivert64.sys + winws.exe"]
            Z_Desync["Десинхронизация: Fake TLS, Multisplit, Fake QUIC, STUN"]
            Z_Traffic["Трафик: YouTube 4K, Discord, Веб-сайты, Игры"]
            Z_Route["Маршрут: Прямой домашний канал (VPN не требуется)"]

            Z_Level --> Z_Driver --> Z_Desync --> Z_Traffic --> Z_Route
        end

        subgraph Core2["ЯДРО 2: tg-ws-proxy (Flowseal)"]
            T_Level["Уровень: L7 (Прикладной прокси-туннель)"]
            T_Driver["Сервис: Локальный MTProto Listener (127.0.0.1:1080)"]
            T_Tunnel["Туннель: WebSocket (WSS) over TLS через Cloudflare"]
            T_Traffic["Трафик: Клиент Telegram Desktop"]
            T_Route["Маршрут: Через сеть Cloudflare CDN в дата-центры Telegram"]

            T_Level --> T_Driver --> T_Tunnel --> T_Traffic --> T_Route
        end
    end

    Z_Route --> Res1["Свободный доступ на полной скорости провайдера"]
    T_Route --> Res2["Гарантированная связь с серверами Telegram (DC1–DC5)"]

Характеристика	ЯДРО 1: `zapret` (bol-van & Flowseal)	ЯДРО 2: `tg-ws-proxy` (Flowseal)
Сетевой уровень	L3 / L4 / L7 (Сетевой стек Windows)	L7 (Прикладной прокси-мост)
Механизм работы	Драйвер ядра WinDivert + десинхронизация пакетов	Локальный TCP-сервер -> WebSocket over TLS через Cloudflare
Что защищает	YouTube, Discord (включая голос), сайты, игры	Мессенджер Telegram Desktop
Внешний сервер	Не требуется (100% скорости домашнего канала)	Cloudflare Edge CDN / Workers
Первоисточники	bol-van/zapret Flowseal/zapret-discord-youtube	Flowseal/tg-ws-proxy

1. Ядро `zapret` (bol-van) с базой стратегий Flowseal

Что это: мощнейший инструмент обхода DPI (глубокого анализа пакетов) без маршрутизации трафика через удаленные VPN-серверы.
Как это устроено:
- Использует подписанный драйвер уровня ядра WinDivert (WinDivert.dll, WinDivert64.sys) для фильтрации и модификации исходящих пакетов TCP/UDP прямо на сетевой карте.
- Утилита winws.exe выполняет десинхронизацию пакетов: разбивает TLS ClientHello на части (split, multisplit, fakedsplit), генерирует фиктивные пакеты с заниженным TTL/SEQ (fake, badseq), подменяет SNI на разрешенные (www.google.com, ya.ru) и модифицирует QUIC/STUN пакеты для YouTube и Discord.
- Наработки Flowseal предоставляют набор адаптированных стратегий под реалии ТСПУ российских операторов и актуальные базы доменов (list-general.txt, list-google.txt, ipset-all.txt).
Задачи в Zapretify: полное восстановление скорости YouTube (воспроизведение 4K 60fps), разблокировка голосовых каналов и звонков Discord, доступ к сайтам без снижения скорости провайдера.

2. Ядро `tg-ws-proxy` (Telegram WebSocket Proxy)

Что это: специализированный локальный прокси-сервер, разработанный для гарантированной доставки трафика Telegram через любые сетевые фильтры.
Как это устроено:
- Клиент Telegram подключается к локальному адресу (по умолчанию 127.0.0.1:1080 или 1443).
- Прокси принимает бинарный поток MTProto и инкапсулирует его в защищенное WebSocket (WSS) соединение с шифрованием TLS.
- Трафик направляется через глобальную сеть CDN Cloudflare (Cloudflare Workers / Edge Nodes).
- Для интернет-провайдера и систем ТСПУ этот трафик выглядит как легитимный HTTPS/WSS веб-серфинг на доверенные адреса Cloudflare. Блокировка стандартных портов и IP-диапазонов Telegram перестает действовать.
Задачи в Zapretify: мгновенное подключение Telegram к дата-центрам (DC1–DC5), быстрая загрузка медиафайлов и стабильные звонки даже в условиях точечной блокировки протокола MTProto.

Как это работает внутри Zapretify

graph TD
    subgraph "Клиентская система (Windows)"
        AppUI["Графический интерфейс Zapretify (WebView2)"]
        Tray["Системный трей Windows (ПКМ-меню)"]
        
        Browser["Браузер / Discord / Игры"]
        Telegram["Клиент Telegram Desktop"]
    end

    subgraph "Zapretify Core (Единый процесс на Go)"
        EngineController["Оркестратор служб (app.go)"]
        Bench["Бенчмарк-движок"]
        UpstreamSync["Синхронизатор Flowseal"]
        
        ZapretSubsystem["Служба Zapret Manager"]
        TGProxySubsystem["Локальный TG WS Proxy Сервер"]
    end

    subgraph "Низкоуровневая обработка"
        Winws["winws.exe"]
        WinDivert["Драйвер WinDivert64.sys"]
    end

    subgraph "Внешняя сеть (Интернет)"
        YouTube["YouTube / Google CDN"]
        Discord["Серверы Discord Voice"]
        CFWorker["Cloudflare CDN / Workers (WSS)"]
        TGServers["Telegram Data Centers (DC1-DC5)"]
    end

    Tray -->|"Управление службами"| EngineController
    AppUI -->|"Управление и настройки"| EngineController
    EngineController --> ZapretSubsystem
    EngineController --> TGProxySubsystem
    EngineController --> Bench
    EngineController --> UpstreamSync

    Browser -->|"Обычный TCP/UDP трафик"| WinDivert
    WinDivert ---|"Захват и модификация пакетов"| Winws
    Winws -->|"Десинхронизация DPI"| YouTube
    Winws -->|"QUIC и STUN десинхронизация"| Discord

    Telegram -->|"Локальный MTProto"| TGProxySubsystem
    TGProxySubsystem -->|"WebSocket over TLS"| CFWorker
    CFWorker -->|"Форвардинг пакетов"| TGServers

Принципы интеграции:

Разделение зон ответственности:
- Трафик браузеров, Discord и системы идет напрямую через сетевую карту, где драйвер WinDivert «на лету» изменяет пакеты для обхода DPI без потери скорости.
- Трафик Telegram идет в локальный порт tgproxy, где преобразуется в защищенный WebSocket-туннель.
Исключение взаимного влияния:
- В списки исключений Zapret (ipset-exclude.txt, list-exclude.txt) занесены порты и служебные адреса прокси, что предотвращает двойную модификацию трафика.
Единый мониторинг и управление:
- Состояния обоих сервисов опрашиваются асинхронно. В системном трее и на главном экране всегда отображаются актуальные тумблеры: можно держать включенным только Zapret, только TG-прокси, либо оба сразу.
Подключение Telegram в один клик:
- Приложение автоматически генерирует персональную ссылку формата tg://proxy?server=127.0.0.1&port=...&secret=.... Кнопка в интерфейсе сразу открывает Telegram с готовым диалогом включения прокси.

Zapretify для macOS

Начиная с 1.5.0 Zapretify выходит и для macOS 14 Sonoma и новее — одно универсальное приложение для Apple Silicon и Intel. Интерфейс, Telegram-прокси, подбор стратегий, списки, обновление баз и диагностика те же, что на Windows; отличается то, как устроен перехват трафика.

graph TD
    subgraph User["Пользователь (без прав root)"]
        Shell["Zapretify.app — окно (WKWebView) и значок в строке меню"]
        Core["zapretify-core — то же Go-ядро, что на Windows"]
        Data["~/Library/Application Support/Zapretify — настройки, базы, списки"]
    end

    subgraph Root["Служба zapretifyd (root, LaunchDaemon)"]
        Daemon["Проверка команд и баз, перевод стратегии"]
        PF["pf: перенаправление портов стратегии"]
        Engine["utunws — движок zapret для macOS (сбрасывает права до nobody)"]
    end

    Shell --> Core
    Core -->|"Unix-сокет: status / start / stop"| Daemon
    Data -->|"копия баз при каждом запуске"| Daemon
    Daemon --> PF --> Engine
    Engine -->|"десинхронизация, отправка через BPF"| Net["Интернет"]

	Windows	macOS
Движок	`winws.exe` + драйвер WinDivert	`utunws` — порт `nfqws` от Flowseal (наш форк, сборка с проверкой SHA-256)
Перехват трафика	WinDivert на сетевой карте	правила `pf` отправляют порты стратегии в интерфейс `utun`
Права администратора	UAC при запуске или служба Windows	служба `zapretifyd` ставится один раз из приложения (пароль Mac), дальше пароль не нужен
Стратегии	`.bat` Flowseal	те же стратегии Flowseal, переводятся для `utunws` автоматически при запуске
Окно	WebView2 + трей	нативное окно без отдельной строки заголовка + значок в строке меню
Обход при загрузке	служба Windows	«Включать обход при загрузке Mac»
Установка	Setup.exe / Portable	`.dmg`: перетащить в «Программы»
Удаление	«Приложения» Windows	переместить Zapretify в Корзину (служба удалит себя сама)

Особенности macOS-версии:

Стратегии без отставания. Базы берутся из того же Windows-репозитория Flowseal, а не из отдельной сборки для Mac: новые стратегии и списки приходят одновременно с Windows.
IPv6. Если у провайдера есть IPv6, обход работает и по нему: сайты вроде YouTube macOS открывает по IPv6-адресу, и без этого они шли бы мимо движка.
Совместимость с VPN. Перехватывается только трафик, который идёт напрямую через Wi-Fi или Ethernet. VPN в режиме TUN продолжает работать: Zapretify обходит блокировки для того, что идёт мимо VPN. Работать вместе можно, но не желательно — приложение предупредит об этом значком «VPN».
Зашифрованный DNS. Диагностика проверяет, установлен ли профиль DNS over HTTPS, и объясняет, как его поставить: у многих провайдеров YouTube и Instagram блокируются ещё и подменой DNS.
Значок в строке меню показывает состояние кружком: зелёный — работают обе службы, оранжевый — одна, красный — ничего. Правый клик — меню управления.
Game Filter в первой версии для macOS недоступен.
Безопасность службы, работающей от root, описана в macos/SECURITY.md, устройство — в docs/ARCHITECTURE_MACOS.md.

Возможности

Компактный интерфейс и интеграция с Windows и macOS

Окно 720×380: один главный экран вместо вкладок, настройки в окнах-диалогах, редкие действия — в нижнем меню.
Корректный масштаб: размер окна считается по клиентской области с учётом масштаба Windows (100–200%), при переносе на монитор с другим DPI окно пересчитывается.
Тёмная тема и DWM Dark Mode: тёмный заголовок окна Windows, единая палитра (индиго — действия, зелёный — работает, янтарный — внимание, красный — ошибка).
Системные шрифты (Segoe UI, Cascadia Mono / Consolas): интерфейс ничего не загружает из интернета и одинаково выглядит без сети.
Подписи для экранного диктора и всплывающие подсказки у всех кнопок-иконок; поддержка режима «уменьшить анимацию».
Минимальное потребление памяти: легковесный движок на Go + WebView2 требует всего ~15–20 МБ ОЗУ (в отличие от Electron-аналогов на 200+ МБ).
macOS: нативное окно (WKWebView) без отдельной строки заголовка — кнопки окна встроены в шапку интерфейса, шапкой окно перетаскивается; около 35 МБ ОЗУ вместе с ядром.

Управление из системного трея и строки меню (ПКМ)

Сворачивание по нажатию кнопки минимизации или закрытия.
Интерактивное контекстное меню:
- Открыть Zapretify;
- Включить / Выключить Zapret (динамический статус);
- Включить / Выключить Telegram прокси (динамический статус);
- Выход с чистым завершением дочерних процессов.
Информативный тултип при наведении курсора.
macOS: значок в строке меню с цветным кружком состояния; левый клик открывает окно, правый — то же меню. Закрытие окна оставляет Zapretify в строке меню.

Подбор и проверка стратегий

Подбор лучшей: поочерёдная проверка всех стратегий Flowseal по выбранным целям (YouTube и Discord · 8, все · 13, Blockcheck · 5) и методу (полный, только DPI, только HTTPS).
Живая таблица лидеров с оценкой оставшегося времени; подбор можно остановить в любой момент — лучшие из проверенных сохраняются.
Понятный итог: лучшая стратегия, сколько целей открылось, разбивка по YouTube / Discord / прочему и список того, что не проходит.
Проверка одной стратегии за несколько секунд — например, той, что выбрана вручную.
Результат сохраняется (last_benchmark.json): «Прошлый подбор» и подсказка «Лучшая по подбору» видны и после перезапуска.
Подробный отчёт пишется в test_results.txt.

Автообновление баз и стратегий из Flowseal

Синхронизация баз списков хостов (list-general.txt, list-google.txt, list-exclude.txt, ipset-exclude.txt) и IP-листа для режима IPSet «Загружен».
Загрузка и разбор актуальных сценариев .bat из репозитория Flowseal, горячее обновление strategies.json без перезапуска приложения.
Докачка новых и изменённых файлов фейков bin/*.bin с проверкой контрольной суммы.
Подробный отчёт: какие стратегии добавлены или изменены, какие списки и фейки обновились, или «Файлы актуальны».
Базы обновляются автоматически при запуске программы (можно отключить в «Настройках приложения»).
Откат баз: перед каждым обновлением прежние стратегии, списки и фейки сохраняются; если новые базы что-то сломали, кнопка «Откатить» на экране «Обновления» возвращает их.
Свои списки не трогаются: list-general-user.txt, list-exclude-user.txt и ipset-exclude-user.txt («Мои сайты», «Мои исключения», «Мои IP») никогда не перезаписываются.

Списки доменов

Редактор своих списков с быстрым добавлением: можно вставить ссылку целиком (https://www.site.org/page → site.org), формат и дубли проверяются, добавление можно отменить.
Базы Flowseal открываются только для просмотра — свои сайты всегда идут в «Мои сайты».
После сохранения можно сразу перезапустить Zapret, чтобы движок (winws на Windows, utunws на macOS) перечитал списки.

Работа без открытого приложения: служба Windows и обход при загрузке Mac

Zapret запускается либо как процесс приложения, либо как служба Windows (sc.exe) — переключатель «Запускать как службу Windows» в настройках Zapret.
Служба работает с включения компьютера, даже без открытого приложения и без окна UAC.
Автозапуск самого приложения настраивается отдельно в «Настройках приложения» (через планировщик задач, без запроса UAC).
macOS: переключатель «Включать обход при загрузке Mac» — служба Zapretify сама запускает обход с последней стратегией после включения компьютера. Автозапуск приложения при входе — через LaunchAgent.

Мгновенный запуск и защита от дубликатов (Single Instance)

Проверка до вызова UAC: программа определяет наличие запущенного экземпляра через Win32 Mutex до запроса повышенных прав. Повторный клик по ярлыку не вызывает системный экран подтверждения UAC, а сразу выводит активное окно на передний план.
Интеллектуальная фильтрация окон: исключен ошибочный фокус на окнах Проводника Windows (CabinetWClass), если открыта папка с названием «Zapretify».
macOS: повторный запуск Zapretify.app показывает уже открытое окно, второй экземпляр не стартует.

Изолированное управление процессами и стабильность

Точечный учёт PID (winws.pid): приложение отслеживает свой процесс winws.exe и завершает только его, не затрагивая другие сетевые утилиты (GoodbyeDPI и др.).
Свободный фильтр перед запуском: если тот же фильтр WinDivert держит служба zapret или оставшийся winws.exe из папки приложения, они останавливаются автоматически; про чужой winws.exe из другой папки приложение сообщает понятной ошибкой.
Автоматическая зачистка «сирот» (CleanupOrphans): после аварийного закрытия или перезагрузки зависший процесс завершается по сохранённому PID.
Диагностика и аварийный сброс: проверка прав администратора, конфликта с GoodbyeDPI, файлов WinDivert и TCP Timestamps, сторонних процессов winws.exe, активных VPN/TUN-адаптеров, подмены DNS провайдером и зашифрованного DNS (с окном «Как исправить»); «Завершить Zapret», «Сброс служб и WinDivert», «Закрыть всё» с подтверждением повторным нажатием.
macOS: вместо проверок Windows — служба Zapretify, другой обходчик (ZapretMac), VPN, подмена DNS и зашифрованный DNS; в аварийных действиях есть «Удалить службу Zapretify».

Мастер установки с режимом обновления (In-Place Upgrade)

Графический установщик автоматически сканирует реестр Windows на наличие предыдущих версий.
При обнаружении установленного приложения мастер предлагает обновить его в один клик с гарантированным сохранением ваших настроек (config.json) и персональных списков доменов.

Защита локального API и данных

Сессионный токен (X-Zapretify-Token): все запросы интерфейса авторизуются криптографическим токеном с валидацией за константное время. Токен передается строго в заголовках.
Блокировка межсайтовых запросов: строгая проверка заголовков Host (защита от DNS Rebinding) и Origin (блокировка внешних сайтов и iframe-песочниц null, file://, data:).
Безопасные пути: редактор списков работает исключительно с .txt файлами внутри папки lists/, блокируя попытки выхода за пределы каталога, потоки данных NTFS (:) и зарезервированные системные устройства Windows (CON, PRN, AUX, NUL и др.).
Внешние ссылки в браузере по умолчанию: клики по ссылкам (GitHub, Telegram) открывают стандартный браузер пользователя через нативный системный вызов (ShellExecuteW на Windows, NSWorkspace на macOS).
macOS: от root работает только служба zapretifyd — команды принимает только от владельца, проверяет каждую опцию стратегии по белому списку и читает ваши файлы без следования симлинкам. Подробно — в macos/SECURITY.md.
Без внешних источников: политика CSP разрешает загрузку только с самого приложения.

Установка и запуск

Вариант 1: Portable-версия (без установки)

Скачайте архив Zapretify-Portable-v1.5.0.zip из раздела Releases.
Распакуйте архив в удобный каталог (например, C:\Program Files\Zapretify или D:\Tools\Zapretify).
Запустите Zapretify.exe от имени администратора.

Вариант 2: Установщик Windows (Setup.exe)

Скачайте и запустите Zapretify-Setup-v1.5.0.exe из раздела Releases.
Программа установки:
- Автоматически распознает уже установленную версию программы и предложит ее обновление с сохранением пользовательских настроек и списков;
- Автоматически предложит оптимальный путь установки с возможностью выбора другой папки;
- Создаст ярлыки на рабочем столе и в меню «Пуск»;
- Предложит автозапуск приложения при входе в Windows;
- Корректно зарегистрирует программу в системе для чистого удаления через стандартные «Параметры Windows -> Приложения».

Обратите внимание: для перехвата сетевых пакетов драйвер WinDivert требует права локального администратора. Приложение запросит UAC при старте.

Вариант 3: macOS 14+ (Apple Silicon и Intel)

Скачайте Zapretify-macOS-v1.5.0.dmg из раздела Releases, откройте его и перетащите Zapretify в папку «Программы».
Запустите Zapretify. Приложение подписано без сертификата Apple, поэтому при первом запуске macOS может его не открыть: Системные настройки → Конфиденциальность и безопасность → «Всё равно открыть».
На главном экране нажмите «Установить службу» и введите пароль Mac — это нужно один раз. Служба включает перехват трафика; дальше обход включается и выключается без пароля.
Если стоит ZapretMac — остановите и удалите его: два обходчика не могут работать одновременно.

Обновление: на экране «Обновления» нажмите «Скачать .dmg» и перетащите новую версию в «Программы» с заменой; приложение предложит обновить службу. Удаление: переместите Zapretify в Корзину — служба удалит себя сама в течение 10–15 минут. Можно и сразу: «Диагностика и сброс» → «Удалить службу Zapretify».

Руководство по использованию

1. Главный экран

«Включить всё» / «Остановить всё» — запуск и остановка Zapret и Telegram-прокси одной кнопкой.
Переключатели «YouTube и Discord» и «Telegram» — каждая служба управляется отдельно. Под названием видно состояние и текущую стратегию или адрес прокси.
Клик по строке службы (или по значку шестерёнки) открывает её настройки.
Значок журнала в правом верхнем углу открывает журнал событий; красная точка на нём означает новые ошибки.
Бейдж версии показывает, есть ли обновление.
«Стратегии и дополнительные действия» — меню с подбором стратегий, списками, диагностикой, журналом, настройками приложения и обновлениями. Цифра на кнопке — сколько разделов требуют внимания.

Меню «Стратегии и дополнительные действия»

2. Подбор стратегии для YouTube и Discord

Откройте «Стратегии и дополнительные действия» → «Подбор и проверка стратегий».
Режим «Подобрать лучшую» проверит все стратегии; «Проверить одну» — только выбранную. Кнопка с параметрами рядом со стартом задаёт цели и метод проверки.
Нажмите «Начать подбор». На время проверки Zapret приостанавливается и потом включается сам, Telegram-прокси это не затрагивает. Подбор можно остановить кнопкой «Остановить».
В итоге нажмите «Применить стратегию» — Zapret запустится с ней. «Все результаты» покажет полный рейтинг, а «Новая проверка» вернёт к выбору режима.

3. Настройки Zapret

Нажмите на строку «YouTube и Discord» на главном экране.
Выберите стратегию вручную или нажмите «Выбрать» рядом с лучшей по подбору; «Проверить» быстро проверит выбранную стратегию.
Включите «Запускать как службу Windows», чтобы обход работал с включения ПК без открытого приложения (нужны права администратора).
В разделе «Дополнительно» — Game Filter (Discord Voice и онлайн-игры), диапазоны портов и режим IPSet.
Нажмите «Сохранить»: если Zapret работает, он перезапустится с новыми параметрами.

4. Свои сайты и исключения

Откройте «Списки доменов».
Во вкладке «Мои сайты» добавьте домен в поле «Быстро добавить» или отредактируйте список вручную и нажмите «Сохранить».
Сайты, которые должны идти напрямую, добавляйте в «Мои исключения», IP-адреса и подсети — в «Мои IP».
Если Zapret запущен, нажмите «Перезапустить Zapret» внизу редактора, чтобы применить списки.

5. Telegram-прокси

Включите переключатель «Telegram» на главном экране.
Нажмите значок «Открыть в Telegram» рядом с переключателем (или скопируйте ссылку соседним значком) и подтвердите добавление прокси в Telegram.
В настройках (клик по строке «Telegram») можно сменить порт и сгенерировать новый секретный ключ — после смены ключа добавьте прокси в Telegram заново. В разделе «Задержка до дата-центров» — замер пинга до DC1–DC5.
Если Telegram не подключается. Некоторые провайдеры блокируют и путь прокси через Cloudflare, и прямые адреса Telegram. Тогда под «Telegram» на главном экране появится красная «Ошибка» — клик по ней открывает настройки прокси на блоке «Если Telegram не подключается». Там две кнопки: «Включить IPSet «loaded»» (Zapret начнёт обрабатывать подсети Cloudflare) или кнопка, которая добавляет домен прокси в «Мои сайты» (Zapret будет обходить только его). Zapret при этом должен быть включён.

Если Telegram не подключается: решение в одну кнопку прямо в настройках прокси

6. Особенности на macOS

Всё управление то же; вместо трея — значок в строке меню, вместо службы Windows — «Включать обход при загрузке Mac» в настройках Zapret.
Если обход не включается, на главном экране появится «Нужна служба Zapretify» или «Обновите службу Zapretify» — нажмите кнопку и введите пароль.
Перед подбором стратегии выключите VPN: с ним результаты будут неверными.

7. Диагностика, журнал и обновления

«Диагностика и сброс» — проверка прав администратора, GoodbyeDPI, WinDivert, TCP Timestamps, сторонних winws.exe, VPN/TUN-адаптеров, подмены DNS и зашифрованного DNS с кнопками исправления и подсказками (на macOS — служба Zapretify, ZapretMac, VPN и DNS), копирование отчёта для разработчика и аварийные действия.
«Журнал событий» — фильтр «Все / Предупреждения / Ошибки», автопрокрутка и очистка.
«Обновления» — проверка новой версии на GitHub, обновление баз Flowseal и откат к предыдущим базам; ваши списки при этом не меняются.
«Настройки приложения» — автозапуск Zapretify при входе в систему и запуск свёрнутым в трей (на macOS — без окна, только значок в строке меню).

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

Требования

Go: версия 1.26 или новее (см. go.mod).
ОС: Windows 10/11 x64, macOS или Linux (с поддержкой Go cross-compilation).

Компиляция

# Кросс-компиляция из Linux или macOS:
GOOS=windows GOARCH=amd64 go build -ldflags="-s -w -H=windowsgui" -o Zapretify.exe .

# Нативная компиляция в Windows:
go build -ldflags="-s -w -H=windowsgui" -o Zapretify.exe .

# Сборка инсталлятора (Setup.exe):
GOOS=windows GOARCH=amd64 go build -ldflags="-s -w -H=windowsgui" -o dist/Zapretify-Setup-v1.5.0.exe ./cmd/installer

Автоматическая сборка дистрибутива

В Windows запустите:

build_all.bat

Скрипт скомпилирует Zapretify.exe, упакует портативный архив dist/Zapretify-Portable-v1.5.0.zip и автоматически соберёт инсталлятор dist/Zapretify-Setup-v1.5.0.exe.

Сборка для macOS

Нужны macOS 14+, Go и Xcode Command Line Tools (xcode-select --install), а также Python 3 для оформления .dmg.

bash macos/scripts/build-app.sh   # dist/macos/Zapretify.app (arm64 + x86_64)
bash macos/scripts/build-dmg.sh   # dist/Zapretify-macOS-v<версия>.dmg

Движок utunws скачивается из релиза selfdestroyer/zapret-macos-engine по версии и SHA-256 из macos/engine.lock; при несовпадении сборка останавливается.

Планы развития (Roadmap)

Сейчас Zapretify работает на Windows 10/11 x64 и macOS 14+. Следующая платформа — Linux:

Windows 10 / 11 (x64):
- Полная поддержка WinDivert, системной службы Windows (sc.exe), автозапуска, системного трея и графического инсталлятора.
macOS 14+ (Apple Silicon и Intel) — с версии 1.5.0:
- Движок utunws (порт nfqws от Flowseal), перехват через pf и utun, служба zapretifyd (LaunchDaemon);
- Нативное окно и значок в строке меню, .dmg для Apple Silicon и Intel.
Linux:
- Родной движок nfqws из zapret bol-van и перенаправление трафика через nftables (NFQUEUE);
- Служба systemd по той же схеме, что на macOS (сокет, проверка пользователя, безопасный импорт баз);
- Окно WebKitGTK (Wayland и X11) и значок в трее через StatusNotifierItem; пакеты .deb, .rpm, AppImage.

Структура репозитория

Zapretify/
├── assets/                   # Иконка приложения (icon.ico) и логотипы
├── bin/                      # Бинарные модули ядра
│   ├── winws.exe             # Исполняемый файл zapret (bol-van)
│   ├── WinDivert.dll         # Библиотека перехвата пакетов WinDivert
│   ├── WinDivert64.sys       # 64-битный драйвер уровня ядра
│   ├── cygwin1.dll           # POSIX-совместимый слой
│   └── *.bin                 # Бинарные пэйлоады (Google SNI, QUIC, Discord STUN)
├── cmd/                      # Точки входа дополнительных утилит
│   ├── zapretifyd/           # Служба macOS (root, LaunchDaemon) и её консольный клиент
│   └── installer/            # Графический инсталлятор для Windows (Go + WebView2)
│       ├── frontend/         # Веб-интерфейс мастера установки
│       ├── main.go           # Движок распаковки, ярлыков и реестра Windows
│       └── window_windows.go # Win32 окно с темным заголовком DWM
├── core/                     # Исходный код бэкенда (Go)
│   ├── config/               # Менеджер настроек (JSON) и реестр автозапуска
│   ├── logger/               # Потокобезопасный логгер в zapretify.log
│   ├── macdaemon/            # Служба macOS: протокол, проверка аргументов, импорт баз, pf и utunws
│   ├── platform/             # Win32 API, UAC elevation, системная диагностика
│   ├── tgproxy/              # Реализация ядра tg-ws-proxy (WebSocket MTProto bridge)
│   ├── updater/              # Синхронизатор баз и стратегий Flowseal
│   └── zapret/               # Интерфейс Engine, winws, WinDivert, перевод стратегий для macOS, бенчмарк
├── docs/                     # Документация (архитектура, безопасность, история версий)
│   ├── icons/                # SVG-иконки разделов README (Lucide, ISC)
│   ├── ARCHITECTURE.md       # Подробное описание технической архитектуры
│   ├── ARCHITECTURE_MACOS.md # Устройство macOS-версии: служба, движок, pf, оболочка
│   ├── CHANGELOG.md          # История версий и изменений
│   └── SECURITY.md           # Модель безопасности и контакты
├── frontend/                 # Пользовательский интерфейс (Single Page Application)
│   └── dist/index.html       # Интерфейс 1.4.0: HTML5/CSS3/Vanilla JS в одном файле
├── lists/                    # Списки хостов и IP-диапазонов Flowseal
├── macos/                    # macOS: оболочка Swift, Info.plist, фон .dmg, скрипты сборки и службы
│   ├── app/                  # Shell.swift, Info.plist, dmg-background.swift
│   ├── scripts/              # build-app.sh, build-dmg.sh, install/uninstall-daemon.sh
│   ├── engine.lock           # Версия и SHA-256 движка utunws
│   └── SECURITY.md           # Модель угроз службы, работающей от root
├── packaging/                # Резервные скрипты установщика Inno Setup (installer.iss)
├── screens/                  # Скриншоты интерфейса для README
├── api.go                    # Внутренний HTTP REST API для связи GUI с Go-ядром
├── app.go                    # Главный контроллер приложения и фасад управления
├── build_all.bat             # Скрипт сборки Portable архива и инсталлятора
├── main.go                   # Точка входа приложения, встроенный веб-сервер
├── open_browser_windows.go   # Безопасное открытие URL в браузере Windows (ShellExecuteW)
├── open_browser_other.go     # Открытие URL для кросс-платформенного запуска
├── security_middleware.go    # Защита локального API: токен X-Zapretify-Token, Host/Origin
├── single_instance_windows.go# Быстрый повторный запуск (OpenMutex) без вызова UAC
├── single_instance_other.go  # Заглушка проверки экземпляра для других ОС
├── strategies.json           # Локальная база стратегий Flowseal
├── window_windows.go         # Интеграция с Win32: WebView2, системный трей, DWM Dark Mode
├── window_dpi_windows.go     # Размер окна по клиентской области с учётом DPI монитора
├── platform_darwin.go        # macOS: движок через службу, папка данных, установка и удаление службы
└── window_other.go           # macOS/Linux: окно в оболочке Zapretify.app или в браузере

Первоисточники и лицензии

Проект Zapretify выражает глубокую признательность авторам базовых технологий:

bol-van/zapret (ядро winws v72.9)
Автор: bol-van
Оригинальный комплекс zapret, утилита winws.exe (v72.9), интеграция с сетевым драйвером WinDivert и реализация передовых методов десинхронизации пакетов.
Лицензия: MIT License.
Flowseal/zapret-discord-youtube (пакет стратегий v1.10.4)
Автор: Flowseal
Готовые стратегии для обхода замедления YouTube и Discord в РФ (актуальная база сценариев), списки доменов и IP-диапазонов, бинарные пэйлоады.
Лицензия: MIT License.
Flowseal/zapret-mac-discord-youtube (движок utunws для macOS)
Автор: Flowseal
Порт nfqws на macOS через utun и BPF. Zapretify собирает его из своего форка selfdestroyer/zapret-macos-engine без изменений кода движка.
Лицензия: MIT License.
Flowseal/tg-ws-proxy (протокол WebSocket over TLS)
Автор: Flowseal
Концепция и реализация проксирования протокола Telegram MTProto через защищенные соединения WebSocket (WSS) и CDN-сети Cloudflare.
Лицензия: MIT License.

Лицензия проекта Zapretify — MIT License.

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
assets		assets
bin		bin
cmd		cmd
core		core
docs		docs
frontend/dist		frontend/dist
lists		lists
macos		macos
packaging		packaging
screens		screens
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
THIRD_PARTY.md		THIRD_PARTY.md
Zapretify.manifest		Zapretify.manifest
api.go		api.go
api_test.go		api_test.go
app.go		app.go
app_engine_test.go		app_engine_test.go
build_all.bat		build_all.bat
go.mod		go.mod
go.sum		go.sum
main.go		main.go
open_browser_other.go		open_browser_other.go
open_browser_windows.go		open_browser_windows.go
platform_darwin.go		platform_darwin.go
platform_other.go		platform_other.go
platform_text.go		platform_text.go
rsrc_windows_amd64.syso		rsrc_windows_amd64.syso
security_middleware.go		security_middleware.go
security_middleware_test.go		security_middleware_test.go
single_instance_other.go		single_instance_other.go
single_instance_windows.go		single_instance_windows.go
strategies.json		strategies.json
uninstall_other.go		uninstall_other.go
uninstall_windows.go		uninstall_windows.go
uninstall_windows_test.go		uninstall_windows_test.go
vpn_status.go		vpn_status.go
window_dpi_windows.go		window_dpi_windows.go
window_other.go		window_other.go
window_windows.go		window_windows.go

Latest commit

History

Folders and files

Repository files navigation