KAA VPN для Windows · версия 0.1.0

Запуск
1. Выберите пакет для своего компьютера:
   • x64 — Windows 10/11 на Intel или AMD;
   • ARM64 — Windows 11 на процессоре ARM, например Snapdragon.
   Архитектура указана в «Параметры → Система → О системе → Тип системы».
2. Распакуйте весь ZIP в отдельную папку. Сохраните рядом с программой
   папку engines и остальные файлы: одного EXE для запуска недостаточно.
3. Запустите «KAA VPN.exe» и подтвердите запрос прав администратора.
   Права нужны для создания сетевого адаптера TUN и маршрутов VPN.
   Устанавливать .NET отдельно не требуется: среда включена в пакет.

EXE этой версии не подписан сертификатом Authenticode. Windows может
показать неизвестного издателя или предупреждение SmartScreen.
Проверяйте происхождение пакета и контрольные суммы SHA256 из поставки.
Архитектуры приложения и движков в папке engines должны совпадать.

Подключение через аккаунт KAA
1. Нажмите «Войти», введите email и затем 8 цифр из письма. Код действует
   10 минут. При первом входе аккаунт создаётся, если это разрешено сервисом.
2. Убедитесь, что у аккаунта есть активная Подписка и свободное место.
   Кнопка личного кабинета открывает существующий кабинет KAA в браузере.
3. Нажмите «Подключить этот ПК», задайте название и подтвердите добавление.
   Только это действие занимает место в Подписке; сам вход не добавляет ПК.
4. Выберите сервер и нажмите «Подключить». Статус «Соединение защищено»
   появляется после проверки движка, адаптера, маршрутов и выхода в интернет.

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

Подключение по персональной ссылке
Нажмите «Добавить подключение» и вставьте HTTPS-ссылку устройства KAA
из личного кабинета. Также можно импортировать ссылки vless://,
hysteria2://, hy2:// или список таких ссылок.
HTTPS-подписки принимаются только с https://app.kaavpn.com/sub/…
или https://app.kaavpn.com/invite/sub/…. Произвольные сайты не загружаются.
Неподдерживаемые или некорректные ссылки внутри Подписки пропускаются;
остальные поддерживаемые серверы остаются доступны.

Используйте ссылку конкретного устройства. Старые общие ссылки и ссылки
слотов не содержат доступный VPN-профиль. Ссылка привязывается к постоянному
идентификатору установки; ссылку, занятую другим устройством, подключить
не получится. Идентификатор установки не является аппаратной аттестацией.
Ссылки и профили содержат данные доступа — не публикуйте их.

Что умеет эта версия
• VLESS с TLS или Reality, Hysteria2, VLESS XHTTP («LTE · XHTTP» в каталоге).
• Общий маршрут IPv4/IPv6 через TUN и DNS через VPN.
• Обновление персональной Подписки и выбор сервера/протокола.
• Вход по email, восстановление сессии, явное добавление Windows-устройства.
• Хранение аккаунта и профилей с защитой Windows DPAPI для текущего
  пользователя Windows; обычный текстовый файл с токенами не создаётся.

AmneziaWG пока не подключается. Если сервер прислал такой профиль,
выберите VLESS, Hysteria2 или XHTTP. Постоянная блокировка интернета
при обрыве VPN (kill switch) не реализована: после отключения туннеля
обычный доступ к интернету может восстановиться. Автозапуск и фоновая
служба этой версией не устанавливаются.

Трей и выход
Сворачивание окна оставляет работающий VPN в системном трее. Двойной щелчок
по значку открывает окно; меню значка позволяет отключить VPN или выйти
из приложения. Крестик закрытия окна завершает приложение и отключает VPN.
«Выйти» из аккаунта отключает туннель, отзывает сессию и удаляет сохранённые
вход и профили на этом ПК. Устройство остаётся в аккаунте, пока вы не
удалите его в кабинете. Для отзыва сессии нужно соединение с сервером;
при сетевой ошибке выход не подтверждается, и его можно повторить.

Если подключение не получилось
• Проверьте интернет без VPN, активность доступа и выбранный сервер.
• Нажмите «Обновить»: при подготовке серверных профилей повторите позже.
• При сообщении о занятой ссылке получите отдельную ссылку этого ПК.
• Не смешивайте файлы пакетов x64 и ARM64. Папка engines должна содержать
  sing-box.exe и xray.exe из той же поставки.
• Запрос Windows на повышение прав должен быть подтверждён для запуска.
• Подробные результаты выполненных проверок смотрите в отчёте поставки.
  Сборка EXE и автоматические тесты сами по себе не подтверждают реальное
  VPN-подключение на каждой версии Windows, сети и модели компьютера.

Исходники и лицензии
Приложение KAA распространяется по GPL-3.0-or-later; текст — LICENSE.txt.
Уведомления движков и зависимостей сохранены в NOTICE.txt и licenses/.
Исходники интерфейса/API и отдельный полный архив исходников движков
нужны вместе для пересборки всей поставки. Инструкция — BUILD-RU.txt.
Пакет не содержит продукционных паролей, профилей или серверных ключей.

Удаление
Отключите VPN, завершите программу и удалите распакованную папку.
Зашифрованные настройки находятся в %LOCALAPPDATA%\KAA VPN.
Чтобы удалить сохранённый вход с отзывом сессии, сначала нажмите «Выйти»
в приложении при доступном сервере. Удаление папки настроек само по себе
не отзывает сессию на сервере и не освобождает место устройства в тарифе.
