Blackhole Webserver (OpenWRT)
Blackhole Webserver for OpenWRT is a lightweight, high-performance Go-based utility designed to capture, log, and mirror HTTP requests. It is optimized for deployment on OpenWRT routers (specifically MT6000 and MT3000) for edge tracking, logging, and request mirroring.
Core Functionality
- Catch-all Routing: Responds to all requests regardless of path.
- Request Mirroring: Automatically replicates the requested URL path in a local root directory.
- Paths with extensions (e.g.,
.js,.html) create files. - Paths without extensions create directories.
- Paths with extensions (e.g.,
- Logging: Captures comprehensive request metadata (Method, URL, Headers, IP) in JSON format.
- Response: Always serves a 1x1 transparent tracking GIF.
Technology Stack
- Language: Go (Golang)
- Target OS: Linux (OpenWRT)
- Architecture: ARM64 (MT6000/MT3000)
Development Conventions & Constraints
- Surgical Changes: Always prioritize targeted updates to logic.
- Security: Never log sensitive data or credentials.
- Performance: Keep the binary footprint small and memory usage minimal for router environments.
- Testing Strategy: Local simulation -> Beta deployment via SSH to MT3000 -> Final MT6000 production deployment.
Packaging & CI/CD Heuristics
The build lifecycle includes specific heuristics for compiling Go on OpenWRT, navigating SDK paths, configuring packages non-interactively, and robust OpenWRT Docker CI caching to preserve states (dl, feeds, staging_dir/host, .gocache) across ephemeral CI containers.
🔗 Related Architecture & Knowledge Graph
- Production Systems: Validated in Perimeter Deception and Tarpits, DNS Forge Firefox Addon.
- Governance & Compliance: Governed by Information Security Policy, Incident Response Plan.
- Technical Articles: Deep dive in Zero Trust Edge Routing.
- Applied Research: Investigated in DFIR and Playbooks.
- Master Credentials: Review core competencies on Curriculum Vitae & Master Resume.
- Digital Garden Hub: Return to the main Digital Garden Index.