Nexora - OpenWrt Traffic Monitoring & Management System (v1.2.0)

Nexora is an enterprise-grade, high-performance bandwidth monitoring, Quality of Service (QoS) management, and web access blocking application for OpenWrt routers. It integrates seamlessly into the LuCI web interface to deliver real-time per-device traffic accounting, intelligent rate limiting, quota controls, and persistent telemetry with minimal router CPU overhead.

---

What's New in v1.2.0

• Master QoS Toggle Switch — Enable or disable the entire QoS engine cleanly with one click.
• Instant Internet Block & Unblock — Toggle internet access per connected device instantly via smooth slider controls.
• Bandwidth Quota Management — Set daily, monthly, or total usage data limits with soft and hard quota enforcement.
• Transmitter-Aware Real-Time Online Detection — Authoritative online/offline detection using kernel IP neighbor state, active hostapd Wi-Fi client dumps, and real-time upload packet flows. Eliminates false online status and background noise speeds for offline devices.
• App & Preset Web Blocker — Block major platforms (Social Media, Streaming, Gaming, Adult Content, DoH bypass prevention) and custom domains.
• High-Density Compact Rules UI — Modern, clean table UI with no emojis, status indicators, and compact rule controls.
• Native Dual Package Support — Full support for OpenWrt 24.10+ (.apk) and OpenWrt 19.07–23.05 (.ipk).

---

Features

• Real-Time Bandwidth Monitor — High-precision traffic monitoring with live telemetry graphs.
• Per-Device Traffic Accounting — Tracks download/upload usage and total session traffic per MAC and IP address.
• Quality of Service (QoS) — Fine-grained download and upload rate limiting (Kbps/Mbps) per client device.
• Internet Access & App Blocker — Block individual devices or domain categories with one-click toggles.
• Bandwidth Quotas & Scheduling — Manage data caps per reset cycle (Daily, Monthly, Fixed Total).
• Historical Traffic Analytics — Persistent daily, monthly, and hourly data retention with CSV and JSON exports.
• Dual Package Support — Native .apk for OpenWrt 24.10+ and .ipk for OpenWrt 19.07–23.05.
• Self-Healing Installer — Automatic fallback extraction and dependency resolution.

---

How to Connect to Router via SSH

Before running installation commands, connect to your OpenWrt router terminal via SSH.

1. Windows (PowerShell / Command Prompt) or macOS / Linux (Terminal)

Open your terminal or PowerShell and run:

ssh root@192.168.1.1

(Replace 192.168.1.1 with your router's IP address if different)

• First-time connection notice: Type yes and press Enter when asked to trust the host key.
• Password: Enter your router root password when prompted. (If no password has been set on OpenWrt yet, press Enter).

---

2. Using PuTTY on Windows (GUI Method)

1. Download and open PuTTY.
2. In Host Name (or IP address), enter: 192.168.1.1.
3. Ensure Port is set to 22 and Connection Type is SSH.
4. Click Open.
5. When the terminal opens, type root for login as, then press Enter.

---

Installation

There are two ways to install Nexora v1.2.0 depending on whether your router has internet access.

Option 1 — Online Installation (Router has internet access)

Connect to your router via SSH and run one of the following commands:

Using wget (available by default on OpenWrt):

wget -qO- https://raw.githubusercontent.com/jahidulislamzim/Nexora/main/install.sh | sh

Using curl:

curl -sSL https://raw.githubusercontent.com/jahidulislamzim/Nexora/main/install.sh | sh

The script automatically detects your package manager (apk or opkg), fetches v1.2.0, installs the package, and restarts all required services.

---

Option 2 — Offline Installation (Deploy from your PC)

Use this method when your router has no internet access or you want to deploy local package files.

Prerequisites:

• Download the Nexora v1.2.0 release folder to your PC
• Ensure luci-app-nexora-1.2.0-r1.apk or luci-app-nexora_1.2.0-1_all.ipk is inside the packages/ subfolder
• Ensure your PC is on the same network as your router
• SSH must be enabled on the router

On Linux, macOS, or Git Bash (Windows)

Open a terminal, navigate to the Nexora folder, and run:

# Prompts for router IP interactively
./install.sh

# Or specify the router IP directly
./install.sh 192.168.1.1

On Windows (PowerShell or CMD)

Easiest method — double-click: Double-click install.bat in File Explorer. Enter your router IP when prompted.

From PowerShell:

# Prompts for router IP interactively
.\install.ps1

# Or specify the router IP directly
.\install.ps1 192.168.1.1

Both scripts automatically detect the router's architecture and package format (.apk or .ipk), upload it to the router using SCP, install v1.2.0, and restart all services.

---

Manual Installation (Windows — Advanced)

If you prefer to run the installation commands manually:

Note on SCP: OpenWrt uses the Dropbear SSH server, which does not include an SFTP server by default. You must use the -O flag with scp to force legacy SCP mode.

For OpenWrt 24.10+ (APK package manager):

scp -O packages\luci-app-nexora-1.2.0-r1.apk root@192.168.1.1:/tmp/nexora.apk
ssh root@192.168.1.1 "apk add --allow-untrusted --force-overwrite /tmp/nexora.apk && /etc/init.d/rpcd restart && /etc/init.d/nexora restart"

For OpenWrt 19.07 – 23.05 (OPKG package manager):

scp -O packages\luci-app-nexora_1.2.0-1_all.ipk root@192.168.1.1:/tmp/nexora.ipk
ssh root@192.168.1.1 "opkg install --force-depends --force-reinstall --force-overwrite /tmp/nexora.ipk && /etc/init.d/rpcd restart && /etc/init.d/nexora restart"

---

Troubleshooting — If SCP Fails

If scp fails with sftp-server: not found, try one of these alternatives:

Alternative A — GUI file transfer (WinSCP or FileZilla)

1. Install WinSCP (Windows) or FileZilla (any OS).
2. Create a new connection with these settings:
   • Protocol: SCP (not SFTP)
   • Host: 192.168.1.1
   • Username: root
   • Password: your router password
3. Connect and drag the .apk or .ipk file into the /tmp/ directory on the router.

Alternative B — Transfer via Python HTTP server

1. Start a temporary web server on your PC from the Nexora folder:

   python -m http.server 8000

2. SSH into the router and download the package directly:

   ssh root@192.168.1.1
   # Replace YOUR_PC_IP with your computer's local IP address (e.g. 192.168.1.5)
   wget -O /tmp/nexora.apk http://YOUR_PC_IP:8000/packages/luci-app-nexora-1.2.0-r1.apk

Alternative C — Install SFTP support on the router

If your router has internet access and you want standard scp to work permanently:

ssh root@192.168.1.1
opkg update
opkg install openssh-sftp-server

---

Uninstallation

Online (Router has internet access)

SSH into your router and run:

wget -qO- https://raw.githubusercontent.com/jahidulislamzim/Nexora/main/uninstall.sh | sh

Or with curl:

curl -sSL https://raw.githubusercontent.com/jahidulislamzim/Nexora/main/uninstall.sh | sh

From PC via SSH

Linux, macOS, or Git Bash:

./uninstall.sh 192.168.1.1

Windows — double-click: Double-click uninstall.bat in File Explorer.

Windows — PowerShell:

# Prompts for router IP interactively
.\uninstall.ps1

# Or specify the router IP directly
.\uninstall.ps1 192.168.1.1

---

Accessing the Dashboard

Once installed, open your browser and navigate to:

http://192.168.1.1/cgi-bin/luci/admin/network/nexora

Replace 192.168.1.1 with your router's actual IP address if it is different.

You can also access it through the LuCI menu:

LuCI Web Interface  >  Network  >  Nexora

---

License

This project is licensed under the MIT License.

---