Hi everyone,
I'm excited to officially introduce ARK Router (luci-app-ark-router), a high-performance, mobile-first, trilingual (EN / PT-BR / ES) operations control suite and executive dashboard built natively for OpenWrt / LuCI.
Instead of attempting to replace OpenWrt or forking the core system, ARK Router operates as an advanced, non-destructive add-on package on top of official LuCI. It respects your existing UCI configurations, works seamlessly side-by-side with vanilla LuCI, and never overwrites your kernel.
The project is under very active development with constant updates and rapid improvements, driven directly by community feedback, bug reports, and testing across real-world hardware platforms.
Why ARK Router? The Problem It Solves
OpenWrt is the gold standard for routing freedom and network control. However:
- The default LuCI interface is desktop-centric: Monitoring client speeds or configuring network rules from a smartphone or tablet in the field is clunky.
- Advanced engineering requires CLI gymnastics: Enabling ZRAM memory compression, tuning Baby Jumbo MTU 1500 on PPPoE, setting up proper Multi-WAN failover, or resolving hardware flow offloading vs. SQM conflicts often requires editing raw configuration files via SSH with a constant risk of bricking or network lockout.
- Hardware fragility on entry/mid-tier routers: Routers with 128MB–256MB RAM frequently suffer from Out-Of-Memory (OOM) kernel panics when running multiple services, while repeated writes wear down SPI/NAND flash memory.
ARK Router bridges this gap: it packages 69 production-audited features into an intuitive, touch-friendly operations center with zero flash storage wear, automated safeguards, and 1-click execution.
Comprehensive Feature Tour (69 Audited Capabilities)
1.
Multi-WAN & Advanced Routing (mwan3)
- Auto-WAN Port Conversion: Convert any secondary physical LAN port into a dedicated WAN2 in a single click without manually crafting VLAN switch tags.
- Sub-Second Dual-WAN Failover & Balancing: Automated link health checks with session-based load balancing, weighted distribution, and instantaneous failover between fiber, Starlink, 4G/5G, or backup ISPs.
- Broad-Spectrum PBR (BitTorrent / High-Port Balancing): Offload heavy torrent and P2P connections across secondary links while strictly keeping sensitive traffic (ports 80, 443, 53) pinned to your low-jitter primary WAN.
- Isolated Bridge Modem / ONU Web Access: Access your fiber ONT/modem web interface (e.g.,
192.168.1.1or192.168.100.1) directly from your LAN without IP conflicts or complex static routes. - TCP Turbo Engine: Adaptive Linux kernel tuning (BBR/Cubic,
netdev_max_backlog, extended TCP receive/transmit buffers) calibrated specifically to saturate Gigabit links.
2.
Smart Queue Management (SQM / CAKE) & Anti-Bufferbloat
- Zero-Drop CAKE Engine: Instant bufferbloat mitigation targeting clean A+ ratings on latency-under-load tests.
- Auto-Healing
l3_deviceResolution: Solves the notorious OpenWrt bug where SQM binds to the raw physical interface instead of the virtual PPPoE tunnel (pppoe-wan), automatically re-binding rules whenever links bounce. - Dual-WAN SQM Dynamic Sync: Automatically tracks and enforces individual, independent SQM shaping bandwidth limits per WAN connection.
- IRQ Balance & CPU Pinning: Binds CAKE queue processing and network interrupts to dedicated secondary CPU cores, keeping CPU Core 0 100% free for system tasks, DNS, and web serving.
- Mutual Exclusion with Hardware Flow Offload (PPE): Hardware flowtables bypass queues and break SQM. ARK Router enforces mutual exclusion: toggling SQM off automatically restores hardware PPE offloading in real time without requiring a router reboot.
3.
RAM Compression (ZRAM / LZ4) & Memory Shielding
- Double Multitasking on 128MB–256MB Devices: Creates an in-memory LZ4 compressed swap disk running purely in volatile RAM (
/tmp). Absorbs heavy connection spikes with zero flash memory wear, eliminating OOM reboots. - Safety Lock for Single-Core CPUs (MIPS): Automatically detects single-core processors and caps allocation to 32MB with
swappiness=15, preventing the CPU from stalling. - 5-Second Countdown Lock on High-RAM Routers: Routers with $\ge 512$MB RAM feature a timed confirmation modal to avoid wasting CPU cycles when physical memory is already abundant.
- Automated RAM Purge (
ram-purge): Background memory maintenance flushes cached buffers when memory pressure rises.
4.
ARK Doctor (Automated System Auditor & 1-Click Self-Healing)
- 10-Layer Live Health Diagnostic: Continuously audits Wi-Fi radio status,
br-lanbridge topology, DHCP leases, IPv4/IPv6 address assignment, hostapd syntax, and firewall integrity. - 1-Click Self-Repair (
ark-doctor --fix): Fixes duplicate MACs, lingering firewall tables, and syntax mismatches with one click, restoring stability without requiring a factory reset.
5.
Clean Dual-Firewall Engine (fw4 vs fw3)
- 100% Pure
fw4/ nftables: On modern OpenWrt (22.03 to 25.x+), ARK Router exclusively issues nativenftablescommands. It never invokes legacy iptables wrappers, permanently eliminating LuCI's "Legacy rules detected" alert. - Legacy
fw3/ iptables Compatibility: Maintains complete backward compatibility for compact hardware on OpenWrt 19.07–21.02. - UPnP / NAT-PMP IGD with Safe Mode: External WAN ports remain securely closed by default, with 1-click dynamic port opening for gaming consoles (Xbox, PlayStation, Switch, PC) backed by STUN anti-crash protection.
- Baby Jumbo MTU 1500 on PPPoE (RFC 4638): Dynamic hotplug hook (
05-ark-pppoe-babyjumbo) raises the underlying Ethernet interface to 1508/1512 bytes, ensuring a full, unfragmented 1500 MTU inside PPPoE fiber tunnels.
6.
Wi-Fi 6, 6E, Wi-Fi 7 & Mesh Orchestration
- Full Next-Gen Standard Support: IEEE 802.11ax, 802.11be, and Multi-Link Operation (MLO) compatibility.
- Channel & Bandwidth Guardrails: Safely unlocks 320 MHz bandwidth exclusively on the 6 GHz band, while strictly capping 5 GHz at 160 MHz with automatic non-DFS safe-channel fallback (Channel 36).
- Seamless Fast Roaming: Coordinated 802.11r, 802.11k, and 802.11v handoffs to eliminate VoIP and video call drops between APs.
- Client & Band Steering: Integrated
usteerdaemon steers 5GHz/6GHz capable devices away from congested 2.4GHz bands. - EasyMesh 802.11s & Satellite Shield: One-click master and satellite credential sync with Satellite Shield to protect your backhaul mesh connection.
- Wireless Ethernet Dispatch (WED): MediaTek hardware acceleration for Wi-Fi to Ethernet bridging.
- 1-Click Dumb AP Mode with Anti-Lockout: Converts any router into a transparent bridged Access Point (disables NAT and DHCP, dynamically obtaining an IP from your upstream network via DHCP or custom static IP). Simultaneously binds a permanent background fail-safe rescue IP (
192.168.12.1) so you can always access the LuCI panel even on an offline test bench without risking a lockout.
7.
Hybrid AdBlock, Parental Controls & Bandwidth Shaping
- Dual Engine Architecture:
- Full Profile (512MB+ RAM): Runs full AdGuard Home entirely in volatile RAM (
/tmp/adguardhome) on port 3000 with 1M+ local rules, instant caching, and zero flash writes. - Lite Profile (128MB–256MB RAM): Ultra-light Cloud Anycast mode via
dnsmasqsupporting 9 curated security upstreams (Cloudflare 1.1.1.3, Quad9, CleanBrowsing, NextDNS, Control D).
- Full Profile (512MB+ RAM): Runs full AdGuard Home entirely in volatile RAM (
- 0ms Instant Domain Blacklist ("X or Y"): Drops unwanted domains returning
0.0.0.0with 0ms overhead indnsmasq. - Per-Device Rate Limiting with Local LAN Bypass (RFC 1918): Bandwidth caps apply strictly to WAN/Internet traffic. Local transfers (NAS, Plex/Emby, Wi-Fi 6/7 file transfers) continue at native Gigabit/Multi-Gigabit speeds.
- Real-Time Per-Device DMA Telemetry: Live throughput read directly from driver counters (
iwinfo) with Exponential Moving Average (EMA) filtering to kill 0 bps jitter. Includes sortable columns for cumulative consumption (MB/GB).
8.
VPN Suites & Multi-Path Bonding
- Decoupled WireGuard Client & Server: Fast configuration import with sub-100ms RPC responses that never freeze the web UI. Includes QR-code generation for smartphones and dynamic re-sync on WAN failover.
- ZeroTier Remote Access in RAM: Integrated ZeroTier with an ultra-compact 0.3s RAM loader tailored for 16MB flash hardware.
- Speedify Multi-Path Bonding: Combines multiple Internet connections (Fiber + 4G + Wi-Fi) for redundant link bonding.
9.
Starlink Control Center
- Direct gRPC/HTTP integration for Starlink dishes (Gen 1/2/3).
- Displays live obstruction data, SNR, ping drops, throughput, and 3D dish orientation.
- 25-Hour Telemetry Buffer: Retains dish performance logs in RAM without wearing down flash storage.
- Direct LAN Portal (
/starlink/): Fast, unauthenticated local monitoring portal for all household users.
10.
Native Trilingual Experience (Triple i18n)
- 100% Translation Parity: Full, audited coverage across English, Português (Brasil), and Español (Neutro).
- Not machine-translated: all screens, modals, tooltips, and validation errors are naturally localized while preserving universal networking terms (WAN, LAN, MTU, PPPoE, SSID, CAKE, BSS Coloring).
Screenshots
| Dashboard Overview | Performance & Memory Shielding (ZRAM / UPnP) |
|---|---|
![]() |
![]() |
| Mobile-First UI | Live Multi-Starlink Telemetry |
|---|---|
![]() |
![]() |
| SQM CAKE Bufferbloat Tuner | WAN & Multi-WAN Controls |
|---|---|
![]() |
![]() |
Hardware Profiles & Compatibility
ARK Router automatically selects the optimal profile based on your hardware resources:
| Profile | Target Specs | Example Devices | Active Feature Set |
|---|---|---|---|
| Ultra-Lite | 128MB RAM / 16MB Flash | D-Link DGL-5500, Archer C7 v2/v5 | Cloud Anycast AdBlock, MIPS-capped ZRAM (32MB), SQM CAKE, Pure fw3/fw4, Core Dashboard |
| Balanced | 256MB–512MB RAM / 128MB+ Flash | Cudy WR3000 v1, GL.iNet MT3000 | Dynamic ZRAM (116MB), Multi-WAN mwan3, WireGuard, ZeroTier in RAM, irqbalance, nlbwmon |
| High Performance | 512MB–1.5GB RAM (Quad-Core) | Acer Predator W6x, Flint 2 (GL-MT6000) | Local AdGuard Home in RAM, Multi-Starlink, Hardware WED, High-speed WireGuard Server |
| Enterprise / x86 | >1.5GB RAM / 8+ Cores | Protectli, Minisforum, VirtualBox x86 | Unlimited Multi-WAN, Full speed multi-gigabit CAKE shaping, Enterprise QoS |
- OpenWrt Compatibility: 19.07, 21.02, 22.03, 23.05, 24.10, and modern 25.x snapshots (
luci-compat). - Package Managers: Both modern
apkand classicopkgare natively supported. - Architecture:
all/noarchpackage.
Active Development & Constant Updates
ARK Router is actively developed and frequently updated. We continuously roll out:
- Ongoing performance tuning for MediaTek Filogic, Qualcomm Atheros, and x86 architectures.
- Regular compatibility fixes for upstream OpenWrt changes (including
nftables/fw4evolutions andapkpackaging). - Built-in OTA updates and simple package upgrades (
.apkand.ipk) right from the system tools.
Quick Installation
ARK Router installs cleanly as an add-on package without breaking your existing network configurations.
Option 1: Automated 1-Line Installer (Recommended)
Connect via SSH to your OpenWrt router and run:
wget -O- https://raw.githubusercontent.com/Despensativo/ark-router/main/scripts/install.sh | sh











