58 lines
2.9 KiB
Markdown
58 lines
2.9 KiB
Markdown
|
**English** | [Español](README_ES.md) | [简体中文](README_CN.md) | [繁體中文](README_TW.md) | [日本語](README_JP.md) | [한국어](README_KR.md) | [Polski](README_PL.md) | [Português (Brasil)](README_PT-BR.md) | [Türkçe](README_TR.md) | [Русский](README_RU.md) | [Tiếng Việt](README_VI.md) | [Indonesia](README_ID.md) | [עברית](README_IW.md) | [हिंदी](README_IN.md)
|
||
|
|
|
||
|
|
# KernelSU
|
||
|
|
|
||
|
|
<img src="https://kernelsu.org/logo.png" style="width: 96px;" alt="logo">
|
||
|
|
|
||
|
|
A Kernel-based root solution for Android devices.
|
||
|
|
|
||
|
|
[](https://github.com/tiann/KernelSU/releases/latest)
|
||
|
|
[](https://hosted.weblate.org/engage/kernelsu)
|
||
|
|
[](https://t.me/KernelSU)
|
||
|
|
[](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
|
||
|
|
[](/LICENSE)
|
||
|
|
|
||
|
|
## Features
|
||
|
|
|
||
|
|
1. Kernel-based `su` and root access management.
|
||
|
|
2. Module system based on [OverlayFS](https://en.wikipedia.org/wiki/OverlayFS).
|
||
|
|
3. [App Profile](https://kernelsu.org/guide/app-profile.html): 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 compatible, but the kernel will have to be built manually.
|
||
|
|
|
||
|
|
With this, WSA, ChromeOS, and container-based Android are all supported.
|
||
|
|
|
||
|
|
Currently, only `arm64-v8a` and `x86_64` are supported.
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
- [Installation Instruction](https://kernelsu.org/guide/installation.html)
|
||
|
|
- [How to build?](https://kernelsu.org/guide/how-to-build.html)
|
||
|
|
- [Official Website](https://kernelsu.org/)
|
||
|
|
|
||
|
|
## Translation
|
||
|
|
|
||
|
|
To help translate KernelSU or improve existing translations, please use [Weblate](https://hosted.weblate.org/engage/kernelsu/). PR of Manager's translation is no longer accepted, because it will conflict with Weblate.
|
||
|
|
|
||
|
|
## Discussion
|
||
|
|
|
||
|
|
- Telegram: [@KernelSU](https://t.me/KernelSU)
|
||
|
|
|
||
|
|
## Security
|
||
|
|
|
||
|
|
For information on reporting security vulnerabilities in KernelSU, see [SECURITY.md](/SECURITY.md).
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
- Files under the `kernel` directory are [GPL-2.0-only](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html).
|
||
|
|
- All other parts except the `kernel` directory are [GPL-3.0-or-later](https://www.gnu.org/licenses/gpl-3.0.html).
|
||
|
|
|
||
|
|
## Credits
|
||
|
|
|
||
|
|
- [kernel-assisted-superuser](https://git.zx2c4.com/kernel-assisted-superuser/about/): the KernelSU idea.
|
||
|
|
- [Magisk](https://github.com/topjohnwu/Magisk): the powerful root tool.
|
||
|
|
- [genuine](https://github.com/brevent/genuine/): apk v2 signature validation.
|
||
|
|
- [Diamorphine](https://github.com/m0nad/Diamorphine): some rootkit skills.
|