Hybrid Mount
Hybrid Mount is a mount logic metamodule implementation for KernelSU and APatch. It manages module file integration into the Android system using a combination of OverlayFS and bind mounts (Magic Mount).
The project includes a WebUI dashboard for module management and configuration.
Technical Overview
Mounting Strategies
The core binary (meta-hybrid) determines the mounting method for each module directory based on configuration and system compatibility:
- OverlayFS: Uses the kernel’s OverlayFS to merge module directories with system partitions. This is the default strategy for supported filesystems.
- Magic Mount: Uses recursive bind mounts to mirror modified file structures. This serves as a fallback strategy when OverlayFS is unavailable or fails.
Functionality
- Conflict Detection: Scans module file paths to identify collisions where multiple modules modify the same file.
- Module Isolation: Supports mounting modules in isolated namespaces.
- Configurable Strategies: Users can force specific partitions or modules to use OverlayFS or Magic Mount via
config.toml. - Recovery Protocol: Includes a mechanism to restore default configurations in case of boot failures caused by invalid settings.
Configuration
Configuration is stored at /data/adb/meta-hybrid/config.toml.
| Parameter | Type | Default | Description |
|---|---|---|---|
moduledir | string | /data/adb/modules/ | Path to the module source directory. |
mountsource | string | Auto-detect | Mount source label (e.g., KSU, APatch). |
partitions | list | [] | List of partitions to explicitly manage. |
overlay_mode | string | tmpfs | Backend for loop devices (tmpfs, ext4, erofs). |
disable_umount | bool | false | If true, skips unmounting the original source (debug usage). |
backup | object | {} | Settings for boot snapshot retention. |
WebUI
The project provides a web-based interface built with SolidJS.
- Status: View current storage usage and kernel version.
- Management: Toggle mount modes per module.
Build Instructions
The project uses xtask for build automation.
Prerequisites
- Rust: Nightly toolchain.
- Android NDK: r27 or newer.
- Node.js: v20+ (Required for WebUI compilation).
Compilation
Full Build (Binary + WebUI):
cargo run -p xtask -- build --releaseOutput will be generated in the
output/directory.Binary Only:
cargo run -p xtask -- build --release --skip-webui
License
This project is licensed under the GPL-3.0 License.
Download Hybrid Mount
Module Info
- Version v2.5.0
- Module By
- Contributors YuzakiKokuban, github-actions[bot], Tools-cx-app, dependabot[bot], 7a72
- Root SupportMagisk KernelSU APatch
- Source View on GitHub/Source
- Latest Update
- Word Counter 325
- Character Counter 5454
Hybrid Mount is a Module that supports installation on Magisk, KernelSU, APATCH, KSUNext