iiab-tools/apk/controller

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 created by 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 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