KernelSU meta-overlayfs 元模块快速安装与验收清单：让模块覆盖 system 真正生效

KernelSU meta-overlayfs 元模块快速安装与验收清单让模块覆盖 system 真正生效【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU给 KernelSU 装上元模块负责挂载各模块的插件组件官方参考实现为 meta-overlayfs后模块对 /system 等系统分区的修改才会在开机时真正生效。全文按自查、安装、验收、排查四步讲清 KernelSU 元模块安装。先自查是否用得上你你的模块行为是否需要元模块一句话理由修改 /system 下的文件覆盖应用、去预装、整目录替换需要 ✅元模块不挂载system 目录就不生效仅用开机脚本post-fs-data.sh、service.sh 之类不需要脚本自己执行不依赖挂载使用 sepolicy.rule 调规则不需要由 KernelSU 核心自行加载使用 system.prop 改属性不需要开机直接读取不经挂载后三种情况可直接跳过元模块安装。花 2 分钟看懂它的工作方式好比在一叠已印好的表格上逐页压一张修正页合看时以修正页为准原件一个格都没动撤掉修正页又恢复原样。meta-overlayfs 做的事与此相同——它在开机 post-fs-data数据分区挂载完成后的早期阶段以 systemless无侵入式叠加原始分区保持原样的方式把所有已启用模块的 system 目录分别叠到 /system、/vendor、/product、/system_ext、/odm、/oem 六个分区上。想隐藏某个原文件机制叫 whiteout零字节占位符让原文件被自动隐藏想让整目录只剩模块侧内容标记叫 opaque不透明不与下层内容合并。架构细节可查元模块指南。三步装完阶段动作备注准备下载meta-overlayfs.zip确认当前没有已激活的元模块同一时间只允许一个元模块安装打开 KernelSU Manager点悬浮的加号按钮选中压缩包确认装第二个会被直接拦截重启重启设备等开机完成挂载在 post-fs-data 阶段自动完成重启后的验收清单Module 页面里能看到 meta-overlayfs且带元模块专属标识/data/adb/metamodule符号链接指向当前激活的元模块目录——与模块 ID 无关排查现在激活的是谁看它就够同名文件覆盖生效读到与系统同名的文件时内容是模块侧的⚠️ whiteout 删除生效mknod filename c 0 0生成的同名占位符处原文件已不可见而 /system 分区本身未变opaque 整目录替换生效setfattr -n trusted.overlay.opaque -v y 目录之后该目录只保留模块自己的内容懒人写法在 customize.sh 里声明 REMOVE / REPLACE 列表占位符与 opaque 标记由 KernelSU 自动处理模块不生效排查手册装第二个元模块被拦→单实例限制防止两套挂载方案冲突→卸载全部普通模块卸掉当前元模块重启装新的元模块再装回普通模块卸载元模块后所有模块修改失效→卸载后模块全部失去挂载能力能开机但改动不落地→尽快装一个新的元模块不打算换就不轻易卸载某个模块一直不挂载→ **模块目录内放着 skip_mount跳过挂载或【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考