KernelPatch Module (KPM)

约 1653 字大约 6 分钟

2025-12-23

FolkPatch 基于二次开发，依赖于，继承了其全部功能并进行了扩展。因此，FolkPatch 也支持使用 Modules ()。下面是关于的使用说明。

什么是？

是一种运行在内核空间内的模块，可以让代码直接运行在内核空间中，类似于 Loadable Kernel Modules （），但通过的机制加载。

为 ELF 格式文件，使用 aarch64-none-elf- 工具链构建，通过 sc_kpm_load() 加载到内核中。每个声明 KPM_NAME、KPM_VERSION 等元信息，并实现 KPM_INIT、KPM_CTL0、KPM_CTL1、KPM_EXIT 等生命周期回调。

可以使用提供的 inline hook（hook、hook_wrap）和 syscall hook（hook_syscalln、fp_hook_syscalln）能力，以及通过 kallsyms_lookup_name() 访问内核符号。

通过，你可以实现一些不能实现的功能，例如：

分区镜像保护（格机拦截）
内核级隐藏
系统调用监控和修改
内核函数 Hook

如何安装？

有三种安装方式：嵌入、加载和安装。

关于"安装"

目前，FolkPatch 并没有实现的"安装"操作，因其上游并没有实现。因此现阶段 FolkPatch 的只能通过"嵌入"和"加载"两种方式使用。和的开发者正在努力实现相关功能，请耐心等待。

嵌入

嵌入是指将直接嵌入至 kernel。此模式下安装的会同 kernel 一起被合并进 boot.img 中，在 pre-kernel-init 阶段加载。

的嵌入可以在首次使用 FolkPatch 管理器修补 boot.img 时或者在完成 FolkPatch 安装后进行。你也可以使用 kptools 手动嵌入。

首次修补时嵌入

按照安装指南中的自动修补流程进行修补，在设置 SuperKey 之后不要立即执行下一步操作。
点击"嵌入模块"按钮，之后选择你要嵌入的文件（后缀名为 .kpm）。
确认要嵌入的是你想要使用的。
完成剩余的"自动修补"流程即可。

安装 FolkPatch 后嵌入

在 FolkPatch 安装后，嵌入的方式和安装的方式大致相同。你可以在"内核模块"界面点击右下角的按钮，选择"嵌入"，之后的步骤可以参考首次修补时嵌入进行。

注意

嵌入的在重新修补 boot.img 前不会更新。如果需要更新嵌入的，需要重新执行修补流程。

加载

加载是指将立即交给内核进行加载。通过这种方式加载的会立即生效，但会在下次重新启动后消失（非持久化）。

加载的方式和安装的方式大致相同，唯一一点区别在于在加载后无需重启。

安装

注意

目前和 FolkPatch 还未实现的安装，以下的描述仅为对安装的预期行为描述。

安装是指将作为一个类似于的模块文件安装至 /data/adb/kpmodules 或类似目录。通过这种方式安装的可以在特定的 event 进行加载。

自动加载

FolkPatch 提供了自动加载功能，允许在系统启动时自动加载指定的至内核中。

存储目录为 /data/adb/fp/kpms/，自动加载的放置在 /data/adb/fp/kpms/autoload/ 目录下，配置文件为 /data/adb/fp/kpms/kpm_autoload_config.json。

/data/adb/fp/kpms# KPM 存储目录

autoload# 自动加载目录

example.kpm# KPM 模块文件

kpm_autoload_config.json# 自动加载配置文件

FolkPatch 提供两种配置方式：

可视化配置：通过界面添加文件，编辑参数和加载阶段
JSON 配置：直接编辑 JSON 配置文件

其余行为与加载保持一致。

加载阶段

每个可以选择在以下两个阶段之一加载：

阶段	说明
`service`（默认）	系统服务阶段加载，策略已应用，模块挂载已完成
`post-fs-data`	早期启动阶段加载，在策略注入和模块挂载之前执行

大部分场景使用默认的 service 阶段即可。仅在需要在早期启动阶段介入内核行为时选择 post-fs-data。

{
  "enabled": true,
  "kpmEntries": [
    {
      "path": "/data/adb/fp/kpms/autoload/example.kpm",
      "event": "service",
      "args": ""
    }
  ]
}

enabledRequiredboolean

是否启用自动加载

pathRequiredstring

文件路径（必须在 /data/adb/fp/kpms/autoload/ 目录下）

eventOptionalstring

service

加载阶段：service 或 post-fs-data

argsOptionalstring

传递给的参数字符串，默认为空

注意

最多支持配置 64 个自动加载条目。文件必须位于 /data/adb/fp/kpms/autoload/ 目录下，否则加载会被拒绝。

许可证：Attribution-ShareAlike 4.0 International