Skip to content

Repository files navigation

GKI KernelSU SUSFS

Automated GKI Kernel Builds | SukiSU / ReSukiSU + SUSFS Integration

Release Coolapk SukiSU ReSukiSU SUSFS

English | 简体中文

📖 Introduction

Built upon AnyKernel3, this repository uses GitHub Actions to automatically compile Android GKI kernels. It integrates multiple KernelSU variants and SUSFS kernel-level spoofing solutions Add practical patches such as ZRAM and BBG.

📦 Supported Kernel Versions

Android Kernel Version Manual Workflow
12 5.10 kernel-a12-5-10.yml
13 5.15 kernel-a13-5-15.yml
14 6.1 kernel-a14-6-1.yml
15 6.6 kernel-a15-6-6.yml
16 6.12 kernel-a16-6-12.yml
Custom Any kernel-custom.yml

✨ Features

Feature Description
🔐 KernelSU Variants Supports SukiSU / ReSukiSU variants, selectable at build time
🙈 SUSFS Kernel-level hiding working with KSU to complete environment spoofing
💾 ZRAM LZ4 ZRAM Compression Algorithm Patch
🛡️ BBG (Baseband Guard) BBG patch to protect the baseband partitions from accidental wipe
🌐 Network enhancement Optional IPSet + BBR kernel config (BBR default congestion control, fq/fq_codel qdisc, full IPSet types up to 65534 sets, IPv6 NAT/masquerade, extra congestion algorithms)
⚡ KPM Optional KPM feature / build-time patching
🔔 Re-Kernel Optional Re-Kernel driver integration
🩹 CVE-2026-43499 Optional automatic application of the rtmutex fix
📱 OnePlus Snapdragon 8 Elite / Gen5 Support Optional: Add support for OnePlus Snapdragon 8 Elite / Gen5 processor
🐳 Droidspaces Optional container support with NTSync kernel compatibility patch
🧩 Skip Incompatible Optional: auto-skip incompatible or unusable features (except SUSFS and OnePlus 8 Elite/Gen5 support) instead of failing the build

🚀 Usage

  1. Fork this repository (or use it directly)
  2. Go to the Actions page and pick the workflow for your kernel version
  3. Click Run workflow and fill in the parameters as needed:
    • android_version / kernel_version / sub_level / os_patch_level
    • ksu_variant: KernelSU variant (SukiSU / ReSukiSU)
    • Feature switches: enable_susfs, use_zram, use_bbg, use_net_enhance, use_kpm, skip_incompatible, etc.
  4. Once the build finishes, download the Artifacts from the run page:
    • AnyKernel3.zip — flashable zip (recommended; flash via custom Recovery or KSU)
    • boot.img / boot-gz.img / boot-lz4.img — boot images for each compression format

💡 Artifacts are uploaded as Actions Artifacts by default and are not auto-published as Releases. Failed runs additionally upload build logs (Build-Logs) and patch conflict records (Rejects) for troubleshooting.

🔧 Custom Commit Configuration

The config/config file lets you pin specific commits for SUSFS and SukiSU.

What is a commit?

A commit is a hash string representing the state of a repository at a certain point in time. For example, setting SukiSU to 4b8644515fe6d87a109129e590ccd9d33a855dca means the kernel will be built with the SukiSU version from January 30.

Why pin a commit?

  • Roll back to a stable version when upstream updates introduce bugs or compatibility issues
  • Manually specify a compatible version when SUSFS and SukiSU are out of sync and the build fails

How to get a commit hash?

🛠️ Recommended After Installation

🔧 Xposed Modules

Module Description
FuseFixer Unicode zero-width character fix module

🙏 Acknowledgments

⚠️ Disclaimer

  • Flashing this kernel will not void your warranty, but there is always a risk of bricking your device. Please make sure to:

  • 💾 Back up your data

  • 🧠 Understand the risks before proceeding

  • Please make sure to back up the original boot image of this system in advance.

  • If flashing AnyKernel3 causes your device to enter an infinite boot loop or fail to boot, enter BootLoader and flash the original boot image back.

  • I take no responsibility for any issues caused by flashing this kernel.

🚨 Proceed at your own risk!


GKI KernelSU SUSFS

自动化构建 GKI 内核 | 集成 SukiSU/ReSukiSU + SUSFS

English | 简体中文

📖 简介

本仓库基于 AnyKernel3 构建,通过 GitHub Actions 自动编译 Android GKI 内核,集成多种 KernelSU 变体与 SUSFS 内核级隐藏方案并附加 ZRAM、BBG等实用补丁。

📦 支持的内核版本

Android 内核版本 手动触发工作流
12 5.10 kernel-a12-5-10.yml
13 5.15 kernel-a13-5-15.yml
14 6.1 kernel-a14-6-1.yml
15 6.6 kernel-a15-6-6.yml
16 6.12 kernel-a16-6-12.yml
自定义 任意 kernel-custom.yml

✨ 功能特性

特性 说明
🔐 KernelSU 变体 支持 SukiSU / ReSukiSU 变体,构建时按需选择
🙈 SUSFS 内核级隐藏,配合 KSU 完成环境伪装
💾 ZRAM LZ4 ZRAM 压缩算法补丁
🛡️ BBG 基带保护 BBG(BaseBand Guard)补丁,保护基带分区,防止基带被意外擦除
🌐 网络增强 可选 IPSet + BBR 内核配置(BBR 默认拥塞控制 + fq/fq_codel 队列 + IPSet 全类型,集合上限 65534 + IPv6 NAT/伪装 + 附加拥塞算法)
⚡ KPM 可选开启 KPM 功能 / 构建期修补
🔔 Re-Kernel 可选集成 Re-Kernel 驱动
🩹 CVE-2026-43499 可选自动应用 rtmutex 修复补丁
📱 一加 骁龙8 Elite/Gen5 支持 可选添加一加 骁龙8 Elite/Gen5 处理器支持
🐳 Droidspaces 可选容器支持及 NTSync 内核兼容补丁
🧩 兼容跳过 可选:功能不兼容或无法使用时自动跳过该功能(SUSFS 与 一加 骁龙8 Elite/Gen5 支持除外,二者失败仍会中断构建),不中断构建

🚀 使用方法

  1. Fork 本仓库(或直接使用本仓库)
  2. 进入 Actions 页面,选择对应内核版本的工作流
  3. 点击 Run workflow,按需填写参数:
    • android_version / kernel_version / sub_level / os_patch_level
    • ksu_variant:KernelSU 变体(SukiSU / ReSukiSU)
    • 功能开关:enable_susfs、use_zram、use_bbg、use_net_enhance、use_kpm、skip_incompatible 等
  4. 构建完成后,在本次运行页面下载 Artifacts:
    • AnyKernel3.zip —— 卡刷包(推荐,配合自定义 Recovery 或 KSU 刷入)
    • boot.img / boot-gz.img / boot-lz4.img —— 每种压缩格式的 boot 镜像

💡 产物默认上传为 Actions Artifacts,不自动发布 Release;失败时会额外上传构建日志(Build-Logs)与补丁冲突记录(Rejects)供排查。

🔧 自定义提交配置

通过 config/config 文件可以指定 SUSFS 和 SukiSU 使用特定的 commit。

什么是提交 (commit)?

提交是一串哈希字符串,代表仓库在某个时间点的状态。例如将 SukiSU 设为 4b8644515fe6d87a109129e590ccd9d33a855dca,即使用 1 月 30 日的 SukiSU 版本编译内核。

为什么要指定提交?

  • 当上游仓库更新引入 bug 或兼容性问题时,可回退到稳定版本
  • 当 SUSFS 与 SukiSU 版本不同步导致编译失败时,可手动指定兼容的版本

如何获取提交哈希?

  • SUSFS:susfs4ksu(GitLab → Repository → Commits)
  • SukiSU:SukiSU-Ultra(GitHub 提交历史页面)

🛠️ 安装后推荐

🔧 Xposed 模块

模块 说明
FuseFixer Unicode零宽修复模块

🙏 致谢

⚠️ 免责声明

  • 刷入内核不会使保修失效,但总有设备变砖的风险请务必:

  • 💾 备份你的数据

  • 🧠 在继续之前,了解风险

  • 请务必提前备份该系统的原Boot镜像。

  • 如果刷入 AnyKernel3 导致设备进入无限启动循环或无法启动,请进入 BootLoader 并重新刷入原Boot镜像。

  • 我不对刷写该内核所引发的任何问题负责。

🚨 请自行承担风险!

About

Xiaomi Kernel with SukiSU/ReSukiSU + SUSFS

Resources

Stars

35 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages