How horatioconkerhead/gatecrash works
Gatecrash is a Linux appliance for selectively routing chosen LAN devices through WireGuard using bidirectional ARP spoofing. The user configures a tunnel, discovers and saves devices, enables targets, and starts interception from the web UI; the app tracks device IP changes and applies target-rule updates. The graph also preserves monitoring, TLS, and configuration capabilities. Shell runtime details are limited to README documentation and references in sampled source; unsampled app routes are represented at the app boundary.
Main entry points: app.py Web UI and API · targets.py Target rule manager · config.py Appliance config · devices.py Saved device resolver
Components 18
Web control plane
- Web UI and API
webui/app.py - UI template
webui/templates/index.html - Settings store
webui/settings.py - TLS certificates
webui/tls.py - Input validation
webui/validators.py
Device management
- Saved device resolver
webui/devices.py - Network output parsers
webui/parsing.py
Traffic routing
- Appliance config
webui/config.py - Target rule manager
webui/targets.py - Routing lifecycle
start.sh
Appliance services
- Network command helpers
webui/netutils.py - System statistics
webui/stats.py
Other components
- LAN administrator
- Web browser
- WireGuard provider
- LAN devices
- Linux networking
- System service manager
Connections 24
- LAN administrator → Web browser: configures through
readme.md - Web browser → Web UI and API: uses
readme.md - Web UI and API → UI template: serves UI
readme.md - Web UI and API → Input validation: validates with
webui/app.py - Web UI and API → Settings store: uses
webui/app.py - Web UI and API → TLS certificates: uses
webui/app.py - Web UI and API → Appliance config: reads and writes
webui/app.py - Web UI and API → Saved device resolver: manages devices
webui/app.py - Web UI and API → Target rule manager: applies target changes
webui/targets.py - Web UI and API → System statistics: collects status
webui/app.py - Saved device resolver → Network command helpers: runs network commands
webui/devices.py - Saved device resolver → Network output parsers: parses neighbor data
webui/devices.py - Saved device resolver → Appliance config: updates target config
webui/devices.py - Appliance config → Network command helpers: queries network
webui/config.py - Appliance config → Input validation: validates config
webui/config.py - Target rule manager → Appliance config: reads settings
webui/targets.py - Target rule manager → Network command helpers: detects gateway
webui/targets.py - Target rule manager → Input validation: validates targets
webui/targets.py - Target rule manager → Linux networking: installs rules and spoofing
webui/targets.py - Routing lifecycle → Linux networking: configures forwarding
readme.md - Routing lifecycle → WireGuard provider: routes targets through
readme.md - LAN devices → Routing lifecycle: traffic intercepted
readme.md - Web UI and API → System service manager: starts and stops service
webui/app.py - Web UI and API → Linux networking: samples system metrics