website/docs/zh_CN/guide/installation.md
从 GitHub Releases 下载 KernelSU 管理器应用，然后将应用程序安装到设备并打开：
:::info 对于显示“不支持”的设备，这里有一个非官方支持设备列表，你可以用这个列表里面的内核自行编译。 :::
在进行刷机操作之前，你必须先备份好自己的原厂 boot.img。如果你后续刷机出现了任何问题，你都可以通过使用 fastboot 刷回原厂 boot 来恢复系统。
::: warning 任何刷机操作都是有风险的，请务必做好这一步再进行下一步操作！！必要时你还可以备份你手机的所有数据。 :::
此教程默认你会使用 ADB 和 fastboot 工具，如果你没有了解过，建议使用搜索引擎先学习相关知识。
KMI 全称 Kernel Module Interface，相同 KMI 的内核版本是兼容的 这也是 GKI 中“通用”的含义所在；反之，如果 KMI 不同，那么这些内核之间无法互相兼容，刷入与你设备 KMI 不同的内核镜像可能会导致死机。
具体来说，对 GKI 的设备，其内核版本格式应该如下：
KernelRelease :=
Version.PatchLevel.SubLevel-AndroidRelease-KmiGeneration-suffix
w .x .y -zzz -k -something
其中，w.x-zzz-k 为 KMI 版本。例如，一个设备内核版本为5.10.101-android12-9-g30979850fc20，那么它的 KMI 为 5.10-android12-9；理论上刷入其他这个 KMI 的内核也能正常开机。
::: tip
请注意，内核版本中的 SubLevel 不属于 KMI 的范畴！也就是说 5.10.101-android12-9-g30979850fc20 与 5.10.137-android12-9-g30979850fc20 的 KMI 相同！
:::
新的 Android 设备上可能采取了防回滚机制，它不允许刷入一个安全补丁更旧的内核。比如，如果你的设备内核是 5.10.101-android12-9-g30979850fc20，它的安全补丁为 2023-11；即使你刷入与内核 KMI 一致的内核，如果安全补丁级别比 2023-11 要老（例如2023-06），那么很可能会无法开机。
因此，在保持 KMI 一致的情况下，优先采用安全补丁级别更新的内核。
请注意：内核版本与 Android 版本并不一定相同！
如果您发现您的内核版本是 android12-5.10.101，然而你 Android 系统的版本为 Android 13 或者其他；请不要觉得奇怪，因为 Android 系统的版本与 Linux 内核的版本号不一定是一致的；Linux 内核的版本号一般与设备出厂的时候自带的 Android 系统的版本一致，如果后续 Android 系统升级，内核版本一般不会发生变化。如果你需要刷机，请以内核版本为准！！
自 0.9.0 版本以后，在 GKI 设备中，KernelSU 支持两种运行模式：
GKI：使用通用内核镜像（GKI）替换掉设备原有的内核。LKM：使用可加载内核模块（LKM）的方式加载到设备内核中，不会替换掉设备原有的内核。这两种方式适用于不同的场景，你可以根据自己的需求选择。
GKI 模式会替换掉设备原有的内核，使用 KernelSU 提供的通用内核镜像。GKI 模式的优点是：
LKM 模式不会替换掉设备原有的内核，而是使用可加载内核模块的方式加载到设备内核中。LKM 模式的优点是：
:::tip 两种模式共存 打开管理器后，你可以在首页看到设备当前运行的模式；注意 GKI 模式的优先级高于 LKM，如你既使用 GKI 内核替换掉了原有的内核，又使用 LKM 的方式修补了 GKI 内核，那么 LKM 会被忽略，设备将永远以 GKI 的模式运行。 :::
如果你的设备是手机，我们建议您优先考虑 LKM 模式；如果你的设备是模拟器、WSA 或者 Waydroid 等，我们建议您优先考虑 GKI 模式。
使用 LKM 的模式，需要获取官方固件，然后在官方固件的基础上修补；如果你使用的是第三方内核，可以把第三方内核的 boot.img 作为官方固件。
获取官方固件的方法有很多，如果你的设备支持 fastboot boot，那么我们最推荐以及最简单的方法是使用 fastboot boot 临时启动 KernelSU 提供的 GKI 内核，然后安装管理器，最后在管理器中直接安装；这种方法不需要你手动下载官方固件，也不需要你手动提取 boot。
如果你的设备不支持 fastboot boot，那么你可能需要手动去下载官方固件包，然后从中提取 boot。
与 GKI 模式不同，LKM 模式会修改 ramdisk，因此在出厂 Android 13 的设备上，它需要修补的是 init_boot 分区而非 boot 分区；而 GKI 模式则永远是操作 boot 分区。
打开管理器，点击右上角的安装图标，会出现若干个选项：
fastboot boot KernelSU 的 GKI 内核来获取临时 root 安装管理器，然后再使用这个选项；这种方式也是 KernelSU 升级最主要的方式；如果你不想使用管理器，你也可以使用命令行来安装 LKM；KernelSU 提供的 ksud 工具可以帮助你快速修补官方固件，然后刷入。
这个工具支持 macOS、Linux 和 Windows，你可以在 GitHub Release 下载对应的版本。
使用方法：ksud boot-patch 具体的使用方法你可以查看命令行帮助。
oriole:/ # ksud boot-patch -h
Patch boot or init_boot images to apply KernelSU
Usage: ksud boot-patch [OPTIONS]
Options:
-b, --boot <BOOT> boot image path, if not specified, will try to find the boot image automatically
-k, --kernel <KERNEL> kernel image path to replace
-m, --module <MODULE> LKM module path to replace, if not specified, will use the builtin one
-i, --init <INIT> init to be replaced
-u, --ota will use another slot when boot image is not specified
-f, --flash Flash it to boot partition after patch
-o, --out <OUT> output path, if not specified, will use current directory
--magiskboot <MAGISKBOOT> magiskboot path, if not specified, will use builtin one
--kmi <KMI> KMI version, if specified, will use the specified KMI
-h, --help Print help
需要说明的几个选项：
--magiskboot 选项可以指定 magiskboot 的路径，如果不指定，ksud 会在环境变量中查找；如果你不知道如何获取 magiskboot，可以查阅这里；--kmi 选项可以指定 KMI 版本，如果你的设备内核名字没有遵循 KMI 规范，你可以通过这个选项来指定；最常见的使用方法为：
ksud boot-patch -b <boot.img> --kmi android13-5.10
GKI 的安装方法有如下几种，各自适用于不同的场景，请按需选择：
如果你设备的 boot.img 采用常用的压缩格式，那么可以采用 KernelSU 提供的的通用内核镜像直接刷入，它不需要 TWRP 或者自行修补镜像。
KernelSU 为 GKI 设备提供了通用的 boot.img，您应该将 boot.img 刷写到设备的 boot 分区。
您可以从 GitHub Release 下载 boot.img, 请注意您应该使用正确版本的 boot.img。如果您不知道应该下载哪一个文件，请仔细阅读本文档中关于 KMI 和安全补丁级别的描述。
通常情况下，同一个 KMI 和 安全补丁级别下会有三个不同格式的 boot 文件，它们除了内核压缩格式不同之外都一样。请检查您原有 boot.img 的内核压缩格式，您应该使用正确的格式，例如 lz4、gz；如果是用不正确的压缩格式，刷入 boot 后可能无法开机。
::: info
gz 或者 不压缩。使用 adb 连接您的设备，然后执行 adb reboot bootloader 进入 fastboot 模式，然后使用此命令刷入 KernelSU：
fastboot flash boot boot.img
::: info
如果你的设备支持 fastboot boot，可以先使用 fastboot boot boot.img 来先尝试使用 boot.img 引导系统，如果出现意外，再重启一次即可开机。
:::
刷入完成后，您应该重新启动您的设备：
fastboot reboot
步骤：
这种方法需要内核刷写 App 拥有 root 权限，你可以用如下几种方法实现：
fastboot boot boot.img 这种临时启动的方法，你可以用 KernelSU 提供的 GKI 镜像临时启动你的设备，获取临时的 root 权限，然后使用内核刷写器刷入获取永久 root 权限。如果您以前没有使用过内核刷写 App，建议使用以下应用：
对于某些设备来说，其 boot.img 格式不那么常见，比如不是 lz4, gz 和未压缩；最典型的就是 Pixel，它 boot.img 的格式是 lz4_legacy 压缩，ramdisk 可能是 gz 也可能是 lz4_legacy 压缩；此时如果你直接刷入 KernelSU 提供的 boot.img，手机可能无法开机；这时候，你可以通过手动修补 boot.img 来实现。
任何情况下都推荐使用 magiskboot 来修补 boot 镜像，有两个方法：
Magisk 官方提供的 magiskboot 只能运行在 Android/Linux 设备上，如果你想在 macOS/Windows 上使用 magiskboot 可以使用第二个方法。
::: tip 不再推荐使用 Android-Image-Kitchen，因为它可能没有合理地处理 boot 元数据（比如安全补丁级别），从而导致某些设备上会无法启动。 :::
Image 文件，此文件为 KernelSU 的内核文件。Magisk-*(version).apk 重命名为 Magisk-*.zip 然后解压缩。Magisk-*/lib/arm64-v8a/libmagiskboot.so 文件，使用 adb push 到手机：adb push Magisk-*/lib/arm64-v8a/libmagiskboot.so /data/local/tmp/magiskbootchmod +x magiskboot./magiskboot unpack boot.img 此时会解包 boot.img 得到一个叫做 kernel 的文件，这个文件为你原厂的 kernelImage 替换 kernel: mv -f Image kernel./magiskboot repack boot.img 打包 img，此时你会得到一个 new-boot.img 的文件，使用这个文件 fastboot 刷入设备即可。magiskboot 二进制文件。chmod +x magiskboot./magiskboot unpack boot.img 来解包 boot.img, 你会得到一个 kernel 文件，这个文件是你设备原厂的 kernel。Image 替换 kernel: mv -f Image kernel./magiskboot repack boot.img 打包 img，此时你会得到一个 new-boot.img 的文件，使用这个文件 fastboot 刷入设备即可。:::info
Magisk 官方的 magiskboot 可以在 Linux 设备上执行，如果你是 Linux 用户，可以直接用官方版本。
:::
前提：你的设备必须有自定义的 Recovery，如 TWRP；如果没有或者只有官方 Recovery，请使用其他方法。
步骤：
adb sideload AnyKernel-*.zip 安装。PS. 这种方法适用于任何情况下的安装（不限于初次安装或者后续升级），只要你用 TWRP 就可以操作。
其实所有这些安装方法的主旨只有一个，那就是替换原厂的内核为 KernelSU 提供的内核；只要能实现这个目的，就可以安装；比如以下是其他可行的方法：
如果这些方法导致无法开机，请优先尝试用 magiskboot 的方法。
::: warning 修改系统文件需要 METAMODULE
如果您想使用修改 /system 文件的模块，需要在安装 KernelSU 后安装一个 metamodule。仅使用脚本、sepolicy 或 system.prop 的模块无需 metamodule。
:::
要获得 /system 修改支持，请参阅 Metamodule 指南 了解：
meta-overlayfs metamodule