Magisk模块如何正确挂载system分区？

Question

在制作Magisk模块时，常见问题是如何正确挂载system分区以实现系统文件的修改。部分设备因采用动态分区（如A/B分区）或只读挂载机制，导致模块在init阶段无法成功挂载/system为可写，从而造成替换文件失败。此外，某些厂商ROM对magiskd的挂载时机支持不佳，或使用了system-as-root结构，进一步增加了挂载复杂度。开发者常误以为只需在`post-fs-data.sh`中执行`mount -o rw,remount /system`即可，但实际上需结合`$MAGISKTMP`路径通过Magisk的overlay机制挂载，或利用`mount_point`指令在`service.sh`中正确绑定。如何在不同Android版本与设备上稳定实现system分区的可写挂载，成为模块开发中的关键难点。

Answer 1

1. Magisk模块开发中的System分区挂载基础概念

在Android系统中，/system分区通常以只读方式挂载，目的是确保系统完整性与安全性。Magisk通过其特有的magiskd守护进程，在系统启动早期阶段介入，利用overlay机制实现对/system等关键目录的非破坏性修改。开发者常误以为只需在post-fs-data.sh中执行mount -o rw,remount /system即可写入文件，但该命令在多数现代设备上无效，尤其在使用system-as-root或A/B动态分区结构时。

• system-as-root：/system合并至根目录，无独立挂载点
• A/B分区：active slot机制限制直接写入物理分区
• 只读挂载策略：厂商ROM常强制锁定mount flags

2. 挂载失败的典型场景与日志分析

当模块在post-fs-data.sh尝试直接remount时，logcat中常出现如下错误：

D/Magisk: post-fs-data.d/script.sh: mount: '/system' not in /proc/mounts
E/Magisk: post-fs-data.d/script.sh: mount failed: Permission denied

这表明/system并未作为独立文件系统存在，或已被绑定挂载为只读。通过解析/proc/mounts可确认当前挂载状态：

Device	Mount Point	FSType	Options
/dev/block/dm-0	/	ext4	ro,seclabel
tmpfs	/system	tmpfs	rw,seclabel

可见/为只读，而/system是tmpfs虚拟挂载——此时无法通过传统mount remount修改。

3. 正确挂载路径：利用$MAGISKTMP与Magisk Overlay机制

Magisk提供$MAGISKTMP环境变量指向临时工作目录（如/magisk/MAGISK_VER_CODE/RAND_ID），开发者应在此路径下构建overlay结构：

# 在 module.prop 后创建目录结构
mkdir -p $MAGISKTMP/system/app
cp myapp.apk $MAGISKTMP/system/app/

# 使用 magisk --clone-attr 自动继承SELinux上下文
magisk --clone-attr /system/app $MAGISKTMP/system/app

Magisk daemon会在后续阶段自动将此目录通过bind-mount或overlayfs挂载到目标位置，绕过物理分区限制。

4. 高级挂载控制：service.sh中的mount_point指令

对于需精确控制挂载时机的场景，可在service.sh中使用mount_point函数声明挂载依赖：

#!/system/bin/sh
# service.sh

# 声明需等待/system挂载后再执行
mount_point /system

if [ -f /system/build.prop ]; then
    echo "system mounted, proceeding..."
    # 执行定制化替换逻辑
    cp $MODDIR/custom.so /system/lib/
fi

该机制确保脚本在系统完成挂载后运行，避免race condition。

5. 跨Android版本兼容性策略对比

graph TD A[Android 7-9] -->|传统挂载| B(/system 可remount) A --> C{Magisk Mount} C --> D[使用 $MAGISKTMP overlay] E[Android 10+] -->|A/B分区+system-as-root| F(/ 已包含/system) E --> G[使用 magisk --add-module] G --> H[自动处理 overlayfs] I[厂商定制ROM] --> J[禁用magiskd early mount] J --> K[降级至 late_start service]

6. 实践建议与最佳开发流程

1. 始终检查/proc/mounts判断实际挂载结构
2. 避免在post-fs-data.sh中调用mount -o remount
3. 优先使用$MAGISKTMP目录进行文件部署
4. 通过magisk --clone-attr保留SELinux标签
5. 在service.sh中使用mount_point同步挂载状态
6. 针对A/B设备，确认当前slot（如ro.boot.slot_suffix）
7. 测试时启用magisk --verbose获取详细日志
8. 使用magiskpolicy工具处理SELinux规则冲突
9. 对systemless模块保持无侵入设计原则
10. 在Android 12+上验证APEX模块兼容性