NetFix: как я сделал GUI-обёртку для Zapret и TgWsProxy, которой самому приятно пользоваться

С чего всё началось

Когда Telegram начал серьёзно деградировать по скорости, а Discord стабильно висеть на «Подключение…“ — сообщество нашло рабочие решения: Zapret от bol‑van ^[1] и TgWsProxy от Flowseal ^[2]. Оба инструмента реально работают. Проблема одна — запустить их не так тривиально: батники, конфиги, права администратора, мониторинг процессов вручную.

Я захотел сделать что‑то, чем мог бы пользоваться любой человек — без консоли, без гугления, без «а он вообще запустился?». Так появился NetFix.

Важный момент сразу: NetFix не реализует никаких методов обхода сам. Это GUI‑оболочка, которая управляет запуском Zapret и TgWsProxy — готовых open‑source инструментов. Весь код NetFix открыт, никаких VPN‑соединений не создаётся.

Стек и архитектура

• C# /.NET 8.0 / WPF — основной стек

• XAML — весь UI

• WinForms — только для трей‑иконки (NotifyIcon)

• DiscordRichPresence 1.6.1.70 — единственная сторонняя NuGet‑зависимость

Намеренно минимальный набор зависимостей: встроенный HttpClient вместо RestSharp, System.Text.Json вместо Newtonsoft, MediaPlayer вместо NAudio. Меньше зависимостей — меньше поверхности для проблем.

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

NetFix/
├── Models/
│   ├── DiagModels.cs          # DcResult, PingResult, DiagReport, AppSettings
│   ├── NoteMap.cs             # модели ритм-игры
│   └── ZapretConfig.cs        # конфиги Zapret
├── Services/
│   ├── AutoDownloadService.cs     # скачивание компонентов с GitHub Releases
│   ├── DiagnosticsEngine.cs       # сетевая диагностика
│   ├── DiscordRpcService.cs       # Discord Rich Presence
│   ├── SettingsService.cs         # сохранение настроек (JSON)
│   ├── UpdateService.cs           # автообновления
│   ├── ZapretConfigService.cs     # тест и применение конфигов
│   └── ComponentVersionService.cs # версии установленных компонентов
├── Views/
│   ├── UpdateWindow.xaml/.cs
│   └── ZapretConfigWindow.xaml/.cs
└── MainWindow.xaml/.cs            # основной экран + ритм-игра

Как работает главный экран

Весь пользовательский сценарий умещается в одно действие: нажать кнопку. Поэтому главный экран максимально минималистичен.

Главная кнопка — анимированная, с aurora‑эффектом (радиальный градиент, который плавно меняет цвет через DispatcherTimer + WPF Storyboard). У кнопки четыре состояния:

• Idle — приложение готово к запуску

• Loading — идёт запуск компонентов / диагностика

• Active — всё работает (подтверждено сетевой проверкой)

• Error — что‑то пошло не так

Рядом — два статусных индикатора (эллипсы): один для Zapret, другой для TgWsProxy. Меняют цвет в зависимости от состояния процесса.

По нажатию кнопки происходит следующее:

1. Проверяется наличие бинарей в папке приложения

2. Если компонентов нет — AutoDownloadService скачивает их с официальных GitHub Releases

3. Запускаются процессы через ProcessStartInfo с UseShellExecute = false, CreateNoWindow = true

4. DiagnosticsEngine делает TCP‑проверки к целевым сервисам и подтверждает что соединение работает

5. Индикаторы и состояние кнопки обновляются

При закрытии приложения все запущенные процессы корректно завершаются.

Сетевая диагностика

DiagnosticsEngine — отдельный сервис, который делает несколько типов проверок:

• DC check — прямое TCP‑соединение к датацентрам Telegram

• Ping — базовая проверка связи

• DNS — резолвится ли домен

• DPI check — проверка что Zapret реально помогает

• UDP / throttle — дополнительные проверки для диагностики

Результаты собираются в DiagReport, на основе которого строится UI‑состояние. Это нужно чтобы «процесс запущен» и «всё работает» не были одним и тем же — Zapret может стартовать успешно, но нужный конфиг может не подойти для конкретного провайдера.

Конфиги Zapret

Zapret поддерживает разные стратегии обхода DPI, и универсального решения нет — что работает у одного провайдера, может не работать у другого. Поэтому в NetFix есть отдельное окно выбора конфига.

ZapretConfigService прогоняет каждый .bat‑конфиг через реальную сетевую проверку и показывает результаты. Пользователь видит что сработало, что нет — и выбирает рабочий вариант. Результаты кэшируются в ZapretConfigCache чтобы не гонять проверки каждый раз.

Автозагрузка компонентов и обновления

AutoDownloadService при первом запуске (или когда компоненты устарели) скачивает бинари Zapret и TgWsProxy с их официальных GitHub Releases. Проверка идёт через GitHub API, скачивается нужная версия под архитектуру системы.

ComponentVersionService хранит версии установленных компонентов и сравнивает с актуальными. Если вышло обновление TgWsProxy — пользователь получит предложение обновить компонент, независимо от версии самого NetFix.

Обновления самого приложения обрабатываются через UpdateService — тоже GitHub Releases, с диалогом UpdateWindow где показывается changelog.

Настройки

Все настройки хранятся в settings.json рядом с exe-шником. Модель данных:

public class AppSettings
{
    public string ZapretPath { get; set; } = "";
    public string TgWsProxyPath { get; set; } = "";
    public bool AutostartZapret { get; set; } = false;
    public bool AutostartTgWsProxy { get; set; } = false;
    public bool AutostartApp { get; set; } = false;
    public bool AutoUpdates { get; set; } = true;
    public bool ShowLongCheckDialog { get; set; } = true;
}

Сериализация через System.Text.Json с JsonNamingPolicy.CamelCase. SettingsService умеет в экспорт/импорт — можно бэкапить конфигурацию или переносить между машинами.

Трей‑иконка (NotifyIcon через WinForms interop) даёт быстрый доступ к основным действиям без открытия главного окна.

Ритм‑игра внутри приложения

Это, наверное, самая неожиданная часть. Диагностика или первичная загрузка компонентов может занимать 10–30 секунд. Вместо спиннера я сделал мини‑игру в стиле osu!mania — вертикальные дорожки, падающие ноты.

Что реализовано:

• 4 дорожки, конфигурируемые keybindings (словарь lane → Key в настройках)

• Hold notes — ноты с удержанием, отдельная логика score и визуал

• Импорт.osz — стандартный формат карт osu!. Файл .osz это обычный ZIP, внутри .osu (текстовый формат описания карты) и аудио. NetFix парсит .osu, конвертирует в внутренний формат NoteMap/NoteEntry, аудио воспроизводится через ffmpeg

• Встроенные треки — упакованы в ZIP рядом с приложением (MP3 + notes.json)

• Discord RPC — когда открыта игра, в статусе Discord показывается название карты

Игровой цикл построен на DispatcherTimer (30fps+). Нотные спрайты — Border элементы на Canvas, без пересоздания: используется пул объектов. Кисти заморожены (brush.Freeze()) и кэшированы вне цикла рендера.

Модель ноты:

public class NoteEntry
{
    public double Time { get; set; }   // секунды от начала трека
    public int Lane { get; set; }      // 0–3
    [JsonIgnore] public bool Hit { get; set; }
    [JsonIgnore] public Border? Visual { get; set; }
    [JsonIgnore] public DropShadowEffect? Effect { get; set; }
}

Discord Rich Presence

DiscordRpcService показывает текущее состояние приложения в Discord‑статусе. Четыре состояния: главное меню, диагностика, игра (с названием карты и счётом), редактор карт.

Дизайн и визуальный стиль

Тёмная тема: фон #161616, акцентный цвет #3b82f6 (синий). Glassmorphism‑элементы, aurora‑анимация на главной кнопке. Весь UI — нативный WPF XAML, никаких сторонних UI‑фреймворков (MahApps, MaterialDesign и так далее — намеренно не использовались, чтобы не ломать стиль).

Итог

NetFix — это не очередной впн, не обфусцированный батник и не «доверься нам». Это прозрачная open‑source утилита, которая берёт два проверенных community‑инструмента (Zapret и TgWsProxy) и делает их запуск удобным для обычного пользователя.

Исходный код: github.com/rupleide/NetFix ^[3]

Обновления и обсуждение: t.me/NetFixRuBi ^[4]