KernelSU 模块改了 /system 却不生效meta-overlayfs 元模块安装完整指南【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSUKernelSU 把模块的挂载逻辑从内核核心剥离到了独立的元模块metamodule。想让自己的模块覆盖 /system 目录下的文件就需要先装上官方元模块 meta-overlayfs。装好之后已启用模块的 system 目录会在开机时以 OverlayFS 方式叠加到系统分区之上属于 systemless 操作/system 分区本身不会被改动。装机前先搞懂元模块的挂载机制为什么模块装上了/system 里的文件却没变化因为没有元模块时KernelSU 根本不会挂载模块文件。可以把元模块理解成一个挂载管理器开机时由它负责把各模块的目录叠到对应分区上核心本身不再经手这件事。meta-overlayfs 是官方提供的参考实现基于内核 OverlayFS 完成挂载还支持用 ext4 镜像modules.img存放模块文件。重启后它会在启动流程的 post-fs-data 阶段执行挂载脚本把所有已启用模块的system目录叠加到系统分区支持system、vendor、product、system_ext、odm、oem多个分区。元模块只为要改 /system 文件的模块服务。模块如果只用启动脚本、sepolicy.rule或system.prop不装元模块也能正常工作。装机中meta-overlayfs 安装步骤元模块的安装方式和普通模块完全相同下载元模块的 ZIP 文件例如meta-overlayfs.zip。打开 KernelSU Manager 应用。点击悬浮按钮➕。选择刚才下载的元模块 ZIP 文件。重启设备。除了 overlayfs 方案还有无挂载、Magic Mount、自定义方案等其他元模块实现开发元模块会用到metamodule1属性和metamount.sh等钩子脚本细节见 元模块指南。装机后确认元模块已生效验证入口在 Manager 应用里打开Module 页面当前激活的元模块会出现在模块列表中并带有特殊的元模块标识。system 目录到底怎么覆盖装好 meta-overlayfs 后模块里system目录的行为如下与系统同名的文件被模块中的文件覆盖与系统同名的目录两者合并想删除原系统文件在模块内用mknod filename c 0 0生成同名占位由 OverlayFS 做 whiteout/system分区本身不变想整目录替换在模块内创建同名目录并执行setfattr -n trusted.overlay.opaque -v y TARGET或在customize.sh中声明REMOVE/REPLACE变量由 KernelSU 自动处理。真正的验收不看日志看行为模块声明的那些覆盖、删除、替换重启后是否按预期体现出来。切换元模块的限制与副作用注意KernelSU 同一时间只允许安装一个元模块。已经装了某个元模块比如从别的设备迁移来的配置时再装第二个会被直接阻止安装。想换成另一个元模块按以下顺序操作卸载所有普通模块卸载当前元模块重启安装新的元模块重新安装普通模块再次重启。卸载元模块有明确副作用它会影响所有模块。卸载之后、换装完成之前所有模块都不会再被挂载。设备本身能正常开机只是模块修改不再生效。排查时可以利用一个符号链接元模块安装后KernelSU 会创建/data/adb/metamodule - /data/adb/modules/metamodule_id这是一条与模块 ID 无关的稳定路径用它就能确认当前激活的是哪个元模块。模块仍不生效时排查什么FAQ 中为什么全新安装后模块不工作一节的结论与前面一致需要修改 /system 文件的模块必须安装元模块来挂载system目录其余能力不依赖元模块。装好元模块、重启后仍不生效逐项检查Module 页面中元模块是否确实出现在列表里目标模块是否存在skip_mount标记文件目标模块是否存在disable标记文件。注意skip_mount或disable任一存在时该模块的system目录就不会被挂载。确认无误后模块目录怎么组织继续参考 模块指南。【免费下载链接】KernelSUA Kernel based root solution for Android项目地址: https://gitcode.com/GitHub_Trending/ke/KernelSU创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考