English | 简体中文

LuCI Bandix is a network traffic monitoring application for OpenWrt, providing intuitive traffic data visualization and analysis through the LuCI web interface.

LuCI Bandix is developed based on the LuCI framework, offering network traffic monitoring capabilities for OpenWrt routers. This application depends on the openwrt-bandix backend service and helps users view and analyze network traffic statistics in real-time.

Note: This application is primarily designed for home users and simple network environments. It is not recommended for complex network architectures (such as VLAN) or enterprise-level deployments.

• OpenWrt Version: Recommended OpenWrt 24.10 and above
• Package Format Support: Supports APK and IPK package formats

• Real-time network traffic monitoring
• Intuitive data visualization interface
• Seamless integration with OpenWrt system
• Automatically obtain the host name from DHCP/DNS (Static Leases)
• High-performance implementation based on Rust eBPF
• Support for LAN/WAN speed monitoring
• Support device TCP/UDP connection number monitoring
• Support for WAN speed limitation
• Support IPv4/IPv6
• Persistent data storage
• Historical traffic trends and charts

luci-app-bandix requires the following dependency packages:

• curl: HTTP client library for network requests
• luci-lib-jsonc: JSON parsing library for data processing

These dependencies will be automatically installed when installing luci-app-bandix, but some firmware may require manual installation of these dependency packages.

The following table shows the version dependency relationship between luci-app-bandix and openwrt-bandix:

Please ensure you install matching versions to ensure compatibility and proper functionality.

1. First install the openwrt-bandix backend

   Download the appropriate package for your device from openwrt-bandix Releases, then install:

   opkg install bandix_latest_architecture.ipk  # (or apk add --allow-untrusted bandix_latest_architecture.apk)

2. Install the luci-app-bandix frontend

   Download the package from luci-app-bandix Releases, then install:

   opkg install luci-app-bandix_latest_all.ipk  # (or apk add --allow-untrusted luci-app-bandix_latest_all.apk)

3. Configure your LAN interface in settings

   After installation, you can access the Bandix application through the LuCI web interface under the "Network" menu. Go to the Bandix settings page and select your LAN interface to enable proper monitoring. Make sure to check the "Enable" option to start the service.

When the persistence cycle is set too large (e.g., 1 hour, 10 hours, etc.), the rpcd service may crash on some devices, making it impossible to access the router's management interface via web. The system may display password error messages.

Solution: Access the terminal via SSH, reinstall bandix, and execute service rpcd restart. Also, set a smaller persistence cycle (e.g., 10 minutes).

• timsaya

This project is licensed under the Apache 2.0 License.

Issue reports and improvement suggestions are welcome! Please participate through GitHub Issues or Pull Requests.