History

CyberMind-FR e7c9411d79 feat: Release v0.8.2 - Admin Control Center, Documentation Mirror & Docker Automation This release adds major new features for SecuBox management and deployment: ## New Features ### 1. LuCI Admin Control Center (luci-app-secubox-admin) - Unified admin dashboard for managing all SecuBox appstore plugins - Control Panel: Real-time stats, system health, alerts, quick actions - Apps Manager: Browse catalog, install/remove apps with search & filtering - App Settings: Per-app configuration, start/stop controls - System Health: Live monitoring (CPU, RAM, disk) with auto-refresh - System Logs: Centralized log viewer with download capability - Fully integrated with existing RPCD backend (luci.secubox) - Mobile-responsive design with polished UI components ### 2. Documentation Mirror in SecuBox Bonus - Integrated complete development documentation into luci-app-secubox-bonus - 64+ documentation files now available offline at /luci-static/secubox/docs/ - Beautiful landing page (index-main.html) with 4 sections: - Development guides & references - Live module demos - Tutorials & blog posts - Marketing campaign pages - Accessible locally on router without internet connection ### 3. Automated Docker Plugin Installation - Enhanced secubox-appstore CLI with full Docker automation - One-click installation from web UI now fully automated: - Auto-detects Docker runtime from catalog - Discovers and executes control scripts (ctl install) - Pulls Docker images automatically - Creates directories and configures UCI - Enables init services - No manual CLI steps required for Docker apps - Works for all Docker apps: AdGuard Home, Mail-in-a-Box, Nextcloud, etc. ### 4. Mail-in-a-Box Plugin - New Docker-based email server plugin (secubox-app-mailinabox) - Complete package with: - UCI configuration (8 port mappings, feature flags) - Control script (mailinaboxctl) with install/check/update/status/logs - Procd init script with auto-restart - Catalog manifest (category: hosting, maturity: beta) - Network mode: host (required for mail server) - Persistent storage: mail, SSL, data, DNS volumes ## Improvements ### Build System - Updated local-build.sh to include luci-app- packages from package/secubox/ - Now automatically discovers and builds luci-app-secubox-admin and similar packages - Fixed Makefile include paths for feed structure ### Package Releases - Incremented PKG_RELEASE for all 31 SecuBox packages - Ensures clean upgrade path from previous versions ### Catalog Updates - Mail-in-a-Box entry moved from "productivity" to "hosting" category - Status changed to "beta" reflecting community Docker image maturity - Storage requirement increased: 1024MB → 2048MB - Added port 25 accessibility note ## Files Changed ### New Packages (2) - package/secubox/luci-app-secubox-admin/ (12 files) - package/secubox/secubox-app-mailinabox/ (4 files) ### Enhanced Packages (1) - package/secubox/luci-app-secubox-bonus/ (65 new docs files) ### Modified Core (3) - package/secubox/secubox-core/root/usr/sbin/secubox-appstore - package/secubox/secubox-core/root/usr/share/secubox/catalog.json - secubox-tools/local-build.sh ### All Makefiles (31 packages) - Incremented PKG_RELEASE for clean upgrade path ## Technical Details Admin Control Center Architecture: - Frontend: 5 views (dashboard, apps, settings, health, logs) - API: Wrapper around luci.secubox RPCD methods - Components: Reusable UI library (cards, badges, alerts, loaders) - Styling: Common + admin-specific CSS with responsive design - Auto-refresh: Polling for live updates (5-30s intervals) Docker Automation Flow: ``` Web UI → RPCD → secubox-appstore CLI → opkg install → ctl install → docker pull → directories → UCI config → init enable → ✓ Ready ``` Access Points:* - Admin Control: http://router/cgi-bin/luci/admin/secubox/admin/ - Documentation: http://router/luci-static/secubox/index-main.html - Demos: http://router/luci-static/secubox/demo-*.html 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>		2026-01-04 08:29:31 +01:00
..
.github/workflows	feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration	2026-01-01 14:59:38 +01:00
htdocs/luci-static/resources	feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration	2026-01-01 14:59:38 +01:00
root	feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration	2026-01-01 14:59:38 +01:00
demo.html	feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration	2026-01-01 14:59:38 +01:00
Makefile	feat: Release v0.8.2 - Admin Control Center, Documentation Mirror & Docker Automation	2026-01-04 08:29:31 +01:00
README.md	feat(structure): reorganize luci-app packages into package/secubox/ + appstore migration	2026-01-01 14:59:38 +01:00

README.md

SecuBox CDN Cache Dashboard

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

Dashboard LuCI pour gérer un proxy cache CDN local sur OpenWrt. Optimisez votre bande passante en cachant le contenu web fréquemment accédé.

🎯 Fonctionnalités

📊 Dashboard temps réel — Statistiques de hit ratio, économies de bande passante
💾 Gestion du cache — Visualisation des objets en cache, purge sélective
📋 Policies configurables — Règles par domaine, extension, durée
📈 Graphiques statistiques — Évolution du hit ratio et des économies
🔧 Maintenance — Purge, préchargement, logs, redémarrage
⚙️ Configuration complète — Taille cache, port, mode transparent

📦 Installation

Depuis les packages SecuBox

opkg update
opkg install luci-app-cdn-cache

Compilation manuelle

# Cloner dans le SDK OpenWrt
git clone https://github.com/gkerma/luci-app-cdn-cache.git package/luci-app-cdn-cache

# Compiler
make package/luci-app-cdn-cache/compile V=s

🔧 Configuration

Via LuCI

Accéder à Services → CDN Cache → Settings
Configurer la taille du cache, le port et les policies
Activer le service

Via UCI

# Activer le service
uci set cdn-cache.main.enabled=1
uci set cdn-cache.main.cache_size=2048
uci set cdn-cache.main.listen_port=3128
uci commit cdn-cache

# Redémarrer
/etc/init.d/cdn-cache restart

Configuration client

Configurez vos appareils pour utiliser le proxy :

Proxy HTTP: 192.168.1.1:3128

Ou utilisez le mode transparent avec des règles iptables.

📊 Policies de Cache

Les policies définissent quoi cacher et pour combien de temps :

Policy	Domaines	Extensions	Durée
Windows Update	windowsupdate.com, download.microsoft.com	exe, msu, cab	7 jours
Linux Repos	archive.ubuntu.com, deb.debian.org	deb, rpm	3 jours
Static Content	*	js, css, png, jpg, woff	1 jour

🚫 Exclusions

Certains domaines ne doivent jamais être cachés :

Sites bancaires — Sécurité
Streaming vidéo — Contenu temps réel
APIs dynamiques — Données changeantes

📁 Structure du Package

luci-app-cdn-cache/
├── Makefile
├── htdocs/luci-static/resources/
│   ├── view/cdn-cache/
│   │   ├── overview.js        # Dashboard principal
│   │   ├── cache.js           # Gestion du cache
│   │   ├── policies.js        # Configuration policies
│   │   ├── statistics.js      # Graphiques stats
│   │   ├── maintenance.js     # Outils maintenance
│   │   └── settings.js        # Configuration
│   └── cdn-cache/
│       ├── api.js             # API RPC
│       └── dashboard.css      # Styles
└── root/
    ├── etc/
    │   ├── config/cdn-cache   # Configuration UCI
    │   └── init.d/cdn-cache   # Script init
    └── usr/
        ├── libexec/rpcd/cdn-cache  # Backend RPCD
        └── share/
            ├── luci/menu.d/   # Menu LuCI
            └── rpcd/acl.d/    # ACL

🔗 API RPCD

Méthode	Description
`status`	État du service
`stats`	Statistiques globales
`cache_list`	Liste des objets en cache
`top_domains`	Top domaines par usage
`bandwidth_savings`	Économies de bande passante
`purge_cache`	Vider tout le cache
`purge_domain`	Vider cache d'un domaine
`preload_url`	Précharger une URL

🔧 Dépendances

luci-base — Framework LuCI
nginx-ssl — Serveur proxy
rpcd — Daemon RPC
coreutils-stat — Utilitaires

📈 Performances

Avec une configuration optimale :

Hit ratio : 60-80% typique
Économies : 40-60% de bande passante
Latence : < 1ms pour les hits