How d80y6/yemenantiddos works
YemenAntiDDoS is a distributed DDoS detection and response platform. Nodes observe traffic through XDP/eBPF, flow receivers, and Layer 7 inspection, then stream telemetry to the Controller. The Controller ingests node data, detects attacks using thresholds and learned baselines, and dispatches mitigation actions; operators configure and review the system through the Vue console. The README documents capabilities such as inline scrubbing, BGP Flowspec, and connector integrations, but their detailed internal wiring is not fully sampled, so those links are omitted where unverified.
Main entry points: main.go Node Runtime · engine.go Response Engine · postgres.go TimescaleDB · grpc_handler.go gRPC Ingestion
Components 24
Node Sensors
- Node Runtime
node/main.go - XDP Capture
node/bpf/xsight.c - Flow Collection
node/internal/flow/listener.go - Packet Sampling
node/internal/sampler/sampler.go - L7 Inspection
node/internal/l7collector/collector.go - Node Reporter
node/internal/reporter/reporter.go
Controller Plane
- gRPC Ingestion
controller/internal/ingestion/grpc_handler.go - Telemetry Writers
controller/internal/ingestion/db_writer.go - Detection Engine
controller/internal/engine/threshold/detector.go - Baseline Detection
controller/internal/engine/baseline/calculator.go - Attack Tracking
controller/internal/tracker/tracker.go - Response Engine
controller/internal/action/engine.go - HTTP API
controller/internal/api/router.go - TimescaleDB
controller/internal/store/postgres/postgres.go
Operator Console
- Console Application
controller/console/src/main.ts - Console Routes
controller/console/src/router.ts - Console Shell
controller/console/src/components/Shell.vue - Console API Client
controller/console/src/api/client.ts - Attack Views
controller/console/src/views/attacks/AttackDetail.vue - Operations Views
controller/console/src/views/overview/Overview.vue
Mitigation Integrations
- BGP Speaker
controller/internal/bgp/gobgp.go - Inline BPF Rules
node/internal/bpf/inline.go - Webhook, xDrop
controller/internal/action/webhook.go
Other components
- Operator
Connections 25
- Node Runtime → XDP Capture: attaches XDP
node/main.go - Node Runtime → Flow Collection: starts collection
- Node Runtime → Packet Sampling: starts sampler
node/main.go - Node Runtime → L7 Inspection: starts inspection
- Node Runtime → Node Reporter: starts reporter
node/main.go - Node Reporter → gRPC Ingestion: streams telemetry
README.md - gRPC Ingestion → Telemetry Writers: submits samples
controller/internal/ingestion/grpc_handler.go - gRPC Ingestion → TimescaleDB: reads node records
controller/internal/ingestion/grpc_handler.go - Telemetry Writers → TimescaleDB: writes telemetry
- Detection Engine → Attack Tracking: raises detections
- Baseline Detection → Attack Tracking: raises deviations
- Attack Tracking → Response Engine: dispatches events
controller/internal/action/engine.go - Response Engine → TimescaleDB: loads action state
controller/internal/action/engine.go - Response Engine → BGP Speaker: announces routes
controller/internal/action/engine.go - Response Engine → Webhook, xDrop: executes responses
- Operator → Console Application: uses
README.md - Console Application → Console Routes: installs router
controller/console/src/main.ts - Console Application → Console Shell: mounts application
- Console Routes → Attack Views: routes attacks
controller/console/src/router.ts - Console Routes → Operations Views: routes overview
controller/console/src/router.ts - Attack Views → Console API Client: requests data
controller/console/src/views/attacks/AttackDetail.vue - Operations Views → Console API Client: requests data
- Console API Client → HTTP API: sends HTTP requests
- HTTP API → TimescaleDB: serves stored data
- Response Engine → Inline BPF Rules: pushes inline rules