39 lines
2.1 KiB
Markdown
39 lines
2.1 KiB
Markdown
|
# IIAB-oA Controller
|
||
|
|
|
||
|
|
**IIAB-oA Controller** is a specialized infrastructure component for the **Internet-in-a-Box (IIAB)** ecosystem on Android. It acts as a "Walled Garden" and persistent "Watchdog" designed to keep the Termux environment alive and accessible, even on devices with aggressive power management (e.g., Oppo/ColorOS, MIUI).
|
||
|
|
|
||
|
|
## Core Capabilities
|
||
|
|
|
||
|
|
### 🛡️ Master Watchdog (Supervision Layer)
|
||
|
|
An independent foreground service dedicated to environment stability:
|
||
|
|
|
||
|
|
* **CPU & Wi-Fi Shield**: Prevents the system from putting Termux into Doze mode or disabling the Wi-Fi radio.
|
||
|
|
* **Heartbeat Pulse**: Sends a regulated API signal every 20 seconds to maintain process priority.
|
||
|
|
* **Zero-Config Protection**: Works independently of the VPN tunnel.
|
||
|
|
|
||
|
|
### 🌐 Safe Pocket Web (Network Layer)
|
||
|
|
A high-performance VPN tunnel based on the tun2socks engine:
|
||
|
|
|
||
|
|
* **Friendly URLs**: Routes traffic through internal IIAB services seamlessly.
|
||
|
|
* **Walled Garden**: Ensures a secure, filtered browsing environment.
|
||
|
|
* **Per-App Routing**: Granular control over which applications use the secure tunnel.
|
||
|
|
|
||
|
|
### 🔒 Built-in Security
|
||
|
|
* **Biometric/PIN Lock**: Authentication is strictly required before the Watchdog or VPN can be disabled.
|
||
|
|
* **Safety Check**: Prevents activation if the device lacks a secure lock method (PIN/Pattern/Fingerprint), ensuring the user is never "locked out" of their own settings.
|
||
|
|
|
||
|
|
## Acknowledgments
|
||
|
|
This project is a heavily customized spin-off of **[SocksTun](https://github.com/heiher/sockstun)** created by **[heiher](https://github.com/heiher)**.
|
||
|
|
All credit for the core native tunneling engine goes to the original author. This derivative has been re-architected to meet the specific requirements of the IIAB project.
|
||
|
|
|
||
|
|
## Technical Details
|
||
|
|
* **Current Version**: v0.1.12alpha
|
||
|
|
* **License**: **MIT License** (See [LICENSE](LICENSE) for details).
|
||
|
|
* **Compatibility**: Android 8.0 (API 26) and above.
|
||
|
|
|
||
|
|
## Disclaimer
|
||
|
|
This is a preview and demo published in the hope that it will be useful, but WITHOUT ANY WARRANTY.
|
||
|
|
|
||
|
|
---
|
||
|
|
*Maintained by IIAB Contributors - 2026*
|