Skip to content

guide.md

Latest commit

 

History

History
354 lines (243 loc) · 29.1 KB

guide.md

File metadata and controls

354 lines (243 loc) · 29.1 KB
Raw
Lantern Logo

📖 Руководство пользователя Lantern

Подробное иллюстрированное руководство по всем разделам, функциям и настройкам


🏠 Главная • 📖 Руководство • 🎨 Галерея тем • 🚀 Установка • ⬇️ Релизы


📑 Содержание

  1. 🛡️ Важные рекомендации перед началом
  2. 🏠 Главный экран (Обзор)
  3. 🎵 Встроенный музыкальный плеер
  4. 🧩 Каталог стратегий и быстрое редактирование
  5. 🔎 Проверка соединения и диагностика
  6. ⚙️ Служба Windows (Автозапуск)
  7. 🎛️ Управление фильтрами и списками
  8. 🔄 Центр обновлений
  9. ⚙️ Настройки, оптимизация и профили
  10. 📋 Журнал событий
  11. ℹ️ Безопасность и проверка целостности
  12. ❓ Решение частых проблем (FAQ)

🛡️ Важные рекомендации перед началом

Перед началом активного использования Lantern обратите внимание на несколько ключевых моментов:

Important

Всегда запускайте Lantern от имени Администратора. Сетевой драйвер WinDivert64.sys, установка системной службы Windows и включение системного DNS-over-HTTPS требуют административных прав.

Warning

Не запускайте несколько копий winws.exe одновременно. Если у вас уже запущена служба zapret или открыт консольный BAT-скрипт из другой папки, они будут конфликтовать за захват сетевых пакетов через WinDivert. Перед запуском ручного режима в Lantern остановите службу.

Tip

После изменения фильтров требуется перезапуск. При изменении игрового фильтра (TCP/UDP) или списков IPSet необходимо перезапустить текущий обход на главном экране (или перезапустить службу), чтобы новые параметры вступили в силу.

🏠 Главный экран (Обзор)

Раздел Обзор — это центральный пульт управления состоянием вашей системы обхода.

Главный экран — Обзор

Основные элементы:

  • Карточка zapret:
    • Отображает текущее состояние (Работает / Остановлен / Запуск...), активную стратегию, режим работы (ручной запуск или системная служба) и время непрерывной работы (uptime).
    • Кнопка «Запустить / Остановить» переключает процесс.
    • Кнопка «Перезапуск» быстро перезапускает winws.exe с применением обновленных настроек (с плавной анимацией вращения иконки на 360°).
  • Карточка Telegram Proxy:
    • Позволяет в один клик запустить или остановить утилиту tg-ws-proxy (Flowseal) для снятия ограничений скорости с медиафайлов в Telegram Desktop.
    • Если компонент еще не скачан, Lantern предложит автоматически загрузить его из официального репозитория.
  • Счетчики сетевого трафика:
    • Демонстрируют текущую скорость входящего/исходящего трафика и общий объем переданных данных с момента запуска приложения.
  • Индикаторы системных компонентов:
    • Быстрый статус доступности Discord, YouTube, драйвера WinDivert и фоновой службы.

🎵 Встроенный музыкальный плеер

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

Возможности плеера:

  1. Мультиформатная поддержка:
    • Воспроизведение треков .mp3, .wav, .m4a, .aac, .flac, .wma, .ogg, .mp4.
  2. Интеллектуальное чтение тегов и обложек (AudioTagReader):
    • Автоматически извлекает обложки альбомов из ID3v2 (APIC/PIC), MP4 атомов (covr), FLAC picture блоков или файлов cover.jpg / folder.png.
    • Если обложка отсутствует, отображается фирменный арт.
  3. Плавный аудио- и видео-кроссфейд:
    • Мягкое синусоидальное угасание звучания текущей композиции и нарастание новой строго при готовности декодера MediaOpened.
    • Плавное визуальное растворение и появление обложки и названия трека.
  4. Управление громкостью и воспроизведением:
    • Плавный регулятор громкости с защитой от выхода за границы, быстрый Mute / Unmute, регулировка колёсиком мыши по карточке плеера.
    • Режим случайного воспроизведения Shuffle 🔀, перемотка по SeekBar, переключение треков ⏮️/⏭️ и кнопка скрытия.
    • Включение и отключение отображения плеера одной кнопкой в Настройки → Интерфейс.

🧩 Каталог стратегий и быстрое редактирование

Вкладка Стратегии содержит полный перечень встроенных конфигураций general*.bat для обхода блокировок.

Раздел Стратегии

Возможности раздела:

  1. Категории стратегий:
    • General — базовая универсальная стратегия.
    • ALT (ALT2–ALT12) — альтернативные алгоритмы фрагментации и модификации TCP/UDP заголовков.
    • FAKE (FAKE TLS AUTO и др.) — отправка поддельных TLS ClientHello для обхода жестких DPI-фильтров провайдеров.
    • SIMPLE — упрощенные профили обхода с минимальной нагрузкой на процессор.
  2. ⭐ Избранное:
    • Нажмите на звездочку рядом с любой стратегией, чтобы закрепить ее в самом верху списка для быстрого доступа.
  3. ⚙️ Быстрое редактирование в Блокноте:
    • Каждая карточка стратегии оснащена кнопкой-шестерёнкой ⚙️. Клик по ней мгновенно открывает соответствующий .bat-файл в Блокноте для тонкой ручной правки без риска случайно переключить активную стратегию.
  4. 🌐 Умная рекомендация по провайдеру (ISP):
    • Нажмите кнопку поиска рекомендации: Lantern безопасно определит вашего провайдера через зашифрованный запрос и порекомендует стратегию, статистически показавшую наибольшую эффективность (например, FAKE TLS для Ростелекома, МТС, Билайна).

🔎 Проверка соединения и диагностика

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

Раздел Проверка соединения и диагностика

Вкладки раздела:

Вкладка Назначение
📋 Цели (targets.txt) Проверка хостов из вашего конфигурационного файла utils/targets.txt.
🌐 Популярные сервисы Быстрый тест Discord (Voice, Gateway, Media), YouTube (Video CDN, Images) и Cloudflare.
🎮 Игровые серверы Проверка серверов популярных онлайн-игр (Steam, Riot, EA, Blizzard).
⚡ Тест стратегий (Бенчмарк) Автоматический последовательный прогон всех доступных BAT-стратегий с замером задержки и процента успешности.
🩺 Диагностика системы Полная проверка сетевого стека Windows, автоопределение конфликтов и инструменты быстрого ремонта в 1 клик.

Инструменты вкладки «Диагностика»:

  1. 🧪 Тест DPI Freeze:
    • Отправка пробного пакета 64 КБ для выявления скрытых разрывов ТСПУ на 16–20 пакетах.
  2. 🗑️ Очистка кэша Discord:
    • Удаление временных файлов кэша (Cache, Code Cache, GPUCache) для всех редакций Discord (Stable, PTB, Canary, Development) с подсчётом удалённых файлов.
  3. 🔄 Сброс WinDivert:
    • Безопасная выгрузка и удаление зависших драйверов WinDivert и WinDivert14 из реестра и диспетчера служб в 1 клик.
  4. 🔍 Глубокий аудит окружения:
    • Автоматическая проверка активности службы BFE, системного прокси (с кнопкой автоотключения), TCP Timestamps (с кнопкой автовключения), конфликтов с AdGuard, VPN-сервисами, Killer Network, SmartByte, а также проверка на наличие кириллических символов в путях и нахождение в каталоге OneDrive.

Note

Как работает бенчмарк стратегий: Lantern временно останавливает текущий обход, по очереди запускает каждую стратегию, ожидает инициализации winws.exe (5 сек.), отправляет HTTP/1.1, TLS 1.2 и TLS 1.3 запросы через сокеты и curl.exe, фиксирует задержку (Ping / RTT) и выстраивает рейтинг самых стабильных стратегий.

⚙️ Служба Windows (Автозапуск)

Установка Lantern в качестве системной службы Windows позволяет winws.exe стартовать автоматически при загрузке компьютера еще до входа пользователя в систему. В этом же разделе централизованно настраивается поведение фонового автозапуска.

Раздел Служба Windows

Как настроить службу и автозапуск:

  1. Установка системной службы:
    • Выберите нужную стратегию в выпадающем списке раздела Служба.
    • Нажмите кнопку «Установить службу».
    • Lantern создаст службу с именем zapret, настроит автозапуск (start= auto) и пропишет выбранную стратегию в системный реестр (HKLM\System\CurrentControlSet\Services\zapret).
    • Для удаления службы достаточно нажать кнопку «Удалить».
  2. Детект сторонней службы zapret:
    • Если в системе уже установлена служба zapret из другой папки или сторонней сборки, Lantern автоматически обнаружит её и выведет предупреждающий баннер с кнопками «Взять под управление» (мгновенно переключает службу на Lantern) или «Удалить».
  3. Единое управление автозапуском:
    • Автозапуск службы при старте системы — служба winws.exe стартует как фоновый сервис Windows без необходимости открывать окно программы.
    • Автозапуск приложения Lantern в трей — добавление задачи в планировщик Windows (LanternAutostart с наивысшими правами) для автоматического запуска Lantern в трей при входе в систему.

🎛️ Управление фильтрами и списками

Раздел Фильтры позволяет тонко настраивать параметры перехвата пакетов и управлять файлами доменов.

Раздел Фильтры

1. Игровой фильтр (Game Filter)

  • Выключен — обрабатывается только стандартный веб-трафик (порты 80, 443).
  • TCP + UDP — перехват и обход на динамических игровых портах 1024-65535.
  • Только TCP / Только UDP — выборочная фильтрация игровых протоколов.
  • Пользовательские порты — возможность вручную задать конкретные диапазоны игровых портов, чтобы исключить вмешательство в голосовые чаты и сетевую синхронизацию игр.

2. IPSet-фильтр

  • Загруженный список — фильтрация применяется только к адресам из файла lists/ipset-all.txt.
  • Отключен (Весь трафик) — обработка всех сетевых направлений.
  • Кнопка «Обновить списки» — автоматическая подгрузка свежих баз IPSet с GitHub.

3. DNS-over-HTTPS (DoH)

  • Включает безопасный зашифрованный системный резолвинг DNS на уровне Windows (Dnscache\Parameters\EnableAutoDOH).
  • Предотвращает перехват и подмену DNS-ответов провайдером.

4. Визуальный редактор списков

  • Позволяет просматривать, добавлять и удалять домены прямо из интерфейса для файлов list-general-user.txt, list-exclude-user.txt и ipset-exclude-user.txt.

🔄 Центр обновлений

Отдельный специализированный раздел Обновления обеспечивает централизованное обновление всех компонентов системы:

Раздел Центр обновлений

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

  • Раздельные карточки компонентов:
    • Движок zapret (Flowseal) — ядро DPI-фильтрации и актуальные наборы десинхронизационных BAT-стратегий.
    • Telegram-прокси (TG-WS-Proxy) — локальный MTProto-прокси для Telegram Desktop.
    • Оболочка Lantern — само графическое приложение.
  • Индикация версий: отображение локальной версии, доступного релиза на GitHub и статусных меток актуальности.
  • Прогресс загрузки в реальном времени: во время скачивания отображаются текущая скорость (МБ/с), точный размер скачанного файла (X / Y МБ) и анимированная полоса выполнения.

⚙️ Настройки, оптимизация и профили

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

Раздел Настройки

Ключевые возможности:

  • 🐶 Watchdog (Автопереключение при сбое): В фоновом режиме каждые $N$ минут опрашивает ключевые эндпоинты Discord и YouTube. Если провайдер заблокировал текущую стратегию, Watchdog автоматически переберет каталог стратегий и включит рабочую с сохранением режима работы службы.
  • ⚡ Экстремальная оптимизация ОЗУ (RAM):
    • Автоматическое усечение рабочего набора памяти (Core.TrimMemory()) при минимизации или сворачивании окна в системный трей.
    • Ленивая загрузка медиаплеера: движок воспроизведения инициализируется только при первом старте музыки, экономя до 70 МБ ОЗУ при обычном использовании.
  • 🎬 Кинематографичные переходы и сохранение позиции:
    • Плавный бесшовный переход между темами и языками с эффектом размытия (BlurEffect от 6px до 0) и затухания (Fade).
    • Позиция прокрутки страниц сохраняется с точностью до пикселя при смене тем и языков.
    • Полная поддержка режима «Уменьшение движения» (reduce_motion): анимации мгновенно отключаются при активации соответствующей системной опции.
  • 🛡️ Защитник Windows (Windows Defender):
    • Добавление папки приложения в исключения Защитника Windows в 1 клик для предотвращения блокировки драйвера WinDivert64.sys.
  • 🔄 Сброс до заводских настроек (Factory Reset):
    • Безопасная очистка локальной конфигурации, остановка обхода и возврат параметров к состоянию по умолчанию с диалогом подтверждения.
  • 📁 Профили настроек:
    • Сохраняйте рабочие комбинации (Стратегия + Фильтры + IPSet + DoH) в именованные профили для мгновенного переключения между играми, работой и просмотром видео.
  • 🍗 Настройки темы «Питер Гриффин»:
    • Включают полупрозрачный фон и аудиоплеер со случайным выбором треков из assets/peter-songs/.

📋 Журнал событий

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

Раздел Лог событий
  • [INFO] — информационные сообщения о запуске и переключении модулей.
  • [OK] — успешное завершение операций, прохождение проверок соединения.
  • [WARN] — предупреждения о таймаутах, конфликтах или отсутствии прав.
  • [ERR] — критические ошибки (сбои драйвера WinDivert, синтаксические ошибки параметров).

Tip

Кнопка «Диагностика»: Формирует подробный отчет о конфигурации вашей системы, версии Windows, статусе службы, наличии драйвера и последних 40 событиях лога с автоматическим маскированием персональных путей. Этот отчет можно скопировать при обращении в поддержку или создании Issue.

ℹ️ Безопасность и проверка целостности

Раздел «О программе» объединяет информацию о лицензии, версии компонентов и аутентичности файлов.

Раздел О программе
  • Проверка контрольных сумм SHA-256: в один клик сверяет хэши исполняемых файлов с официальным манифестом SHA256SUMS.txt.
  • Никаких сторонних серверов: Lantern не перенаправляет ваш трафик через сторонние серверы — весь обход выполняется локально с помощью драйвера WinDivert.
  • Открытый исходный код: исходный код полностью открыт для аудита в каталоге _app.

❓ Решение частых проблем (FAQ)

1. Ошибка: WinDivert не загружается или код ошибки 5 / 577
  • Убедитесь, что Lantern запущен от имени администратора.
  • Проверьте, что ваш антивирус не заблокировал драйвер bin/WinDivert64.sys (добавьте папку программы в исключения).
  • Убедитесь, что в системе не работают другие программы на базе WinDivert (GoodCheck, старые версии zapret).
2. Discord подключается к голосовому каналу бесконечно (RTC Connecting / No Route)
  • Перейдите в раздел Фильтры и переключите Игровой фильтр в режим TCP + UDP или Только UDP.
  • Перезапустите обход на главном экране.
  • Попробуйте стратегии из категории ALT (например, general (ALT11).bat или general (ALT4).bat).
3. YouTube не открывается или видео грузятся бесконечно
  • Проверьте статус файла hosts в Настройках (он не должен содержать старых заглушек для googlevideo).
  • Включите DNS-over-HTTPS в разделе Фильтры.
  • Запустите Бенчмарк стратегий в разделе Проверка соединения, чтобы найти стратегию с наименьшей задержкой для YouTube CDN.
4. Предупреждение Windows SmartScreen («Защитник Windows защитил ваш компьютер»)
  • Причина: Инсталлятор Lantern-Setup.exe распространяется бесплатно как проект с открытым исходным кодом. У него нет дорогостоящего ежегодного коммерческого EV-сертификата Microsoft (стоимостью более $500/год), поэтому встроенная система SmartScreen перестраховывается на новых релизах.
  • Как запустить: Нажмите на ссылку «Подробнее» в окне предупреждения SmartScreen, а затем на появившуюся кнопку «Выполнить в любом случае».
  • Проверка подлинности: Вы всегда можете сверить хэш скачанного файла с официальным файлом Lantern-Setup.exe.sha256 со страницы релизов либо загрузить файл на VirusTotal.
5. Антивирус блокирует драйвер WinDivert64.sys или папку приложения
  • Причина: Драйвер WinDivert осуществляет локальный перехват и модификацию пакетов сетевого стека на уровне ядра (Ring 0) для нейтрализации блокировок DPI. Некоторые эвристические анализаторы антивирусов могут воспринимать это как подозрительную сетевую активность (ложное срабатывание / False Positive).
  • Решение: Перейдите в Настройки → Антивирус и Защитник Windows и нажмите «Добавить в исключения Защитника» либо вручную внесите папку программы в белый список вашего стороннего антивируса.