Github Releases下载加速

使用提示
在项目页面复制网址即可 例如: https://github.com/topjohnwu/Magisk/
项目自述
keyboard_arrow_down

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 OverlayFS.
  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, only the arm64-v8a and x86_64 architectures are supported.

Usage

Translation

To help translate KernelSU or improve existing translations, please use Weblate. PR of Manager’s translation is no longer accepted, because it will conflict with Weblate.

Discussion

Security

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

License

Credits

v1.0.5
正式版
发布文件
keyboard_arrow_down
v1.0.3
正式版
  • [Manager]: UI improvements
  • [Module]: Fix potential corruption of module files during updates or installations.
  • [Kernel]: Resolve occasional reboots when using su.
  • [SU]: Correct the global mount namespace issue.
发布文件
keyboard_arrow_down
v1.0.2
正式版
  • [Kernel] Support for kernel version 6.6
  • [Module] Support for action.sh
  • [Manager] Various UI improvements

WARNING: Non-GKI devices should not upgrade to this version!

发布文件
keyboard_arrow_down
v1.0.1
正式版

What's Changed

  • manager: fix translation errors in zh_CN by @WenHao2130 in https://github.com/tiann/KernelSU/pull/1790
  • 从非官方支持设备中移除K-Nel-M1721 by @KNKJ55 in https://github.com/tiann/KernelSU/pull/1792
  • non-GKI:Remove maintainer Coconutat's repositories by @Coconutat in https://github.com/tiann/KernelSU/pull/1794
  • Convert devpts domain to ksu_file by @aviraxp in https://github.com/tiann/KernelSU/pull/1801
  • manager: fix update no response when changelog is empty by @TinyHai in https://github.com/tiann/KernelSU/pull/1786
  • build(deps-dev): bump vitepress from 1.2.2 to 1.2.3 in /website by @dependabot in https://github.com/tiann/KernelSU/pull/1803
  • build(deps): bump zip from 2.1.0 to 2.1.2 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1799
  • build(deps): bump zip-extensions from 0.6.2 to 0.7.0 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1798
  • website: update translations by @igormiguell in https://github.com/tiann/KernelSU/pull/1796
  • build(deps): bump lifecycle from 2.8.0 to 2.8.1 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1782
  • build(deps): bump agp from 8.4.1 to 8.5.0 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1824
  • build(deps): bump androidx.compose:compose-bom from 2024.05.00 to 2024.06.00 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1820
  • build(deps): bump clap from 4.5.4 to 4.5.7 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1817
  • build(deps): bump regex from 1.10.4 to 1.10.5 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1815
  • build(deps): bump zip from 2.1.2 to 2.1.3 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1810
  • website: fix typo by @dabao1955 in https://github.com/tiann/KernelSU/pull/1807
  • Redirect the Feature Requests issue template tab by @dabao1955 in https://github.com/tiann/KernelSU/pull/1788
  • manager: improve grammar in english by @igormiguell in https://github.com/tiann/KernelSU/pull/1814
  • build(deps): bump com.google.devtools.ksp from 2.0.0-1.0.21 to 2.0.0-1.0.22 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1811
  • Translations update from Hosted Weblate by @weblate in https://github.com/tiann/KernelSU/pull/1734
  • throne_tracker: skip iterate if failed to open dir by @5ec1cff in https://github.com/tiann/KernelSU/pull/1832
  • Update resetprop by @aviraxp in https://github.com/tiann/KernelSU/pull/1842
  • build(deps): bump log from 0.4.21 to 0.4.22 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1843
  • build(deps): bump android_logger from 0.13.3 to 0.14.1 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1830
  • website: fix typo by @igormiguell in https://github.com/tiann/KernelSU/pull/1834
  • build(deps): bump clap from 4.5.7 to 4.5.8 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1850
  • build(deps): bump lifecycle from 2.8.1 to 2.8.3 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1851
  • ksud: [Fix] grant root to the shell in debug mode by @RobinChenJP in https://github.com/tiann/KernelSU/pull/1853
  • ksud: upgrade zip by @yujincheng08 in https://github.com/tiann/KernelSU/pull/1859
  • Revert "ksud: [Fix] grant root to the shell in debug mode" by @yujincheng08 in https://github.com/tiann/KernelSU/pull/1860
  • build(deps-dev): bump vitepress from 1.2.3 to 1.3.0 in /website by @dependabot in https://github.com/tiann/KernelSU/pull/1865
  • Upgrade gradle by @yujincheng08 in https://github.com/tiann/KernelSU/pull/1866
  • Setup Android SDK by @yujincheng08 in https://github.com/tiann/KernelSU/pull/1867
  • build(deps): bump clap from 4.5.8 to 4.5.9 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1868
  • build(deps): bump rust-embed from 8.4.0 to 8.5.0 in /userspace/ksud by @dependabot in https://github.com/tiann/KernelSU/pull/1869
  • Allow skipping commented policy by @aviraxp in https://github.com/tiann/KernelSU/pull/1870
  • build(deps): bump agp from 8.5.0 to 8.5.1 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1873
  • build(deps): bump com.google.devtools.ksp from 2.0.0-1.0.22 to 2.0.0-1.0.23 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1872
  • build(deps-dev): bump vitepress from 1.3.0 to 1.3.1 in /website by @dependabot in https://github.com/tiann/KernelSU/pull/1879
  • Upgrade deps by @yujincheng08 in https://github.com/tiann/KernelSU/pull/1886
  • build(deps): bump org.lsposed.libcxx:libcxx from 27.0.11718014-beta1 to 27.0.12077973 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1885
  • build(deps): bump io.coil-kt:coil-compose from 2.6.0 to 2.7.0 in /manager by @dependabot in https://github.com/tiann/KernelSU/pull/1888
  • Upgrade zip by @yujincheng08 in https://github.com/tiann/KernelSU/pull/1891
  • Group dependabot dependencies by @yujincheng08 in https://github.com/tiann/KernelSU/pull/1892
  • build(deps): bump the crates group in /userspace/ksud with 40 updates by @dependabot in https://github.com/tiann/KernelSU/pull/1894
  • build(deps): bump the npm group in /website with 13 updates by @dependabot in https://github.com/tiann/KernelSU/pull/1893
  • build(deps): bump the crates group in /userspace/ksud with 3 updates by @dependabot in https://github.com/tiann/KernelSU/pull/1898
  • build(deps): bump the npm group in /website with 2 updates by @dependabot in https://github.com/tiann/KernelSU/pull/1899
  • Upgrade rustix by @yujincheng08 in https://github.com/tiann/KernelSU/pull/1900
  • build(deps): bump syn from 2.0.71 to 2.0.72 in /userspace/ksud in the crates group by @dependabot in https://github.com/tiann/KernelSU/pull/1902
  • build(deps): bump the npm group in /website with 3 updates by @dependabot in https://github.com/tiann/KernelSU/pull/1903
  • build(deps): bump the npm group in /website with 3 updates by @dependabot in https://github.com/tiann/KernelSU/pull/1905
  • build(deps): bump the crates group in /userspace/ksud with 7 updates by @dependabot in https://github.com/tiann/KernelSU/pull/1908
  • build(deps): bump the npm group in /website with 6 updates by @dependabot in https://github.com/tiann/KernelSU/pull/1907

New Contributors

  • @WenHao2130 made their first contribution in https://github.com/tiann/KernelSU/pull/1790
  • @RobinChenJP made their first contribution in https://github.com/tiann/KernelSU/pull/1853

Full Changelog: https://github.com/tiann/KernelSU/compare/v1.0.0...v1.0.1

发布文件
keyboard_arrow_down
v1.0.0
正式版

KernelSU has been born for two years. Today we officially welcome version 1.0!

Due to the fact that we haven't added features to non-GKI devices for a long time, and maintaining them requires a significant amount of time, we have removed support for non-GKI devices. Non-GKI devices can only stay on version 0.9.5 (the manager can update). In the future, we will focus on adding new features for GKI devices.

Our energy is limited, but the rewards are even more limited, so please understand our choice, thank you!

发布文件
keyboard_arrow_down
v0.9.5
正式版
  • [Kernel] Fix random reboot caused by potential deadlock
  • [Kernel] Support private space for Android 15
  • [Manager] Fix file residue after complete uninstallation
  • [Manager] Support saving logs locally
发布文件
keyboard_arrow_down
v0.9.4
正式版
  • [Manager]: Fix selecting KMI not working.
  • [Kernel]: hook stable symbols to improbe compatibility.
  • [Module]: Update resetprop.
  • [Manager]: Some UI improvements.
  • [Kernel]: Fix some detection issues.
发布文件
keyboard_arrow_down
v0.9.3
正式版
  • [Kernel]: Let the kernel choose who is qualified to be the manager, avoiding potential side-channel attacks.
  • [Manager]: Support uninstall permanently and restore stock boot in Settings. You can restore stock boot before OTA to avoid download the full firmware.
  • [Module]: Fix the issue of the App Profile template page not opening.
  • [Manager]: Fix scroll issues in Settings.
  • [Manager]: Support choose kmi manually for installation.
  • [Manager]: Fix dark mode not working in Splash Screen.
  • [WebUI]: Allow opening multiple modules simultaneously on WebUI.
  • [Manager]: Add module shrink in Settings.
  • [Manager]: Fix "grant root failed" in some cases.
  • [Manager]: Allow to use other su to install LKM mode.
发布文件
keyboard_arrow_down
v0.9.2
正式版
  • [manager]: Support offline patching of the kernel.
  • [kernel]: Fix issue with ColorOS.
  • [kernel]: Hide traces of LKM in user space.
  • [manager]: Fix possible errors during OTA upgrades.
发布文件
keyboard_arrow_down
v0.9.0
正式版

KernelSU now supports installation through kernel modules (LKM) (GKI Only), you can use it with official kernels or third-party kernels; at the same time, the manager has also added installation functionality, you can choose to patch files, install directly, or install after OTA. Regarding the new LKM installation method, there are some tips:

  1. LKM does not support non-GKI kernels, and will not support them in the future;
  2. When patching files, if the init_boot partition exists, you should choose to patch init_boot; otherwise, patch boot;
  3. If you have already installed the GKI kernel provided by KernelSU and want to switch to the LKM method, you need to flash back to the stock kernel; if your device has an init_boot partition, you can directly flash back to the stock boot;
  4. The installation method of GKI kernel and LKM will always exist, use whichever you like; in the future, it will also support flashing GKI kernel in the manager.

Have fun!

发布文件
keyboard_arrow_down
v0.8.1
正式版

0.8.1

  • Fix various issues caused by sparse files. Installing one module (no more) and rebooting immediately will fix the slowness issue

0.8.0

For a long time, the module functionality of Magisk / KernelSU was limited to executing boot scripts and modifying system files. Now, we are exploring the possibility of endowing modules with the capability to display UI interfaces!

Previously, after installing some modules, users needed to configure them either through the command line or by directly modifying configuration files in specific locations. Clearly, this process was quite inconvenient for users. At times, in order to configure settings, it was even necessary to write a separate app. With the ability for modules to display interfaces, these issues could become a thing of the past.

Moreover, the display interface can be used for more than just configurations. You have the freedom to present anything you'd like to showcase and interact with the user.

The current interface is implemented through WebUI. You can create HTML pages using any web technology and place them in the module's webroot directory. After the module is installed, users can access this page through the KernelSU manager's list of modules. KernelSU also provides a JavaScript library to facilitate interaction with the system.

However, these trials are still in their infancy, and the jsapi is not yet stable. We welcome your feedback!

Changelog:

  • [Module] Add support for displaying WebUI in modules.
  • [Module] Use sparse image to store module files to solve the problem of installation failure of certain large modules and dynamically sized modules.
  • [Module] Use new mount API when it is available for mounting module files.
  • [Module] Allow to set upperdir for OverlayFS to make the partition writable (CLI Only).
  • [Kernel] Fix some detections.
  • [Kernel] Fix a bug that causes some root processes cannot be killed.
  • [Manager] Add an option to disable automatic update check.
  • [Manager] Fix the misleading tips when manager grant root failed.
发布文件
keyboard_arrow_down
v0.8.0
正式版

For a long time, the module functionality of Magisk / KernelSU was limited to executing boot scripts and modifying system files. Now, we are exploring the possibility of endowing modules with the capability to display UI interfaces!

Previously, after installing some modules, users needed to configure them either through the command line or by directly modifying configuration files in specific locations. Clearly, this process was quite inconvenient for users. At times, in order to configure settings, it was even necessary to write a separate app. With the ability for modules to display interfaces, these issues could become a thing of the past.

Moreover, the display interface can be used for more than just configurations. You have the freedom to present anything you'd like to showcase and interact with the user.

The current interface is implemented through WebUI. You can create HTML pages using any web technology and place them in the module's webroot directory. After the module is installed, users can access this page through the KernelSU manager's list of modules. KernelSU also provides a JavaScript library to facilitate interaction with the system.

However, these trials are still in their infancy, and the jsapi is not yet stable. We welcome your feedback!

Changelog:

  • [Module] Add support for displaying WebUI in modules.
  • [Module] Use sparse image to store module files to solve the problem of installation failure of certain large modules and dynamically sized modules.
  • [Module] Use new mount API when it is available for mounting module files.
  • [Module] Allow to set upperdir for OverlayFS to make the partition writable (CLI Only).
  • [Kernel] Fix some detections.
  • [Kernel] Fix a bug that causes some root processes cannot be killed.
  • [Manager] Add an option to disable automatic update check.
  • [Manager] Fix the misleading tips when manager grant root failed.
发布文件
keyboard_arrow_down
v0.7.6
正式版

Fix memory leak

发布文件
keyboard_arrow_down
v0.7.5
正式版
  • To Make ZygiskNext Happy
  • [Script] Update allowlist.bt for devs
  • [SU] Support set gid and groups when su
  • [Module] Extract binaries properly and necessarily
  • [Kernel] Fix exec su in post-fs-data
  • [Module] Fix ksud temp path
  • [Manager] Update translation
发布文件
keyboard_arrow_down
v0.7.2
正式版
  • [SU] Fixed the issue of incorrect allowlist after an app with root permissions is uninstalled.
  • [SU] Fixed an issue that caused bootloop when uninstalling an application in multi-user after being granted root permissions.
  • [kernel] Support Linux kernel version 6.4.
  • [Module] Fixed the problem of non-standard module.prop causing module directory confusion.
  • [Module] Update busybox to 1.36.1.
  • [Module] Support using /debug_ramdisk as temporary directory.
  • [Security] Strengthen signature verification to avoid root privileges being taken over when using unofficial managers (CVE-2023-49794).
发布文件
keyboard_arrow_down
v0.7.1
正式版
  • [Kernel] Fix su not working on android14-6.1 kernel.
  • [Kernel] Fix wifi not working on android14-6.1 kernel.
  • [Module] Add missing groups for App Profile.
  • [Module] Fix changelog fetch failed.
  • [Module] Fix module page blank when module id is absent.
  • [Manager] Add translations.
发布文件
keyboard_arrow_down
v0.7.0
正式版

We’re excited to report that we’ve delivered on the App Profile feature we promised 5 months ago! In this release, we have added an important feature to App Profile: Templates. You can create templates by yourself, import templates created by others, or directly use online templates. Templates can be directly applied to App Profile, without having to manually set each configuration! Therefore, even if you don’t understand the complex concepts in App Profile, you can easily restrict ROOT permissions through templates. In addition, welcome to contribute rules to online templates!

Changelog:

  1. [Security] Fix a security issue similar to CVE-2023-5521, please upgrade as soon as possible; credits to qwerty472123@github!
  2. [SU] App Profile now supports templates!
  3. [Module] Fixed the bug that the module directory may be accidentally umounted, causing the manager module directory to be empty.
  4. [SU] Fixed the issue where the allowlist may be messed up after an app is uninstalled.
  5. [Kernel] Add android14-5.15 and android14-6.1, supporting Pixel8 series.
  6. [SU] App Profile’s capability no longer requires CAP_DAC_READ_SEARCH and can run without any capability.
  7. [Kernel] Fixed the bootloop issues when working with Magisk.
发布文件
keyboard_arrow_down
v0.6.9
正式版
  • [Kernel] Fixed security vulnerability.
  • [Module] The GKI kernel supports automatic umount of modules to solve the problem of certain applications detecting module mount points.
  • [Manager] Fixed the issue where the update log was too long causing the update dialog box to be abnormal.
  • [Module] Adapt to the init process below Android 9.
发布文件
keyboard_arrow_down
v0.6.8
正式版
  • [Module] Fixed an issue that caused all modules to disappear after the installation of some modules failed.
  • [Manager] Fixed the problem of incorrect module file name when updating modules.
  • [Manager] It is now possible to display the changelog before module updates.
  • [Manager] The changelog can also be displayed when the manager is updated.
  • [Kernel] Fixed the issue where applications granted su permissions would execute certain commands abnormally.
  • [Kernel] Add some newly GKI kernel branches.
发布文件
keyboard_arrow_down
v0.6.7
正式版
  • [Kernel]: Fix kernel version strings.
  • [Kernel]: Fix build for 4.9 kernels.
  • [Module]: Add post-mount stage for module and common scripts.
  • [Module]: Fix module failed to install in some cases.
  • [Manager]: Fix the bug that some modules cause the module list to be empty.
发布文件
keyboard_arrow_down
v0.6.6
正式版

Changelog:

  • [Manager] Lots of translation updates in many languages, thanks to all developers who contributed on Weblate.
  • [Manager] Fixed a bug where module list doesn't show in manager under some cases.
  • [Module] Boot scripts now support a new boot stage boot-completed, which will run after system finished booting, available for both common and module scripts.
  • [Kernel] Kernel tasks are now queued and run in a global single thread, to avoid timing issues causing su allowlist mixup.
  • [Module] Fixed a bug where flashing large modules could fail.
  • [Manager] Optimized log output when installing modules in manager, UI only shows concise logs while saving detailed logs to file.
  • [Module] Uninstalling modules is now delayed until next reboot, avoiding potential incomplete uninstall.
  • [Manager] Added loading spinner for module operations in manager.
  • [Module] Fixed a bug where common post-fs-data scripts don't run if no modules installed.
  • [Manager] Fixed some untcentered prompt texts in manager.
  • [SU] Fixed incorrect parameter parsing in su.
  • [Manager] Module install log now auto-scrolls to bottom in manager.
  • [Manager] Module install screen now automatically mutes system volume keys for module volume key selection.
  • [Manager] Refreshes module list after install to avoid user confusion.
  • [Kernel] Fixed keyring not installed correctly on 4.9 kernels causing modules not working.
  • [Module] SELinux context of module dirs are fixed automatically on boot, avoiding some boot failures.

更新日志:

  • [Manager] 大量语言的翻译更新，感谢所有在 Weblate 上贡献的开发者。
  • [Manager] 修复某些情况下，管理器中模块列表全部不显示的 BUG。
  • [Module] 启动脚本支持一个新的启动阶段 boot-completed，将会在系统启动完毕后执行，支持 common 和模块脚本。
  • [Kernel] 内核任务使用全局单线程排队执行，避免时序问题导致 su 允许列表错乱。
  • [Module] 修复刷入大体积模块可能会失败的 BUG。
  • [Manager] 优化管理器中模块刷入时的日志输出，用户界面仅显示简洁日志，保存时文件写入详细日志。
  • [Module] 卸载模块改为下次重启时执行，避免卸载可能不干净的问题。
  • [Manager] 管理器中模块操作添加加载等待框。
  • [Module] 修复没有安装模块时，common post-fs-data 脚本不执行的 BUG。
  • [Manager] 修复管理器中若干提示文字没有居中的问题。
  • [SU] 修复 su 参数解析不对的问题。
  • [Manager] 管理器中安装模块时，输出日志自动滚动到底部。
  • [Manager] 管理器中安装模块界面，自动屏蔽系统音量键，方便模块进行音量键选择。
  • [Manager] 模块安装完毕后，刷新模块界面，避免用户误以为没有安装。
  • [Kernel] 修复 4.9 上内核 keyring 没有正确安装导致模块无法使用的问题。
  • [Module] 系统启动时，自动修复模块目录的 SELinux Context，避免部分启动失败问题。
发布文件
keyboard_arrow_down
v0.6.2
正式版

Changelog：

  1. Translation updated, add Spanish.
  2. Allow kernel to mount loop device, enhanced compatibility with modules.
  3. App profile now supports setting sepolicy rules.
  4. support the case that init_task.mnt_ns != zygote.mnt_ns, fix WSA profile saving.
  5. Fixed the problem of repeated installation when pressing the return button when installing modules.
  6. Other improvements and fixes.

更新日志： 1. 更新翻译，新增西班牙语翻译 2. 允许内核挂载回环设备，增强模块系统兼容性。 3. 现在App profile支持设置sepolicy rules。 4. 支持init和zygote mnt namespace不同的情况，修复WSA无法保存配置的问题。 5. 修复安装模块时按返回键循环重复安装的问题。 6. 其他更多细节优化和修正。

发布文件
keyboard_arrow_down
v0.6.1
正式版
  1. Support online updates for modules and manager.
  2. Fix the potential issue of umount failing.
  3. Harden the signature verification of the manager.
发布文件
keyboard_arrow_down
v0.6.0
正式版

Initial support for App Profile!

By setting appropriate UID, GID, groups, and capabilities (as well as the upcoming SELinux) for the apps that require root privileges, you can exercise more fine-grained control over these permissions. For instance, you can grant file manager-related permissions for read-write access and deny dangerous permissions like ptrace. You can also downgrade root privileges for apps like Ice Box to shell or system privileges. Open KernelSU's manager and begin setting up your App Profiles!

发布文件
keyboard_arrow_down
v0.5.7
正式版
  1. Support for several languages.
  2. Fixed a bug where the kernel umount may fail.
  3. Fixed a bug where REPLACE in modules may not take effect.
  4. Fixed a problem where x86_64 devices may not work.
  5. Fixed some issues with module mounting.
发布文件
keyboard_arrow_down
v0.5.6
正式版
发布文件
keyboard_arrow_down
v0.5.5
正式版
发布文件
keyboard_arrow_down
v0.5.4
正式版
发布文件
keyboard_arrow_down
v0.5.3
正式版

Changelog:

  1. Refactored module mounting to fix several mounting issues. Thanks to @5ec1cff .
  2. Added support for granting root permissions to apps in work profile.
  3. Added a confirmation dialog when granting root access.
  4. Improved bugreport.
发布文件
keyboard_arrow_down
v0.5.2
正式版

Changelog:

  1. Fix the issue that the module system may conflict with the stock mounts of the system, causing the bootloop.
  2. Fix the reboot issue that may be caused by using the manager on Meizu devices.
  3. Fix the failure of the built-in sepolicy patch on some devices.
发布文件
keyboard_arrow_down