# Установка бэкенда KPM

KPM — это Native-бэкенд уровня ядра для тех ядер, которые загружаемый `.ko`
**не потянет**: старые или не-GKI ядра (например, 4.9, 4.14), вендорские ядра
без исходников, ядра, отклоняющие неподписанные модули. Он скрывает на уровне
ядра так же, как `.ko`, без внедрения libc-хуков в процесс цели. Это не гарантирует
невидимость для любых проверок целостности или root. Это **один
универсальный модуль** — подбирать GKI-версию не нужно. Сначала прочитайте
[Какой Native-бэкенд выбрать](choosing-native.md).

## Нужна среда KernelPatch

KPM использует inline-хуки ядра, для которых в ядре должна присутствовать среда
KernelPatch. Выберите путь под свой root:

- **APatch / FolkPatch** — KernelPatch уже встроен. Просто поставьте ZIP модуля и
  сохраните **SuperKey** (см. ниже).
- **Magisk / KernelSU / KernelSU-Next** — используйте **KPatch-Next-Module** и
  его инструкцию по патчингу ядра либо интегрируйте KPatch-Next при самостоятельной
  сборке. Одна установка VPN Hide эту среду не предоставляет.

Если среды нет, Дашборд напишет, что *«ядро не пропатчено средой KernelPatch»*.

## Шаги

1. Убедитесь, что среда KernelPatch присутствует (см. выше).
2. Скачайте `vpnhide-kpm.zip` (Дашборд назовёт файл).
3. Установите **весь ZIP** через экран **Modules** своего root-менеджера как
   APM/Magisk-совместимый модуль. **Не** распаковывайте и не загружайте
   внутренний файл `vpnhide.kpm` сам по себе — без обвязки у него нет активатора,
   загрузочных скриптов и доставки конфигурации, и скрытие не заработает.
4. На APatch / FolkPatch сохраните свой **SuperKey** в **Settings → Security**
   (тот же, что вы задали в APatch/FolkPatch).
5. **Перезагрузитесь** и откройте **Дашборд** — Native-бэкенд должен показывать
   **Active**.

## Поддерживаемые ядра

KPM проверяет семейство вашего ядра при загрузке. Поддерживаются 4.4, 4.9, 4.14,
4.19, 5.4, 5.10, 5.15, 6.1, 6.6 и 6.12. Остальные семейства отклоняются, а не
угадываются. Если Дашборд пишет *«ядро не поддерживается… нет проверенной
таблицы смещений»*, используйте [бэкенд Zygisk](zygisk-install.md).

## Если установлен, но неактивен

Дашборд называет причину:

- **Нужен SuperKey** — APatch/FolkPatch не смог загрузить модуль по доверенному
  токену `su`. Сохраните SuperKey в **Settings → Security** и перезагрузитесь
  (или нажмите Refresh). Переустановка ZIP не помогает.
- **Нужна среда** — в ядре нет среды KernelPatch; установите её (см. выше).
- **Обнаружена standalone-установка** — загружен голый `vpnhide.kpm`, а модуля
  ZIP нет. Удалите отдельную запись, установите полный `vpnhide-kpm.zip` с экрана
  Modules и перезагрузитесь.
- **Конфликт с модулем ядра** — установлены и `.ko`, и KPM; они хукают одни и те
  же функции и могут намертво повесить устройство, поэтому KPM отступает.
  Удалите один из них. **Никогда не держите оба активными.**

При ошибке загрузки используйте **Settings → Debugging → Collect debug log**,
чтобы приложить вывод со старта к отчёту — см.
[Собрать отчёт для диагностики](collect-report.md).

## Инструкции по установке среды

Для поддерживаемых root-менеджеров, включая KernelSU-Next, используйте
[официальную инструкцию KPatch-Next-Module](https://github.com/KernelSU-Next/KPatch-Next-Module),
для интеграции в ядро — [проект KPatch-Next](https://github.com/KernelSU-Next/KPatch-Next).
ZIP VPN Hide сам не устанавливает и не встраивает среду KernelPatch.