FolkPatch

简体中文

English

简体中文

English

外观

安装/使用

约 2004 字大约 7 分钟

2025-08-16

本指南将帮助您从零开始安装和使用 FolkPatch。

基础知识

什么是 FolkPatch？

FolkPatch 是 APatch 的分支，在 APatch 基础上对管理器进行了多项拓展。它不仅专注于优化界面设计和功能扩展，还引入了 Magic Mount（类 Magisk 挂载）、Meta Module（元模块）系统、KPM 自动加载、模块批量刷入、模块备份等核心功能增强。

准备工作

  • 一台已解锁 Bootloader 的手机
  • 一台拥有 ADB 工具的电脑
  • 你的手机内核支持 KernelPatch

检查设备兼容性

支持的设备条件

  • ARM64 架构（近年的安卓手机基本都支持）
  • Linux 内核版本 3.18 - 6.15+

不支持的设备

  • 非 ARM64 架构设备（部分老旧平板）
  • 内核版本低于 3.18 的设备

如何检查内核版本？

  1. 方法一：手机设置查看

    • 设置 → 关于手机 → 软件信息 → 内核版本

  2. 方法二：使用 ADB 命令

    adb shell uname -r

如何检查内核配置（需已有 Root 权限）

如果您的手机已经 Root，可以使用以下命令检查内核配置：

zcat /proc/config.gz | grep CONFIG_KALLSYMS

应显示：

CONFIG_KALLSYMS=y
CONFIG_KALLSYMS_ALL=y

提示

CONFIG_KALLSYMS_ALL=y 是最理想的配置。如果只有 CONFIG_KALLSYMS=y 而 CONFIG_KALLSYMS_ALL=n，部分功能可能受限。

如果显示以上任一配置，说明您的设备理论上支持 KernelPatch，即支持 FolkPatch。但实际兼容性还受内核具体实现影响。

并非所有内核都会暴露 /proc/config.gz，如果该文件不存在，无法通过此方法检查。

获取必要文件

获取 Boot 镜像

  1. 从官方固件包获取

    • 下载对应您手机型号的官方固件
    • 解压后找到 boot.img 文件
    • 复制到电脑上备用

  2. 从当前设备提取

    # 需要有 ADB 权限
adb pull /dev/block/by-name/boot ./boot.img

备份 Boot 镜像

注意

务必备份原始的 boot.img 镜像！

这份文件是恢复系统的重要保障，如果出现无法启动等问题需要用它来修复手机！

安装 FolkPatch

方法一：官方工具一键刷入（推荐）

FolkTool 是官方推出的 Windows 专用一键刷入工具，旨在简化安装流程。

详细图文教程请参考：FolkTool 使用指南

  1. 下载工具：访问 FolkTool 发布页 下载最新版本的工具。
  2. 连接设备：确保您的手机已开启 USB 调试并连接到电脑。
  3. 一键刷入：运行工具并按照界面提示操作即可自动完成刷入。

方法二：自动修补（推荐新手使用）

  1. 安装 FolkPatch 管理器

    • 在手机上下载并安装 FolkPatch 管理器 APK
    • 允许"安装来自未知来源的应用"

  2. 修补 Boot 镜像

    • 打开 FolkPatch 管理器
    • 点击右上角的修补按钮
    • 选择"选择一个启动镜像并修补"
    • 找到并选择您准备好的 boot.img 文件

    使用本地补丁文件(KPimg)

    在安装页的 KernelPatch 修补/安装 菜单下，有一个 「使用本地补丁文件(KPimg)」 选项。点击后可选择自定义的 kpimg-android 文件进行修补，后续流程与正常修补一致。

    此功能适用于需要使用特定版本 KernelPatch 补丁的场景，kpimg-android 文件需自行从 KernelPatch 发布页 下载，FolkPatch 本身不自带此文件。

    相关信息

    FolkPatch 4.3 起采用纯签名验证认证，无需设置任何密码。详细信息请参阅认证机制。

  3. 完成修补

    • 点击"开始修补"并等待完成
    • 修补成功后会显示修补后的镜像路径，例如： /storage/emulated/0/Download/folkpatch_xxxx.img

继续阅读下方的"刷入镜像"部分完成安装。

方法三：手动修补（适合高级用户）

当 KernelPatch 更新后，管理器还未更新时，可以使用此方法。

  1. 下载工具

    • 访问 KernelPatch 发布页
    • 下载以下文件：
      • kptools-win.zip（Windows 用户）或 kptools-linux（Linux 用户）
      • kpimg-android

  2. 修补内核 KernelPatch 0.13.0 以上版本的 kptools 已内置解包和重打包功能，无需额外使用 magiskboot，整个流程分为三步：

    # Windows 用户
 kptools-x86_64-win.exe unpack boot.img
 kptools-x86_64-win.exe -p --image kernel --skey "su" --kpimg kpimg-android --out kernel
 kptools-x86_64-win.exe repack boot.img

 # Linux 用户
 ./kptools-linux unpack boot.img
 ./kptools-linux -p --image kernel --skey "su" --kpimg kpimg-android --out kernel
 ./kptools-linux repack boot.img

完成后，您会得到一个名为 new-boot.img 的文件，这就是修补好的镜像。

方法四：直接刷入（通过 Recovery）

最新版本的 FolkPatch 支持从 TWRP 等第三方 Recovery 一键刷入。

注意

此功能于版本 11142 引入，更早的版本不支持这种方式。

  1. 重命名安装包 将下载的 FolkPatch 安装包（.apk）后缀改为 .zip，例如：

    FolkPatch-11142-release.apk → FolkPatch-11142-release.zip

  2. 通过 Recovery 刷入

    • 将手机进入第三方 Recovery（如 TWRP）
    • 选择"安装"或"Install"功能
    • 浏览并选择重命名后的 .zip 文件
    • 滑动确认刷入，等待完成

    提示

    第三方类原生 ROM 的 Recovery（例如 LineageOS）所使用的 adb sideload 方法也支持。

重要提醒

通过 Recovery 刷入时，认证方式同样为签名验证，无需任何额外配置。开机后确保安装了官方签名的 FolkPatch 管理器即可自动完成认证。

刷入镜像（适用于方法二和方法三）

准备工作

  1. 确保手机已开启 USB 调试
  2. 将修补后的镜像复制到电脑上
  3. 连接手机和电脑

开始刷入

  1. 进入 Fastboot 模式

    adb reboot bootloader

  2. 刷入修补后的镜像

    # 替换 PATH/TO/boot.img 为您修补后的镜像实际路径
fastboot flash boot PATH/TO/boot.img

  3. 重启设备

    fastboot reboot

小技巧

如果您不确定刷入是否成功，可以先使用以下命令临时启动：

fastboot boot PATH/TO/boot.img

这样如果系统无法正常启动，只需重启手机即可恢复原状。

安装后操作

验证 Root 权限

  1. 安装 Root 权限检测应用（如 Root Checker）
  2. 打开应用并检查是否显示"Root 权限已获取"

使用 Root 应用

FolkPatch 是基于内核空间管理的 Root 方案，与 Magisk 的被动弹窗授权不同，你需要手动在管理器中为应用授权：

  1. 打开需要 Root 权限的应用（应用会提示未获取 Root）
  2. 打开 FolkPatch 管理器，进入 超级用户 页面
  3. 在应用列表中找到该应用，手动授予 Root 权限
  4. 回到应用即可正常使用 Root 功能

安装模块

  1. 打开 FolkPatch 管理器
  2. 进入"模块"页面
  3. 可以下载并安装各种功能模块

卸载 FolkPatch

方法一：通过管理器卸载

FolkPatch 管理器内置了卸载功能，无需借助其他工具：

  1. 打开 FolkPatch 管理器
  2. 进入 设置 页面
  3. 找到并点击 卸载 按钮
  4. 确认卸载操作，等待完成

方法二：通过 Recovery 卸载

  1. 下载与您当前版本相同的 FolkPatch 安装包
  2. 将文件重命名，添加 -uninstall，例如： FolkPatch-10888-release.apk → FolkPatch-10888-release-uninstall.zip
  3. 将文件传入手机，通过 Recovery 刷入即可

提示

同样支持使用 adb sideload 方式刷入卸载包。

方法三：手动刷回原 Boot 镜像

  1. 让手机进入 Fastboot 模式：

    adb reboot bootloader

  2. 刷回您之前备份的原厂 Boot 镜像：

    fastboot flash boot PATH/TO/original_boot.img

  3. 重启手机：

    fastboot reboot

警告

FolkPatch 修补的分区始终为 boot，修补 init_boot 为无效操作。刷入 init_boot 只会导致系统无法启动！

完成

恭喜！您已经成功安装了 FolkPatch。

安全刷机原则：

  • 只安装来源可靠的应用和模块
  • 定期备份重要数据
  • 不要随意修改系统关键文件

部分资料引用 APatch 文档

版权归属：FolkPatch Team

许可证：署名 4.0 国际 (CC-BY-4.0)