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.3K ·GitHub
这是什么?KernelSU 是一种基于内核的 Android 设备 root 方案:su 和 root 权限的管理都直接在内核里完成。
那它只是个应用,还是会深入到系统底层?比应用更深层:su 和 root 管理是 Android 内核的一部分,所以设备必须运行内置 KernelSU 的内核;在上面再装一个独立的管理器应用来控制 root。
我怎么把它装到手机上?按照 README 的 Usage 部分所附官网上的安装指南操作。GKI 2.0 手机(内核 5.10+)是官方支持的方式;更旧的内核(4.14+)也能用,但得自己编译内核。
装了之后可能出什么问题吗?有——较新的内核版本引入了一个破坏性改动,会导致 KernelSU 在 x86_64 上运行失败,还可能触发内核崩溃(kernel panic)。官网上有详细说明,安装前请先确认你的内核版本。
它只能在手机上运行吗?不是——除了 Android 手机,它还能在 WSA、ChromeOS 以及基于容器的 Android 上运行。支持的 CPU 架构是 arm64-v8a 和 x86_64。
它支持无系统修改(systemless)吗?支持——模块系统构建在 metamodules 之上,这是一套可插拔的无系统修改基础设施,模块可以在不永久改动系统的情况下修改系统。
我能控制每个应用获得多少 root 权限吗?可以——App Profile 功能的设计目标就是把 root 权限“关进笼子里”,你可以限制获得 root 的应用能做什么,而不是给它们不受限制的权限。
这种基于内核的思路是怎么来的?项目致谢中提到:Kernel-Assisted Superuser 是这个想法的来源,Magisk 是强大的 root 工具,Diamorphine 则是部分 rootkit 技巧的出处。
Creator
tiann
Size
28.9 MB
Stars
19.3K
Age
3y
Commits · 90 Days