如何安装 meta-overlayfs 元模块——五步让模块真正挂上 /system

meta-overlayfs 的定位

meta-overlayfs 是 KernelSU 官方的参考元模块实现，提供传统的基于 overlayfs 的模块挂载，支持把模块的 system 内容叠加进 /system，并支持读写层。绝大多数「模块不生效」的用户装上它就解决了。它采用双目录架构：元数据（module.prop 与状态标记）留在 /data/adb/modules 供快速扫描，实际模块文件存放在 /data/adb/metamodule/mnt/ 下的 ext4 镜像中以优化空间。

安装步骤

1. 从官方发布页下载元模块 zip（如 meta-overlayfs.zip）；
2. 打开 KernelSU 管理器；
3. 点击模块页的浮动操作按钮（➕）；
4. 选择下载好的元模块 zip；
5. 重启设备。

重启后在模块页可以看到它——活动的元模块会显示在模块列表中并带有特殊标识。之后刷入带 system 目录的常规模块，重启后修改即生效。

卸载与切换

卸载元模块时管理器会弹出特殊警告，因为它影响所有模块：卸载后所有模块将不再被挂载，设备照常开机，但模块修改不会生效，直到你安装另一个元模块。

切换元模块（例如从 overlayfs 方案换到 Magic Mount 方案）的正确顺序：

1. 卸载所有常规模块；
2. 卸载当前元模块；
3. 重启；
4. 安装新元模块；
5. 重新安装常规模块；
6. 再次重启。

跳过第 1 步和第 5 步，旧模块可能在新挂载方案下出现状态不一致。

自检清单

装完仍不生效？按序检查：

• 模块页里元模块是否处于启用状态；
• 模块自身是否启用（没有 disable 标记）；
• 模块有没有 skip_mount 标记；
• 设备是否刚做完 OTA（分区对不上时挂载可能失败，见 系统 OTA 后如何保住 root）；
• 以上都正常还不行，用 ksud 看日志或到社区求助，命令见 模块变砖清理。