History

CyberMind-FR 62f2f6a7a8 docs(secubox): Add KISS README for all 46 remaining packages Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>		2026-02-03 07:34:06 +01:00
..
files
Makefile	feat: Dashboard reorganization and auth security fixes	2026-01-14 09:32:14 +01:00
README.md	docs(secubox): Add KISS README for all 46 remaining packages	2026-02-03 07:34:06 +01:00

README.md

NodogSplash - Captive Portal

Lightweight captive portal solution for OpenWrt. Provides a customizable splash page with click-through or credential-based authentication for guest network access control.

Installation

opkg install secubox-app-nodogsplash

Configuration

Main config: /etc/nodogsplash/nodogsplash.conf

Key options:

GatewayInterface br-lan
GatewayAddress 192.168.1.1
MaxClients 250
SessionTimeout 1440

Binaries

Binary	Description
`/usr/bin/nodogsplash`	Captive portal daemon
`/usr/bin/ndsctl`	Runtime control tool

Usage

# Service management
/etc/init.d/nodogsplash start
/etc/init.d/nodogsplash stop

# Runtime control
ndsctl status          # Show portal status
ndsctl clients         # List connected clients
ndsctl auth <mac>      # Authorize a client
ndsctl deauth <mac>    # Deauthorize a client

Customization

Splash page templates are in /etc/nodogsplash/htdocs/. Edit splash.html to customize the portal appearance.

Dependencies

libmicrohttpd
libjson-c
iptables-nft

License

GPL-2.0