KernelSU README

The project's README from github.com/tiann/KernelSU. As one markdown file: README.md.

English | Español | 简体中文 | 繁體中文 | 日本語 | 한국어 | Polski | Português (Brasil) | Türkçe | Русский | Tiếng Việt | Indonesia | עברית | हिंदी | Italiano

KernelSU

logo

A kernel-based root solution for Android devices.

Latest release Weblate Channel License: GPL v2 GitHub License

Features

  1. Kernel-based su and root access management.
  2. Module system based on metamodules: Pluggable infrastructure for systemless modifications.
  3. App Profile: Lock up the root power in a cage.

Compatibility state

KernelSU officially supports Android GKI 2.0 devices (kernel 5.10+). Older kernels (4.14+) are also supported, but the kernel will need to be built manually.

With this, WSA, ChromeOS, and container-based Android are all supported.

Currently, the arm64-v8a and x86_64 architectures are supported.

[!CAUTION] Recent kernel versions have implemented a breaking change causing KernelSU to fail and potentially trigger a kernel panic on x86_64! Check the website for more info!

Usage

Translation

To help translate KernelSU, we no longer accept translation contributions via Weblate. All translations are now handled using LLMs.

If you would like to add support for a new language, feel free to open a PR. Please note that modifications to existing English and Chinese translations are not accepted.

Discussion

Security

For information on reporting security vulnerabilities in KernelSU, see SECURITY.md.

License

Credits

KernelSU (tiann/KernelSU)

Searching Database…

19.4K ·GitHub
Что это такое?KernelSU — это решение для получения root на Android-устройствах, работающее на уровне ядра: управление su и root-доступом выполняется прямо внутри ядра.
Так это просто приложение или оно залезает глубже в систему?Глубже: su и управление root — часть самого ядра Android, поэтому на устройстве должно стоять ядро со встроенным KernelSU; отдельное приложение-менеджер поверх используется для управления root.
Как установить его на телефон?Через руководство по установке на официальном сайте, ссылка на который есть в разделе Usage файла README. Основной путь — телефоны с GKI 2.0 (ядро 5.10 и новее); более старые ядра (4.14+) тоже подходят, но ядро придётся собрать самому.
А что может пойти не так, если я его установлю?Кое-что: в последних версиях ядра появилось критическое изменение, из-за которого KernelSU не работает на x86_64 и может вызвать kernel panic (панику ядра). Подробности есть на сайте, так что сначала проверьте версию своего ядра.
Он работает только на телефонах?Нет — помимо Android-телефонов он работает на WSA, ChromeOS и в Android, запущенном в контейнерах. Поддерживаемые архитектуры процессора — arm64-v8a и x86_64.
Он поддерживает изменения без правки системы (systemless)?Да — система модулей построена на metamodules, подключаемой инфраструктуре для systemless-изменений: модули могут менять систему, не изменяя её насовсем.
Могу ли я ограничить, сколько root-полномочий получает каждое приложение?Да — функция App Profile создана, чтобы держать root-полномочия «в клетке»: можно ограничить, что позволено делать приложениям с root, вместо того чтобы раздавать им неограниченный доступ.
Что подсказало идею подхода на уровне ядра?В благодарностях Kernel-Assisted Superuser назван источником идеи, Magisk — мощным инструментом для root, а Diamorphine — происхождением некоторых приёмов, позаимствованных из руткитов.
Creator
tiann
Size
28.9 MB
Stars
19.4K
Age
3y
Commits · 90 Days