How techarohq/anubis works
Anubis is a web firewall that evaluates incoming requests against bot policy and, when needed, requires a browser challenge before allowing traffic to reach protected upstream resources. The main executable configures and starts the server; policy evaluation, challenge handling, and challenge-page code represent distinct runtime stages. The README documents the product flow, while sampled source confirms selected wiring. Several listed core modules and integrations were not sampled, so uncertain connections are omitted.
Main entry points: anubis.go Request gateway · main.ts Browser challenge app · policy.go Bot policy · index.ts Proof algorithms
Components 20
Firewall runtime
- Anubis executable
cmd/anubis/main.go - Request gateway
lib/anubis.go - Naive honeypot
internal/honeypot/naive/naive.go
Policy and state
- Bot policy
lib/policy/policy.go - Policy configuration
lib/config/config.go - State store
lib/store/interface.go
Challenge experience
- Challenge handling
lib/challenge/challenge.go - Challenge page
web/index.go - Browser challenge app
web/js/main.ts - Proof algorithms
web/js/algorithms/index.ts - Fast algorithm
web/js/algorithms/fast.ts - WASM algorithm
web/js/algorithms/wasm.ts - Fetch backoff
web/js/lib/backoff.ts - WASM proof runtime
wasm/wasm.go - Challenge UI helpers
lib/challenge/preact/js/xeact.js
Operations and integrations
- DNSBL checks
internal/dnsbl/dnsbl.go - Robots policy converter
cmd/robots2policy/main.go - Windows service setup
cmd/anubis/service_windows.go
Other components
- Browser visitor
- Protected upstream
Connections 17
- Browser visitor → Request gateway: sends requests
README.md - Anubis executable → Request gateway: creates server
cmd/anubis/main.go - Request gateway → Bot policy: checks policy
- Request gateway → Challenge handling: issues challenges
- Request gateway → DNSBL checks: checks reputation
lib/anubis.go - Bot policy → Policy configuration: loads settings
lib/policy/policy.go - Bot policy → State store: builds backend
lib/policy/policy.go - Challenge handling → Challenge page: renders page
- Challenge page → Browser challenge app: loads app
- Browser challenge app → Proof algorithms: selects algorithm
web/js/main.ts - Browser challenge app → Fetch backoff: fetches with retry
web/js/main.ts - Proof algorithms → Fast algorithm: exports algorithm
web/js/algorithms/index.ts - Proof algorithms → WASM algorithm: exports algorithm
web/js/algorithms/index.ts - WASM algorithm → WASM proof runtime: uses WASM
- Browser challenge app → Request gateway: submits response
web/js/main.ts - Request gateway → Protected upstream: forwards allowed traffic
README.md - Robots policy converter → Policy configuration: generates policy
cmd/robots2policy/main.go