SukiSU-Ultra/docs/zh/guide/installation.md

安装参考

::: details 将会了解 SukiSU-Ultra 安装过程 toc :::

::: danger 警告 Root 您的设备可能会使保修失效，如果操作不当可能会造成永久性损坏。 请务必在继续之前创建完整备份，阅读文档确保与您的设备兼容，遵循文档参考，准备好恢复计划 :::

通用 GKI

请全部参考 KernelSU 安装指南

1. 适用于 GKI 2.0 设备，如小米、红米、三星等（不包括内核修改的制造商，如魅族、一加、真我和 OPPO）
2. 在更多链接中查找 GKI 构建。找到设备内核版本，然后下载并使用 TWRP 或内核刷写工具刷入带有 AnyKernel3 后缀的 zip 文件。
3. 无后缀的 .zip 档案是未压缩的，gz 后缀是特定型号使用的压缩格式。

一加设备

使用更多链接部分提到的链接，用您的设备信息创建自定义构建，然后刷入带有 AnyKernel3 后缀的 zip 文件。

::: details 展开

• 只需要填写内核版本的前两部分，如 5.10、5.15、6.1 或 6.6。
• 请自行搜索处理器代号，通常是不含数字的英文字母。
• 可以从一加开源内核仓库中找到分支和配置文件。
• 第三方 Recovery（推荐 TWRP）

:::

开始安装

通用 GKI 安装

::: tip 适用于 GKI 2.0 设备，如小米、红米、三星等（不包括内核修改的制造商，如魅族、一加、真我和 OPPO） :::

步骤：

1. 下载 GKI 构建文件

   从我们的资源部分查找 GKI 构建。查找您设备的内核版本并下载带有 AnyKernel3 后缀的 zip 文件。

2. 通过 Recovery 刷入

   启动到 TWRP recovery，选择 Install，导航到下载的 AnyKernel3 zip 文件，滑动刷入后重启系统

3. 验证安装

::: details 文件格式说明 无后缀的 .zip 档案是未压缩的，gz 后缀是特定型号使用的压缩格式。 :::

一加设备安装

1. 获取设备信息

• 内核版本（前两部分，例如 5.10、5.15、6.1、6.6）
• 处理器代号（通常是不含数字的英文）
• 来自一加开源内核仓库的分支和配置文件

2. 创建自定义构建

   使用我们资源部分中提到的链接，用您的设备信息创建自定义构建。

3. 刷入构建

   下载生成的带有 AnyKernel3 后缀的 zip 文件，启动到 TWRP recovery，选择 Install，导航到下载的 AnyKernel3 zip 文件，滑动刷入后重启系统

::: tip 您只需要填写内核版本的前两部分。自行搜索处理器代号 :::

手动内核集成

面向希望将 SukiSU Ultra 集成到自己内核构建中的高级用户

主分支（GKI）

curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s main

非 GKI 分支

curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s nongki

SUSFS-Dev 分支（推荐）

curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s susfs-dev

curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s susfs-main

::: warning 必需的内核配置 为了支持 KPM，添加 CONFIG_KPM=y

对于非 GKI 设备，还要添加 CONFIG_KALLSYMS=y 和 CONFIG_KALLSYMS_ALL=y :::

安装后设置

系统更新时保持 Root

Important

如何在 OTA 更新后保持 root 访问权限：

步骤：

1. 系统更新后重启前

   • OTA 安装后不要立即重启，将 SukiSU Ultra 安装到第二插槽
   • 打开 SukiSU Ultra 管理器，在刷入/修补内核界面选择 GKI/non_GKI install，选择您的 AnyKernel3 内核 zip 文件，选择与当前运行插槽相对的插槽然后刷入重启。

2. 替代方案：LKM 模式

   使用 LKM 模式 在 OTA 后安装到未使用的插槽。

::: warning 警告 非 GKI 设备注意事项： 此方法不支持所有非 GKI 设备。对于非 GKI 设备，使用 TWRP 是最安全的方法。 :::

验证

安装后，验证一切是否正常工作，

• 打开 SukiSU Ultra 管理器检查 root 工作状态
• 使用 root 权限的应用程序来验证 root 访问是否工作正常
• 在设置 -> 关于手机中检查内核版本

需要帮助？

如果在安装过程中遇到问题：

1. 查看我们的兼容性指南了解设备要求
2. 访问我们的 GitHub 仓库获取支持
3. 加入我们的 Telegram 社区获取帮助

::: danger 安全提醒 始终有备用计划！ 保留您的原始 boot.img/init_boot.img 并知道如何在出现问题时恢复设备。 :::