Всё о wawity: от установки
до тонкой настройки

01Что такое wawity

wawity — это клиент, а не VPN-провайдер. Он берёт вашу subscription-ссылку, разбирает её, поднимает туннель на ядре sing-box и управляет сетью Windows: маршрутами, DNS, файрволом и приоритетами трафика.

02Две редакции: Desktop и CLI

Это два независимых продукта с отдельными установщиками. Ядро — сеть, парсер подписок, kill switch — у них общее, отличается только оболочка.

03Требования

• ОС: Windows 10 (1809+), Windows 11, Windows Server 2019/2022. Только x64.
• Права: подключение требует администратора — создаются TUN-адаптер и правила файрвола.
• Диск: ~60 МБ для Desktop, ~28 МБ для CLI.
• Сеть: исходящий доступ к серверам подписки. Порты не пробрасываются, входящих соединений нет.
• Опционально: WebView2 Runtime для Desktop — установщик поставит его сам, если не найдёт.

04Быстрый старт

Desktop за 3 шага

1. Запустите WawitySetup-Desktop.exe, подтвердите UAC, дождитесь распаковки.
2. В окне клиента вставьте ссылку подписки и нажмите «Добавить».
3. Нажмите «Подключиться» или выберите сервер вручную по замеренному пингу.

CLI за 3 команды

:: 1. добавить подписку
wawity sub add https://panel.example/sub/TOKEN --name main

:: 2. посмотреть серверы с пингом
wawity servers --ping

:: 3. подключиться к самому быстрому
wawity connect fastest

05Установщик Desktop

Один самодостаточный .exe: без сторонних инсталляторов и без загрузки компонентов из интернета, кроме WebView2 при его отсутствии.

Что делает установщик

• Распаковывает WawityApp.exe и ядро в C:\Program Files\Wawity.
• Создаёт ярлыки в меню «Пуск» и, по желанию, на рабочем столе.
• Регистрирует запись в «Программы и компоненты» для корректного удаления.
• Опционально включает автозапуск при входе в систему.

06Установщик CLI

Отдельный продукт со своим инсталлятором. На экране установки явно написано, что это консольная редакция и чем она отличается от обычной.

• Кладёт wawity.exe и ядро в C:\Program Files\Wawity.
• Добавляет папку в системный PATH и прописывает WAWITY_HOME.
• Рассылает системе уведомление об изменении окружения, чтобы новые окна терминала сразу видели команду.
• Создаёт ярлык «Wawity Console», открывающий консоль сразу в режиме wawity.
• Не ставит WebView2 и не создаёт оконных ярлыков.

Портативный запуск

CLI не требует установки: достаточно wawity.exe рядом с ядром. Данные всё равно сохраняются в профиле пользователя — см. раздел 29.

07Установка на сервер без GUI

Для Windows Server, машин без графической оболочки и развёртывания по SSH есть headless-режим: установщик не рисует окно, а печатает лог в текущую консоль.

:: вариант 1 — специально собранный файл
WawitySetup-CLI-serverinstall.exe

:: вариант 2 — обычный CLI-установщик с ключом
WawitySetup-CLI.exe -serverinstall
WawitySetup-CLI.exe -serverinstall -dir "D:\wawity"

:: удаление без окон
WawitySetup-CLI.exe -serverinstall -uninstall

Чем отличается серверный режим

• Не создаются ярлыки рабочего стола и меню «Пуск».
• Не проверяется и не ставится WebView2.
• Весь прогресс печатается в консоль вызывающего процесса.
• PATH и WAWITY_HOME прописываются на уровне машины, а не пользователя.

08Удаление и полная очистка

1. Отключите туннель: wawity disconnect или кнопка в GUI — это снимет правила файрвола.
2. Удалите продукт через «Параметры → Приложения» или запустив установщик повторно.
3. Деинсталлятор уберёт записи из PATH, задачу WawityAutostart и правила WawityFW_*.
4. Пользовательские данные удаляются отдельным флажком в мастере.

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

В корне репозитория лежит build.bat — интерактивное меню сборки. Оно собирает продукт и сразу упаковывает соответствующий установщик.

Требования к окружению

• Rust stable (MSVC) и Visual Studio Build Tools с компонентом C++.
• Node.js LTS — только для десктоп-фронтенда, для CLI не нужен.
• Стабильный доступ к crates.io; при проблемах с зеркалами — fix-cargo-mirror.bat.

Перед сборкой скрипт удаляет старые бинарники и проверяет, что в пакет попал именно нужный исполняемый файл — это защита от ситуации, когда CLI-установщик по ошибке содержал десктопное приложение.

10Обзор интерфейса

Десктоп-клиент — это окно с собственной титульной строкой и вертикальной навигацией слева. Разделов ровно четыре — больше ничего искать не придётся.

Окно и навигация

• Сверху — собственная титульная строка с иконкой, названием wawity и кнопками свернуть / развернуть / закрыть. Окно таскается за эту полосу.
• Слева — сайдбар с четырьмя пунктами и подсветкой-пилюлей активного раздела; внизу сайдбара показана версия.
• Если окно сузить, сайдбар заменяется нижней панелью с теми же четырьмя вкладками.
• На каждой странице своя анимированная сцена на фоне: чёрная дыра на «Подключении», пульсар в «Настройках», туманность в «Анализе» и Земля в «Серверах». Всё это отключается одним тумблером «Космические объекты на фоне».
• Всплывающие уведомления (тосты) появляются поверх любого раздела, опасные действия спрашивают подтверждение в модальном окне.

Главный экран «Подключение»

• Статус — одно из четырёх состояний: Защищено, Подключение…, Заблокировано (работает Always-On) и Не защищено.
• Кнопка по центру переключает Подключить / Отключить. Если сервер не выбран, клиент пишет «Сначала выберите сервер» и отправляет в раздел «Серверы».
• Бейджи режимов под кнопкой показывают, включены ли Kill Switch, Always-On и Multi-hop.
• Метрики: Пинг, Загрузка, Отдача и длительность Сессии. Сразу после подключения вместо пинга коротко горит «измерение…».
• При включённом Always-On и отсутствии туннеля сверху висит предупреждающий баннер о том, что интернет заблокирован.

11Подписки

Подписки живут в разделе «Серверы». Своих серверов у wawity нет: вы подключаете свою ссылку от любого провайдера.

1. Вставьте ссылку в поле «Вставьте URL подписки…» и нажмите Загрузить.
2. Клиент покажет, сколько серверов нашлось, и спросит подтверждение «Добавить подписку?».
3. После добавления подписка становится группой в списке серверов.

Действия над подпиской

Если панель отдаёт срок действия, рядом с подпиской появляется отсчёт вроде «осталось 12 дн.», а после окончания — метка «Истекла», и серверы становятся недоступны.

12Выбор сервера

• Два вида. В настройках выбирается «Колонки» (страна → серверы) или «Глобус» — серверы маркерами на вращающейся Земле.
• Поиск. Поле «Поиск серверов…» фильтрует список по имени и стране.
• Пинг. Кнопка «Пинг» в шапке измеряет все серверы сразу, цвет значения показывает качество.
• Авто. Подключает к самому быстрому из доступных серверов.
• Флаги и гео. Страна определяется по имени сервера; точнее — только с включённой онлайн-геолокацией, которая отправляет IP серверов стороннему сервису.
• Multi-hop. Если режим включён, сверху появляется баннер, а у каждого сервера — значок «назначить входным узлом». Текущий вход показан в баннере.

13Игры и раздельное туннелирование

Блок «Раздельное туннелирование» в настройках: приложения из списка ходят мимо туннеля и видят ваш реальный IP.

Три способа добавить приложение

• Из файла — выбрать .exe вручную или ввести путь вроде C:\Program Files\App\app.exe.
• Установленные приложения — список с поиском, отмечаете нужное галочками.
• Найти игры — автоматическое сканирование установок Steam, Epic Games, Riot и Battle.net плюс запущенных процессов.

Сканер собирает не только .exe самой игры, но и её лаунчер с анти-читом — группой. Для полного обхода нужны все компоненты группы, иначе анти-чит пойдёт через туннель, а игра мимо, и матчмейкинг может ругаться.

Отмеченное добавляется кнопкой «Добавить выбранное в обход» и попадает в список «Приложения в обходе». Если новая конфигурация не применилась, клиент сам откатывает список к последнему рабочему состоянию.

14Анализ трафика

Раздел «Анализ» показывает текущую сессию в реальном времени — без истории посещений и без содержимого трафика.

15Настройки

Все переключатели собраны в одном разделе и разбиты на группы. Изменения применяются кнопкой Сохранить настройки.

Что важно знать

• Always-On и выключение kill switch требуют подтверждения — это не случайные тумблеры.
• Строгая маршрутизация гонит в туннель всё без исключений и может ломать сетевые принтеры и общие папки.
• Разрешить небезопасный TLS стоит включать только если вы полностью доверяете панели провайдера.
• Онлайн-геолокация отправляет IP серверов стороннему сервису ради флагов; выключенная — страна определяется только по имени.
• Сбросить по умолчанию возвращает все настройки, включая автозапуск и список обхода.

16Трей и уведомления

• Закрытие окна не рвёт туннель — клиент продолжает работать в трее.
• Из трея доступно компактное окно со статусом и переключением подключения.
• С включённым «Запуском при старте системы» приложение стартует тихо, без окна.
• Уведомления сообщают о подключении, обрыве, сработавшем kill switch и об обновлённых подписках. Отключаются в группе «Приватность».
• Глобальная горячая клавиша работает и при скрытом окне.

17CLI: как запускать

Одна команда wawity работает в трёх режимах: интерактивная консоль, разовые команды и живой дашборд.

18Консоль wawity

При запуске экран очищается, появляется цветной ASCII-логотип, анимированный маскот и меню. После каждой команды экран перерисовывается, поэтому логотип и строка состояния всегда остаются сверху.

W A W I T Y   secure tunnel console v0.1.0

  ● Германия    ↓ 12.4 МБ (350 КБ/с)    ↑ 1.1 МБ (28 КБ/с)
  kill-switch: активен   post-quantum   pid 8124   серверов: 9
--------------------------------------------------------------------
  1 подключить . 2 быстро . 3 отключить . 4 серверы . 5 статус
  6 подписки . 7 настройки . 8 сеть . 9 панель . m меню . 0 выход

  wawity > _

Клавиши главного меню

Клавиши в списке серверов

n следующая страница · b предыдущая · p замерить пинг · s сортировка по задержке · f текст фильтр · a сбросить фильтр · 0 назад. Ввод номера подключает выбранный сервер; звёздочкой отмечен последний использованный узел.

Текстовые команды внутри консоли

Помимо цифр консоль понимает слова и терпит лишний префикс: connect 3, sub add <url>, wawity sub add <url> и status будут поняты одинаково. Ссылка автоматически очищается от кавычек, угловых скобок и markdown-обёртки.

19Полный список команд

Примеры

:: подключиться к третьему серверу списка в фоне
wawity connect 3

:: подключиться в переднем плане, Ctrl+C = отключение
wawity connect fastest --fg

:: цепочка: вход через Хельсинки, выход через Германию
wawity connect "Германия" --entry "Хельсинки"

:: подключение без блокировки трафика при обрыве
wawity connect fastest --no-killswitch

:: живой мониторинг
wawity status --watch

20Флаги и ключи

21TUI-дашборд

Команда wawity dash открывает полноэкранную панель: график скорости, список серверов, состояние правил и лог событий.

• Навигация стрелками или j/k, подключение — Enter.
• p замер пинга, d отключение, r обновление подписок.
• q или Esc выход из панели; туннель при этом не разрывается.
• Панель корректно работает по SSH и в Windows Terminal; в устаревшем консольном хосте возможны артефакты рамок.

22JSON-вывод и автоматизация

С флагом --json команды печатают структуру вместо оформленного текста — удобно для мониторинга и скриптов.

# поднять туннель, если он упал
$s = wawity status --json | ConvertFrom-Json
if (-not $s.connected) { wawity connect fastest }

# выгрузить список серверов с пингом
wawity servers --ping --json > servers.json

Поля статуса

23Автозапуск и постоянный туннель

1. Настройте подписку и убедитесь, что подключение проходит вручную.
2. Включите автозапуск — создаётся задача планировщика WawityAutostart с повышенными правами.
3. Для сервера включите always-on: сеть будет заблокирована до поднятия туннеля, что исключает утечку при перезагрузке.
4. Проверьте восстановление: перезагрузите машину и выполните wawity status.

24Протоколы

Протокол берётся из самой ссылки подписки — выбирать его вручную не нужно. Если провайдер даёт несколько вариантов одного сервера, сравните их массовым пингом.

25Как устроена сеть

• TUN-адаптер wawity-tun0 — виртуальный интерфейс, через который идёт туннелированный трафик. На нём же читаются счётчики.
• Локальный прокси на порту 18232 — точка входа для ядра, слушает только локальный интерфейс.
• DNS в туннеле — запросы перехватываются и отправляются через туннель на адрес 172.19.0.2.
• Bootstrap DNS — отдельный резолвер для первичного разрешения домена сервера до поднятия туннеля.
• Маршруты — добавляются с меньшей метрикой, чем системные, и снимаются при отключении.

:: есть ли адаптер и как он называется
netsh interface show interface

:: маршруты и метрики
route print 0.0.0.0

:: правила файрвола wawity
netsh advfirewall firewall show rule name=all | findstr WawityFW_

:: слушает ли локальный прокси
netstat -ano | findstr 18232

26Kill switch и always-on

Блокировка живёт в Windows Firewall. Правила создаются с префиксом WawityFW_, чтобы их можно было найти и снять даже без самого клиента.

• Обычный режим: блокировка включается вместе с туннелем и снимается при корректном отключении.
• Always-on: правила остаются и при опущенном туннеле — без VPN трафика не будет вообще.
• Аварийное завершение: при следующем запуске клиент находит свои правила и откатывает сеть автоматически.
• Аварийный выход: wawity repair снимает все правила, маршруты и возвращает DNS в исходное состояние.

Из блокировки всегда исключаются: локальная петля, DHCP, адреса серверов подписки, bootstrap DNS, сам TUN-адаптер и процессы из списка исключений.

27Системный QoS

Игровому трафику присваивается метка DSCP 46 (Expedited Forwarding) на уровне политики Windows. Роутер с поддержкой QoS обслужит такие пакеты вне очереди.

• Работает и без активного VPN-подключения.
• Не ускоряет канал как таковой — влияет только на порядок обслуживания при загруженной сети.
• Некоторые провайдеры сбрасывают метки DSCP на границе сети — эффект будет только внутри домашней сети.

28Multi-hop и post-quantum

Цепочка серверов

При multi-hop трафик сначала идёт на входной сервер, а затем на выходной. Выходной узел не видит ваш реальный адрес, но задержка складывается. Для игр режим не рекомендуется.

Post-quantum

Если сервер поддерживает гибридный обмен ключами, он используется автоматически. При несовместимости клиент откатывается к обычному рукопожатию; принудительно отключить можно флагом --no-quantum.

29Где что лежит

30Переменные окружения

31Диагностика: порядок действий

Если что-то не работает, идите по этой лестнице сверху вниз — в большинстве случаев ответ находится на первых трёх шагах.

1. Права. Консоль или клиент запущены от администратора?
2. Подписка. wawity sub refresh — сколько серверов вернулось?
3. Доступность. wawity servers --ping — есть ли хоть один ответивший узел?
4. Состояние. wawity status — что с PID, интерфейсом и kill switch?
5. Лог. Последние строки %TEMP%\wawity.log.
6. Сброс. wawity repair, затем повторное подключение.

32Про��лемы с подключением

33Проблемы сети и скорости

34Проблемы CLI и консоли

35Проблемы сборки

36Частые вопросы

37Глоссарий