KernelSU 旧内核适配指南Linux 4.14 非 GKI 设备跑通 root 的完整四步走【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU如果你手机的内核还是 Linux 4.14~5.10 这一段装上 KernelSU 管理器却提示不受支持先别下结论——非 GKI 设备照样可以通过旧内核适配拿到 root代价是你得自己动手编译一整套内核。这篇文章按能不能用、走哪条路、钩子写在哪、改完怎么验四个问题展开你可以对照着一步步做。一、先判断你的设备值不值得动手别急着改代码连上手机先跑一条命令adb shell uname -r看输出前两位数字5.10及以上属于 GKI 2.0 设备有官方 boot 镜像用不上本文4.14~5.9本文覆盖的范围。注意官方不会为非 GKI 设备出 boot 镜像各家内核碎片化太严重镜像只能自己编4.14以下理论可行但要回移不少基础设施不建议普通玩家尝试。两个硬前提内核源码必须是开放的而且你自己能编出一个能开机的内核。如果你从没成功编译过自己设备的内核先解决这个否则后面全是空谈你后续使用的 KernelSU 版本锁定在v0.9.5——自 v1.0 起官方放弃了对非 GKI 内核的支持拿最新 tag 适配旧内核必卡。两条路线怎么选KernelSU 默认用 kprobe 机制做内核钩子你走哪条集成路线取决于 kprobe 在你的内核里是否正常kprobe 正常 → 走自动集成源码树里加上代码就能跑不用逐处打补丁kprobe 不正常常见原因是上游 bug 或内核太老→ 必须手写钩子也就是本文第三、四节的内容。拿不准时可以事后验证集成完如果手机开不了机把对应版本ksu.c里的ksu_sucompat_init()和ksu_ksud_init()临时注释掉再编一版——能正常开机说明问题就在 kprobe转手动路线即可。二、把 KernelSU 代码放进内核源码树两条路线的第一步相同都在你的内核源码根目录操作git clone https://gitcode.com/GitHub_Trending/ke/KernelSU KernelSU cd KernelSU git checkout v0.9.5 cd .. bash KernelSU/kernel/setup.sh v0.9.5这个脚本做的事其实就三件把drivers/kernelsu软链指向仓库的 kernel 目录、往drivers/Makefile追加obj-$(CONFIG_KSU) kernelsu/、在drivers/Kconfig里注册 Kconfig。脚本不放心就手动做这三步效果一样改乱了可以用--cleanup参数让脚本还原。然后找到你设备的 defconfig一般在arch/arm64/configs/你的设备代号_defconfig部分厂商藏在vendor/子目录里追加# KernelSU CONFIG_KSUy CONFIG_KPROBESy CONFIG_HAVE_KPROBESy CONFIG_KPROBE_EVENTSy两个高频坑KPROBES 三项都写了 y 却仍不生效优先检查CONFIG_MODULES有没有开kprobe 的依赖链最常断在这里CONFIG_KSU开不起来时看它的依赖项KPROBES、EXT4_FS等对照 kernel/Kconfig 逐项排查。走 kprobe 路线的话到这里就结束直接编译、刷机、验证。如果编译后手机无法启动回到上一节的 kprobe 验证法确认后转手动路线继续看第三节。三、四个系统调用入口钩在哪里手动路线的本质是在几个系统调用的入口处插一段代码让 KernelSU 有机会先于内核逻辑介入。一共四处fs/open.c 的do_faccessat——文件访问探测root 检测类应用靠access()判断钩在这里才能拦截fs/exec.c 的do_execveat_common——进程执行入口su 提权的核心fs/read_write.c 的vfs_read——文件读取用于改写特定文件的内容fs/stat.c 的vfs_statx——文件属性查询隐藏文件的 stat 结果。四处写法完全同构以 exec 为例文件顶部声明开关变量和处理函数函数入口调用处理函数/* fs/exec.c 顶部声明开关与处理函数 */ #ifdef CONFIG_KSU extern bool ksu_execveat_hook __read_mostly; extern int ksu_handle_execveat(int *fd, struct filename **filename_ptr, void *argv, void *envp, int *flags); #endif static int do_execveat_common(int fd, struct filename *filename, struct user_arg_ptr argv, struct user_arg_ptr envp, int flags) { /* 入口处先问开关打开就把参数交给 KernelSU处理函数可原地改写参数 */ #ifdef CONFIG_KSU if (unlikely(ksu_execveat_hook)) ksu_handle_execveat(fd, filename, argv, envp, flags); #endif return __do_execve_file(fd, filename, argv, envp, flags, NULL); }注意传进去的全部是指针处理函数靠修改指针指向的内容来劫持参数。你要是直接传值编译不报错、运行也不报错钩子就是死的。版本差异老内核去哪里找对应函数上面四个名字是较新内核里的你的内核版本低一档就要换位置内核里没有vfs_statx时改用同文件里的vfs_fstatat见 fs/stat.c钩子位置不变只换函数名4.17 之前的内核没有do_faccessat在 fs/open.c 里找到SYSCALL_DEFINE3(faccessat, ...)的定义用同样方式插进去。四、还有两处不做一定会卡住 安全模式防变砖的最后防线万一刷入后 KernelSU 行为异常靠长按音量下键进安全模式才能救回来。这个功能要钩输入事件不补它最后这条退路就是空的。往 drivers/input/input.c 的input_handle_event里插/* drivers/input/input.c拦截输入事件识别安全模式触发 */ #ifdef CONFIG_KSU extern bool ksu_input_hook __read_mostly; extern int ksu_handle_input_handle_event(unsigned int *type, unsigned int *code, int *value); #endif static void input_handle_event(struct input_dev *dev, unsigned int type, unsigned int code, int value) { /* 开关打开时把事件交给 KernelSU 判断是否构成安全模式触发 */ #ifdef CONFIG_KSU if (unlikely(ksu_input_hook)) ksu_handle_input_handle_event(type, code, value); #endif /* 原有事件分发逻辑保持不变 */ }注意走手动集成路线时defconfig 里必须关掉CONFIG_KPROBES。否则 kprobe 路线和手写钩子会同时拦截输入事件开机时正常按一次音量下键都可能把你直接弹进安全模式。两个小修补pm 命令与卸载模块pm命令老是执行失败的话需要在 fs/devpts/inode.c 的devpts_get_priv()里加一行ksu_handle_devpts(dentry-d_inode)调用处理 devpts 设备节点映射想在旧内核上保留卸载模块能力要把 5.9 内核的path_umount回移到 fs/namespace.c。用不上就跳过不影响基础 root。五、刷入前必做的三项确认编完先别急按顺序做三件事用fastboot boot boot-ksu.img先试启动。不写分区重启即回退有问题不用进恢复模式镜像文件名以你内核的编译产物为准开机后adb shell su -c id输出应为uid0(root)再su -v确认能打印 KernelSU 版本信息连续重启三到五次确认不闪退同时看 logcat 里的avc: denied——如果出现大量与 kernelsu 相关的 SELinux 拒绝记录说明 sepolicy 规则没补全回 manager 里补授权。三项都过了再执行正式刷写。六、动手前这四条避坑建议版本先锁死clone 完立即git checkout v0.9.5最新 tag 与旧内核适配不兼容这是最常见的开坑原因defconfig 别抄错文件CONFIG_KSUy和 KPROBES 相关配置必须写进你设备对应的那份 defconfig改在通用模板里等于没改给自己留退路刷写前备份原始 boot 分区并且永远先用fastboot boot试跑一次再考虑正式写入别在 4.14 以下硬耗本方案只推荐 4.14~5.9 使用再往下的内核要回移的东西多时间成本大概率高于换一台 GKI 设备。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 KernelSU 旧内核适配指南：Linux 4.14 非 GKI 设备跑通 root 的完整四步走
KernelSU 旧内核适配指南Linux 4.14 非 GKI 设备跑通 root 的完整四步走【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU如果你手机的内核还是 Linux 4.14~5.10 这一段装上 KernelSU 管理器却提示不受支持先别下结论——非 GKI 设备照样可以通过旧内核适配拿到 root代价是你得自己动手编译一整套内核。这篇文章按能不能用、走哪条路、钩子写在哪、改完怎么验四个问题展开你可以对照着一步步做。一、先判断你的设备值不值得动手别急着改代码连上手机先跑一条命令adb shell uname -r看输出前两位数字5.10及以上属于 GKI 2.0 设备有官方 boot 镜像用不上本文4.14~5.9本文覆盖的范围。注意官方不会为非 GKI 设备出 boot 镜像各家内核碎片化太严重镜像只能自己编4.14以下理论可行但要回移不少基础设施不建议普通玩家尝试。两个硬前提内核源码必须是开放的而且你自己能编出一个能开机的内核。如果你从没成功编译过自己设备的内核先解决这个否则后面全是空谈你后续使用的 KernelSU 版本锁定在v0.9.5——自 v1.0 起官方放弃了对非 GKI 内核的支持拿最新 tag 适配旧内核必卡。两条路线怎么选KernelSU 默认用 kprobe 机制做内核钩子你走哪条集成路线取决于 kprobe 在你的内核里是否正常kprobe 正常 → 走自动集成源码树里加上代码就能跑不用逐处打补丁kprobe 不正常常见原因是上游 bug 或内核太老→ 必须手写钩子也就是本文第三、四节的内容。拿不准时可以事后验证集成完如果手机开不了机把对应版本ksu.c里的ksu_sucompat_init()和ksu_ksud_init()临时注释掉再编一版——能正常开机说明问题就在 kprobe转手动路线即可。二、把 KernelSU 代码放进内核源码树两条路线的第一步相同都在你的内核源码根目录操作git clone https://gitcode.com/GitHub_Trending/ke/KernelSU KernelSU cd KernelSU git checkout v0.9.5 cd .. bash KernelSU/kernel/setup.sh v0.9.5这个脚本做的事其实就三件把drivers/kernelsu软链指向仓库的 kernel 目录、往drivers/Makefile追加obj-$(CONFIG_KSU) kernelsu/、在drivers/Kconfig里注册 Kconfig。脚本不放心就手动做这三步效果一样改乱了可以用--cleanup参数让脚本还原。然后找到你设备的 defconfig一般在arch/arm64/configs/你的设备代号_defconfig部分厂商藏在vendor/子目录里追加# KernelSU CONFIG_KSUy CONFIG_KPROBESy CONFIG_HAVE_KPROBESy CONFIG_KPROBE_EVENTSy两个高频坑KPROBES 三项都写了 y 却仍不生效优先检查CONFIG_MODULES有没有开kprobe 的依赖链最常断在这里CONFIG_KSU开不起来时看它的依赖项KPROBES、EXT4_FS等对照 kernel/Kconfig 逐项排查。走 kprobe 路线的话到这里就结束直接编译、刷机、验证。如果编译后手机无法启动回到上一节的 kprobe 验证法确认后转手动路线继续看第三节。三、四个系统调用入口钩在哪里手动路线的本质是在几个系统调用的入口处插一段代码让 KernelSU 有机会先于内核逻辑介入。一共四处fs/open.c 的do_faccessat——文件访问探测root 检测类应用靠access()判断钩在这里才能拦截fs/exec.c 的do_execveat_common——进程执行入口su 提权的核心fs/read_write.c 的vfs_read——文件读取用于改写特定文件的内容fs/stat.c 的vfs_statx——文件属性查询隐藏文件的 stat 结果。四处写法完全同构以 exec 为例文件顶部声明开关变量和处理函数函数入口调用处理函数/* fs/exec.c 顶部声明开关与处理函数 */ #ifdef CONFIG_KSU extern bool ksu_execveat_hook __read_mostly; extern int ksu_handle_execveat(int *fd, struct filename **filename_ptr, void *argv, void *envp, int *flags); #endif static int do_execveat_common(int fd, struct filename *filename, struct user_arg_ptr argv, struct user_arg_ptr envp, int flags) { /* 入口处先问开关打开就把参数交给 KernelSU处理函数可原地改写参数 */ #ifdef CONFIG_KSU if (unlikely(ksu_execveat_hook)) ksu_handle_execveat(fd, filename, argv, envp, flags); #endif return __do_execve_file(fd, filename, argv, envp, flags, NULL); }注意传进去的全部是指针处理函数靠修改指针指向的内容来劫持参数。你要是直接传值编译不报错、运行也不报错钩子就是死的。版本差异老内核去哪里找对应函数上面四个名字是较新内核里的你的内核版本低一档就要换位置内核里没有vfs_statx时改用同文件里的vfs_fstatat见 fs/stat.c钩子位置不变只换函数名4.17 之前的内核没有do_faccessat在 fs/open.c 里找到SYSCALL_DEFINE3(faccessat, ...)的定义用同样方式插进去。四、还有两处不做一定会卡住 安全模式防变砖的最后防线万一刷入后 KernelSU 行为异常靠长按音量下键进安全模式才能救回来。这个功能要钩输入事件不补它最后这条退路就是空的。往 drivers/input/input.c 的input_handle_event里插/* drivers/input/input.c拦截输入事件识别安全模式触发 */ #ifdef CONFIG_KSU extern bool ksu_input_hook __read_mostly; extern int ksu_handle_input_handle_event(unsigned int *type, unsigned int *code, int *value); #endif static void input_handle_event(struct input_dev *dev, unsigned int type, unsigned int code, int value) { /* 开关打开时把事件交给 KernelSU 判断是否构成安全模式触发 */ #ifdef CONFIG_KSU if (unlikely(ksu_input_hook)) ksu_handle_input_handle_event(type, code, value); #endif /* 原有事件分发逻辑保持不变 */ }注意走手动集成路线时defconfig 里必须关掉CONFIG_KPROBES。否则 kprobe 路线和手写钩子会同时拦截输入事件开机时正常按一次音量下键都可能把你直接弹进安全模式。两个小修补pm 命令与卸载模块pm命令老是执行失败的话需要在 fs/devpts/inode.c 的devpts_get_priv()里加一行ksu_handle_devpts(dentry-d_inode)调用处理 devpts 设备节点映射想在旧内核上保留卸载模块能力要把 5.9 内核的path_umount回移到 fs/namespace.c。用不上就跳过不影响基础 root。五、刷入前必做的三项确认编完先别急按顺序做三件事用fastboot boot boot-ksu.img先试启动。不写分区重启即回退有问题不用进恢复模式镜像文件名以你内核的编译产物为准开机后adb shell su -c id输出应为uid0(root)再su -v确认能打印 KernelSU 版本信息连续重启三到五次确认不闪退同时看 logcat 里的avc: denied——如果出现大量与 kernelsu 相关的 SELinux 拒绝记录说明 sepolicy 规则没补全回 manager 里补授权。三项都过了再执行正式刷写。六、动手前这四条避坑建议版本先锁死clone 完立即git checkout v0.9.5最新 tag 与旧内核适配不兼容这是最常见的开坑原因defconfig 别抄错文件CONFIG_KSUy和 KPROBES 相关配置必须写进你设备对应的那份 defconfig改在通用模板里等于没改给自己留退路刷写前备份原始 boot 分区并且永远先用fastboot boot试跑一次再考虑正式写入别在 4.14 以下硬耗本方案只推荐 4.14~5.9 使用再往下的内核要回移的东西多时间成本大概率高于换一台 GKI 设备。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考