Skip to content

Latest commit

 

History

39 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Lantern Logo

🏮 Lantern

Современный, легковесный и мощный GUI-менеджер для zapret и winws

Windows .NET Framework C# WPF License: MIT Downloads Latest Release


📥 Скачать установщик📖 Руководство пользователя🎨 Галерея тем🧑‍💻 Исходный код


Главный интерфейс Lantern


📌 О проекте

Lantern — это высокопроизводительная графическая оболочка для zapret (winws.exe) и драйвера WinDivert в среде Windows. Приложение берет на себя всю рутину управления обходом DPI-блокировок: запуск и остановку процессов, установку и мониторинг системной службы, тестирование доступности сервисов, умный подбор стратегий под вашего провайдера и фоновую защиту соединения.

Note

Весь интерфейс написан на чистом C# и WPF без использования тяжелых XAML-разметок. Lantern напрямую использует проверенные BAT-стратегии zapret, динамически парсит аргументы запуска и не вмешивается во внутреннюю логику обхода.


🧭 Навигация по документации

Раздел Описание Ссылка
🏠 Главная Обзор возможностей, установка и сборка из исходников Перейти
📖 Руководство Полный разбор всех разделов, настроек, фильтров, плеера и службы Windows Открыть docs/guide.md
🎨 Темы оформления Описание и скриншоты 6 встроенных тем (Dark, AMOLED, Light, Aurora, Sunset, Peter) Открыть docs/themes.md

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

  ⚡ Запуск в 1 клик       🔎 Тест соединений       🛠️ Служба Windows
  ┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
  │ Старт, стоп и   │      │ Проверка HTTP,  │      │ Автозапуск      │
  │ рестарт winws   │ ───► │ TLS 1.2/1.3 и   │ ───► │ winws вместе    │
  │ из 20+ BAT      │      │ ICMP Ping       │      │ с системой      │
  └─────────────────┘      └─────────────────┘      └─────────────────┘
           │                        │                        │
           ▼                        ▼                        ▼
  ┌─────────────────┐      ┌─────────────────┐      ┌─────────────────┐
  │ Умный подбор по │      │ Интеграция с    │      │ Встроенный      │
  │ ISP провайдера  │      │ TG-WS-Proxy     │      │ плеер и 6 тем   │
  └─────────────────┘      └─────────────────┘      └─────────────────┘
  🌐 Рекомендации          ✈️ Telegram Desktop       🎵 Музыка & Дизайн

Функция Описание
Управление в один клик Мгновенный запуск, остановка и перезапуск winws.exe с любой из 20+ готовых стратегий.
🌐 Умная рекомендация по ISP Автоопределение провайдера (Ростелеком, МТС, Билайн, МегаФон, Дом.ру, Теле2 и др.) с live-тестом за 1.5 сек и предложением лучшей стратегии под ваш ТСПУ.
🚀 Сверхбыстрый бенчмарк Параллельное тестирование всех 20+ стратегий за ~40 секунд вместо 28 минут без ложных сбоев и зависаний.
🎧 Надёжная проверка сервисов Честная проверка Discord, YouTube и хостов через браузерный стек HttpWebRequest с прозрачной поддержкой VPN и фолбэком на curl -k.
🛡️ Защита от Windows Defender Встроенное добавление папки программы в исключения Защитника Windows в 1 клик для предотвращения блокировки драйвера WinDivert.
🎨 Векторные Lucide Icons & Анимации Чёткие официальные SVG-иконки Lucide и живые микро-анимации (поворот шестерёнки на 90°, оборот на 360°, кардио-пульс, покачивание).
🎵 Встроенный музыкальный плеер Мини-плеер в боковой панели с поддержкой аудиоформатов (.mp3, .flac, .wav, .m4a и др.), чтением обложек тегов, плавным кроссфейдом и регулятором громкости.
🚀 Плавность 144Hz / 240Hz Экстремальная оптимизация UI: Win32 ServiceController RPC (0.02мс), VSync-интерполяция прокрутки и in-place обновление интерфейса.
🛡️ Служба Windows Бесшовная установка winws.exe в качестве системной службы с автозапуском до входа пользователя.
🐶 Watchdog (Сторож) Фоновый мониторинг связи и автоматическое переключение на рабочую стратегию при блокировке текущей.
✈️ Telegram Proxy Встроенное управление и автозапуск утилиты tg-ws-proxy для максимальной скорости Telegram Desktop.
🎛️ Гибкие фильтры Быстрое переключение игрового фильтра (TCP / UDP), списков IPSet и системного DNS-over-HTTPS (DoH).
📋 Журнал реального времени Подробный цветной лог событий с индикацией нормальной работы, предупреждений и сбоев.
🎨 6 динамических тем Тёмная, AMOLED, Светлая, «Северное сияние», «Закат» (Tokyo Night) и «Питер Гриффин» — мгновенное переключение без перезапуска.
🔄 Умное автообновление Синхронизированная загрузка свежих релизов zapret, TG Proxy и Lantern с фиксацией локальной версии и плавным прогресс-баром.

🚀 Установка и первый запуск

Способ 1: Установщик (Рекомендуется)

  1. Скачайте Lantern-Setup.exe со страницы последнего релиза.
  2. Запустите установщик и следуйте простым подсказкам мастера.
  3. Запустите Lantern от имени администратора.
  4. При первом старте Lantern автоматически загрузит актуальную сборку zapret.

Important

Для взаимодействия с сетевым драйвером WinDivert, создания системных служб и применения DNS-over-HTTPS требуются права администратора.

Способ 2: Портативный запуск

  1. Скачайте Lantern.exe со страницы последнего релиза и положите его в удобную папку (например, D:\Lantern; в C:\Program Files лучше ставить установщиком).
  2. Убедитесь, что компоненты zapret лежат рядом: либо в подпапке zapret\ возле Lantern.exe, либо прямо возле него (папки bin, lists, utils). Если их нет, Lantern предложит скачать их при первом запуске.
  3. Запустите Lantern.exe от имени администратора.

🧑‍💻 Сборка из исходного кода

Сборка Lantern не требует установки Visual Studio, MSBuild или сторонних пакетов. Достаточно встроенного в Windows компилятора csc.exe из поставки .NET Framework:

# Перейдите в каталог исходного кода
cd _app

# Запустите скрипт компиляции
build.cmd

Скрипт собирает _app/zapret.exe и копирует его в корень репозитория как Lantern.exe и zapret.exe — переименовывать вручную ничего не нужно.

📦 Сборка установщика через Inno Setup

Если вам требуется собрать единый инсталлятор Lantern-Setup.exe:

  1. Установите Inno Setup 6.
  2. Откройте файл _installer/Lantern.iss.
  3. Нажмите кнопку Compile (или Ctrl + F9).
  4. Готовый установщик будет сохранен в папке _installer/.

🗂️ Структура проекта

lantern-zapret/
├── _app/               # 💻 Исходный код приложения на C# и WPF (Pure Code-behind)
│   ├── App.cs          # Точка входа, перехват ошибок, инициализация стилей
│   ├── Core.*.cs       # Системное ядро: процессы, сеть, стратегии, служба, конфиг
│   ├── View.*.cs       # Страницы интерфейса: Обзор, Стратегии, Проверка, Фильтры и др.
│   ├── Theme.cs        # Палитры и динамическая дизайн-система тем
│   ├── Loc.cs          # Двуязычная локализация (RU / EN)
│   ├── build.cmd       # Однострочный скрипт сборки через csc.exe
│   └── app.ico         # Фирменная иконка приложения
│
├── _installer/         # 📦 Конфигурация сборщика Inno Setup
│   └── Lantern.iss     # Сценарий генерации инсталлятора
│
├── docs/               # 📚 Документация и медиа-ресурсы
│   ├── guide.md        # Подробное иллюстрированное руководство пользователя
│   ├── themes.md       # Галерея и описание всех тем оформления
│   ├── screenshot.png  # Главный скриншот программы
│   ├── screens/        # Скриншоты разделов для руководства
│   └── themes/         # Скриншоты отдельных тем
│
├── assets/peter-songs/ # 🎵 Треки встроенного плеера (попадают в установщик)
└── .github/workflows/  # 🤖 Сборка релиза: Lantern.exe, установщик и его SHA256

Note

Компонентов движка (bin/, lists/, utils/, general*.bat) в репозитории нет — они перечислены в .gitignore и скачиваются приложением при первом запуске со страницы релизов Flowseal/zapret-discord-youtube: при обычной установке они попадают в <папка программы>\zapret\, при работе из исходников — в корень репозитория. Готовые Lantern.exe и Lantern-Setup.exe тоже не хранятся в репозитории: их собирает workflow Release и публикует как ассеты релиза.


🖥️ Системные требования

Компонент Минимальные требования
Операционная система Windows 10 (версия 1809+) или Windows 11 (x64 / ARM64)
Среда выполнения .NET Framework 4.5 или новее (предустановлен в Windows 8 и новее)
Привилегии Права локального администратора (для работы WinDivert)
Свободное место ~25 МБ на диске (включая компоненты zapret)

🤝 Благодарности и используемые проекты

Разработка Lantern опирается на фундаментальные проекты сообщества по исследованию и обходу DPI:

  • bol-van/zapret — мультиплатформенный комплекс обхода DPI и утилита winws.
  • Flowseal/zapret-discord-youtube — оптимизированные конфигурации, списки и стратегии для Discord и YouTube.
  • Flowseal/tg-ws-proxy — решение для ускорения и проксирования Telegram Desktop.

⚖️ Лицензия

Проект распространяется под свободной лицензией MIT. Подробности в файле LICENSE.txt.


⭐ Поставить звезду проекту на GitHub


Разработано с ❤️ для свободного и быстрого интернета.

About

WPF-приложение для управления обходом блокировок Discord и YouTube через zapret (winws)

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages