CyberMind-FR 31a87c5d7a feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration

Major structural reorganization and feature additions:

## Folder Reorganization
- Move 17 luci-app-* packages to package/secubox/ (except luci-app-secubox core hub)
- Update all tooling to support new structure:
  - secubox-tools/quick-deploy.sh: search both locations
  - secubox-tools/validate-modules.sh: validate both directories
  - secubox-tools/fix-permissions.sh: fix permissions in both locations
  - .github/workflows/test-validate.yml: build from both paths
- Update README.md links to new package/secubox/ paths

## AppStore Migration (Complete)
- Add catalog entries for all remaining luci-app packages:
  - network-tweaks.json: Network optimization tools
  - secubox-bonus.json: Documentation & demos hub
- Total: 24 apps in AppStore catalog (22 existing + 2 new)
- New category: 'documentation' for docs/demos/tutorials

## VHost Manager v2.0 Enhancements
- Add profile activation system for Internal Services and Redirects
- Implement createVHost() API wrapper for template-based deployment
- Fix Virtual Hosts view rendering with proper LuCI patterns
- Fix RPCD backend shell script errors (remove invalid local declarations)
- Extend backend validation for nginx return directives (redirect support)
- Add section_id parameter for named VHost profiles
- Add Remove button to Redirects page for feature parity
- Update README to v2.0 with comprehensive feature documentation

## Network Tweaks Dashboard
- Close button added to component details modal

Files changed: 340+ (336 renames with preserved git history)
Packages affected: 19 luci-app, 2 secubox-app, 1 theme, 4 tools

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-01-01 14:59:38 +01:00

6.9 KiB

Raw Blame History

LuCI WireGuard Dashboard

Version: 0.4.0
Last Updated: 2025-12-28
Status: Active

Modern and intuitive dashboard for WireGuard VPN monitoring on OpenWrt. Visualize tunnels, peers, and traffic in real-time.

Features

🔐 Tunnel Status

Real-time interface monitoring
Public key display
Listen port and MTU info
Interface state (up/down)

👥 Peer Management

Active/idle/inactive status
Endpoint tracking
Last handshake time
Allowed IPs display
Preshared key indicator

📊 Traffic Statistics

Per-peer RX/TX bytes
Per-interface totals
Combined traffic view
Visual progress bars

⚙️ Configuration View

WireGuard config syntax display
Interface and peer sections
Tunnel visualization
UCI integration info

🎨 Modern Interface

Cyan/blue VPN tunnel theme
Animated status indicators
Responsive grid layout
Real-time updates

Screenshots

Status Overview

Peers List

Traffic Statistics

Configuration

Installation

Prerequisites

OpenWrt 21.02 or later
WireGuard installed (kmod-wireguard, wireguard-tools)
LuCI web interface

# Install WireGuard
opkg update
opkg install kmod-wireguard wireguard-tools luci-proto-wireguard

From Source

# Clone into OpenWrt build environment
cd ~/openwrt/feeds/luci/applications/
git clone https://github.com/gkerma/luci-app-wireguard-dashboard.git

# Update feeds and install
cd ~/openwrt
./scripts/feeds update -a
./scripts/feeds install -a

# Enable in menuconfig
make menuconfig
# Navigate to: LuCI > Applications > luci-app-wireguard-dashboard

# Build package
make package/luci-app-wireguard-dashboard/compile V=s

Manual Installation

# Transfer package to router
scp luci-app-wireguard-dashboard_1.0.0-1_all.ipk root@192.168.1.1:/tmp/

# Install on router
ssh root@192.168.1.1
opkg install /tmp/luci-app-wireguard-dashboard_1.0.0-1_all.ipk

# Restart services
/etc/init.d/rpcd restart

Usage

After installation, access the dashboard at:

VPN → WireGuard Dashboard

The dashboard has four tabs:

Status: Overview with interfaces and active peers
Peers: Detailed peer information and status
Traffic: Bandwidth statistics per peer/interface
Configuration: Config file view and tunnel visualization

Architecture

┌─────────────────────────────────────────────────────────┐
│                    LuCI JavaScript                       │
│          (status.js, peers.js, traffic.js)              │
└───────────────────────────┬─────────────────────────────┘
                            │ ubus RPC
                            ▼
┌─────────────────────────────────────────────────────────┐
│                    RPCD Backend                          │
│           /usr/libexec/rpcd/wireguard-dashboard         │
└───────────────────────────┬─────────────────────────────┘
                            │ executes
                            ▼
┌─────────────────────────────────────────────────────────┐
│                     wg show                              │
│                  WireGuard CLI Tool                      │
└───────────────────────────┬─────────────────────────────┘
                            │ manages
                            ▼
┌─────────────────────────────────────────────────────────┐
│                   WireGuard Kernel Module                │
│                    Encrypted Tunnels                     │
└─────────────────────────────────────────────────────────┘

API Endpoints

Method	Description
`status`	Overall VPN status, interface/peer counts, total traffic
`interfaces`	Detailed interface info (pubkey, port, IPs, state)
`peers`	All peers with endpoint, handshake, traffic, allowed IPs
`traffic`	Per-peer and per-interface RX/TX statistics
`config`	Configuration display (no private keys exposed)

Peer Status Indicators

Status	Meaning	Handshake Age
🟢 Active	Recent communication	< 3 minutes
🟡 Idle	No recent traffic	3-10 minutes
⚪ Inactive	No handshake	> 10 minutes or never

Requirements

OpenWrt 21.02+
kmod-wireguard (kernel module)
wireguard-tools (wg command)
luci-proto-wireguard (optional, for LuCI config)
LuCI (luci-base)
rpcd with luci module

Dependencies

luci-base
luci-lib-jsonc
rpcd
rpcd-mod-luci
wireguard-tools

Security Notes

Private keys are never exposed through the dashboard
Only public keys and configuration are displayed
All data is read-only (no config modifications)
RPCD ACLs restrict access to authorized users

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Credits

Powered by WireGuard®
Built for OpenWrt
Developed by Gandalf @ CyberMind.fr

luci-proto-wireguard - WireGuard protocol support
wg-easy - Web UI for WireGuard
wireguard-ui - Another WireGuard UI

Made with 🔐 for secure networking

WireGuard is a registered trademark of Jason A. Donenfeld.

6.9 KiB Raw Blame History