KernelSU 内核级 Root 指南最小安装路径与 App Profile 权限控制【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSUKernelSU 是运行在 Android 内核空间的 root 方案su 请求由内核直接放行模块挂载交给可插拔的元模块。本文给出从刷写到配置的最小路径并拆解权限管理与常见刷机问题的排查方法。项目速览KernelSU 把 root 的实现下沉到内核管理器应用负责审批与修补镜像内核侧钩子负责真正放行 su模块的挂载行为则交给独立的元模块完成。仓库中kernel目录是内核态 C 代码userspace是 Rust 工具链manager是 Android 管理器应用三者通过uapi头文件定义的二进制协议通信。组成职责仓库位置内核模块su 放行、白名单、功能开关kernel/工具链 ksud修补 boot、安装模块、记录日志userspace/ksud/src/管理器应用审批、模块管理、界面配置manager/app/适用人群与典型场景三个场景对应仓库里真实存在的机制动作都很具体去预装与免写系统分区的修改刷入 meta-overlayfs 元模块后模块以 overlayfs 叠加层隐藏系统预装应用目录实现不写/system的“卸载”改 hosts 做广告过滤也走模块脚本重启即可还原。给单个应用降权针对防火墙类应用配置 App Profile只保留网络相关组、去掉inet组其 su 就无法再访问本地文件对冻结类应用直接指派 uid 2000把它降到 ADB shell 权限级别而不是给完整 root。调试与行为审计开发者用内置的 adb_root 特性把 root 直接交给 ADB shell 做系统调试再开启 sulog 记录每一次 root 操作事后可逐条回查是哪个应用、在什么时间点做了什么。从0到1跑通KernelSU 最小安装路径准备条件一行带过已解锁 bootloader、内核 5.10 以上的 GKI 2.0 设备、电脑装好 ADB 与 fastboot、原厂 boot.img 已备份。整个路径四步验证支持安装 KernelSU 管理器 APK 并打开。显示“不支持”说明设备需要自编译内核显示“未安装”即可继续。修补 boot 镜像LKM 模式不替换原内核只修补官方 boot.img出厂 Android 13 及以上的设备改 patch init_boot。可以用管理器“选择并修补一个文件”也可以用命令行工具 ksudksud boot-patch刷入并重启用 fastboot 刷入修补后的镜像开机后在管理器中批准 su 请求。补装元模块新安装后必须安装 meta-overlayfs 等元模块依赖挂载的模块才会生效。如果你的内核低于 5.10 或不是 GKI 2.0则需要把 KernelSU 集成进内核源码自行编译git clone https://gitcode.com/GitHub_Trending/ke/KernelSU拿到仓库后将 kernel/setup.sh 拷到 GKI 内核源码根目录执行它会自动建立符号链接并写入 Makefile 与 Kconfigcd /path/to/gki sh setup.sh核心机制拆解权限、白名单与模块挂载内核空间放行 su白名单决定谁能用KernelSU 的 su 不依赖用户态伪装内核中的 setuid 钩子在特权切换前检查目标应用 UID 是否在授权列表里。入口在 kernel/hook/setuid_hook.c列表逻辑位于 kernel/policy/ 下的 allowlist 实现。收益审批在内核空间强制生效应用即使自改身份也绕不过去管理器里每个应用的授权状态可单独查询、单独撤销不需要重装或重启。App Profile 怎么配把 root 关进最小权限笼子每个应用可挂一份 root profile逐项指定 su 进程的 uid、gid、最多 32 个补充组、capabilities 位集与 SELinux 域名未授权应用则走 non-root profile控制是否对该应用卸载模块修改。协议定义在 uapi/app_profile.hRust 侧处理在 userspace/ksud/src/profile.rs管理器提供模板机制便于批量套用。收益量化给防火墙应用去掉inet组其 su 立即失去网络能力给冻结应用指派 uid 2000权限等级从 root 直接降到 shell两步操作即可无需改动应用本身。元模块挂载逻辑插件化内核核心本身不做任何挂载模块的安装与挂载委托给唯一运行的元模块单实例约束官方参考实现 meta-overlayfs 提供/system的 overlayfs 读写叠加实现见 userspace/ksud/src/metamodule.rs。收益核心不执行挂载检测面更小挂载策略无挂载、overlayfs、兼容挂载可以整体替换而不改内核不装元模块的用户省掉一整层挂载开销。常见坑与排查刷不进去与模块不生效每条按“现象→原因→处理”给出管理器显示“不支持”。原因设备内核不是 GKI 2.05.10 以上官方不提供可刷的 boot 镜像。处理自编译设备内核并集成 KernelSU文档见 website/docs/zh_CN/guide/how-to-integrate-for-non-gki.md。刷入后无法开机。原因所刷内核的 KMI 或安全补丁与原厂内核不一致新设备防回滚机制拒绝引导。处理以内核版本为准不是 Android 版本选 KMI 相同、安全补丁不旧于原厂的内核刷前备份 boot.img 以便 fastboot 回滚。模块装好却不生效。原因新安装未装元模块依赖挂载的模块缺少挂载执行者。处理安装 meta-overlayfs 或其他元模块后重启脚本、sepolicy、system.prop 类模块则无需元模块。应用检测到 root 环境。原因该应用的 profile 未配置模块修改在其可见的文件系统中留有痕迹。处理为它配置 non-root profile 并启用“卸载模块修改”内核会主动隐藏挂载痕迹。KernelSU 用内核钩子接管 su 审批把 root 从“给不给”细化到“给多少、给什么”。下一步按 website/docs/zh_CN/guide/installation.md 完成首次刷入再为最常用的一个 root 应用配置第一个 App Profile。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/9 14:42:39 · 阅读 1.2k KernelSU 内核级 Root 指南：最小安装路径与 App Profile 权限控制
KernelSU 内核级 Root 指南最小安装路径与 App Profile 权限控制【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSUKernelSU 是运行在 Android 内核空间的 root 方案su 请求由内核直接放行模块挂载交给可插拔的元模块。本文给出从刷写到配置的最小路径并拆解权限管理与常见刷机问题的排查方法。项目速览KernelSU 把 root 的实现下沉到内核管理器应用负责审批与修补镜像内核侧钩子负责真正放行 su模块的挂载行为则交给独立的元模块完成。仓库中kernel目录是内核态 C 代码userspace是 Rust 工具链manager是 Android 管理器应用三者通过uapi头文件定义的二进制协议通信。组成职责仓库位置内核模块su 放行、白名单、功能开关kernel/工具链 ksud修补 boot、安装模块、记录日志userspace/ksud/src/管理器应用审批、模块管理、界面配置manager/app/适用人群与典型场景三个场景对应仓库里真实存在的机制动作都很具体去预装与免写系统分区的修改刷入 meta-overlayfs 元模块后模块以 overlayfs 叠加层隐藏系统预装应用目录实现不写/system的“卸载”改 hosts 做广告过滤也走模块脚本重启即可还原。给单个应用降权针对防火墙类应用配置 App Profile只保留网络相关组、去掉inet组其 su 就无法再访问本地文件对冻结类应用直接指派 uid 2000把它降到 ADB shell 权限级别而不是给完整 root。调试与行为审计开发者用内置的 adb_root 特性把 root 直接交给 ADB shell 做系统调试再开启 sulog 记录每一次 root 操作事后可逐条回查是哪个应用、在什么时间点做了什么。从0到1跑通KernelSU 最小安装路径准备条件一行带过已解锁 bootloader、内核 5.10 以上的 GKI 2.0 设备、电脑装好 ADB 与 fastboot、原厂 boot.img 已备份。整个路径四步验证支持安装 KernelSU 管理器 APK 并打开。显示“不支持”说明设备需要自编译内核显示“未安装”即可继续。修补 boot 镜像LKM 模式不替换原内核只修补官方 boot.img出厂 Android 13 及以上的设备改 patch init_boot。可以用管理器“选择并修补一个文件”也可以用命令行工具 ksudksud boot-patch刷入并重启用 fastboot 刷入修补后的镜像开机后在管理器中批准 su 请求。补装元模块新安装后必须安装 meta-overlayfs 等元模块依赖挂载的模块才会生效。如果你的内核低于 5.10 或不是 GKI 2.0则需要把 KernelSU 集成进内核源码自行编译git clone https://gitcode.com/GitHub_Trending/ke/KernelSU拿到仓库后将 kernel/setup.sh 拷到 GKI 内核源码根目录执行它会自动建立符号链接并写入 Makefile 与 Kconfigcd /path/to/gki sh setup.sh核心机制拆解权限、白名单与模块挂载内核空间放行 su白名单决定谁能用KernelSU 的 su 不依赖用户态伪装内核中的 setuid 钩子在特权切换前检查目标应用 UID 是否在授权列表里。入口在 kernel/hook/setuid_hook.c列表逻辑位于 kernel/policy/ 下的 allowlist 实现。收益审批在内核空间强制生效应用即使自改身份也绕不过去管理器里每个应用的授权状态可单独查询、单独撤销不需要重装或重启。App Profile 怎么配把 root 关进最小权限笼子每个应用可挂一份 root profile逐项指定 su 进程的 uid、gid、最多 32 个补充组、capabilities 位集与 SELinux 域名未授权应用则走 non-root profile控制是否对该应用卸载模块修改。协议定义在 uapi/app_profile.hRust 侧处理在 userspace/ksud/src/profile.rs管理器提供模板机制便于批量套用。收益量化给防火墙应用去掉inet组其 su 立即失去网络能力给冻结应用指派 uid 2000权限等级从 root 直接降到 shell两步操作即可无需改动应用本身。元模块挂载逻辑插件化内核核心本身不做任何挂载模块的安装与挂载委托给唯一运行的元模块单实例约束官方参考实现 meta-overlayfs 提供/system的 overlayfs 读写叠加实现见 userspace/ksud/src/metamodule.rs。收益核心不执行挂载检测面更小挂载策略无挂载、overlayfs、兼容挂载可以整体替换而不改内核不装元模块的用户省掉一整层挂载开销。常见坑与排查刷不进去与模块不生效每条按“现象→原因→处理”给出管理器显示“不支持”。原因设备内核不是 GKI 2.05.10 以上官方不提供可刷的 boot 镜像。处理自编译设备内核并集成 KernelSU文档见 website/docs/zh_CN/guide/how-to-integrate-for-non-gki.md。刷入后无法开机。原因所刷内核的 KMI 或安全补丁与原厂内核不一致新设备防回滚机制拒绝引导。处理以内核版本为准不是 Android 版本选 KMI 相同、安全补丁不旧于原厂的内核刷前备份 boot.img 以便 fastboot 回滚。模块装好却不生效。原因新安装未装元模块依赖挂载的模块缺少挂载执行者。处理安装 meta-overlayfs 或其他元模块后重启脚本、sepolicy、system.prop 类模块则无需元模块。应用检测到 root 环境。原因该应用的 profile 未配置模块修改在其可见的文件系统中留有痕迹。处理为它配置 non-root profile 并启用“卸载模块修改”内核会主动隐藏挂载痕迹。KernelSU 用内核钩子接管 su 审批把 root 从“给不给”细化到“给多少、给什么”。下一步按 website/docs/zh_CN/guide/installation.md 完成首次刷入再为最常用的一个 root 应用配置第一个 App Profile。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考