Perimeter Security • v0.13.0

Threat Defense & DNS Intelligence

Axonwall implements a multi-layered perimeter security engine combining eBPF XDP volumetric flood mitigation, dynamic nftables IP blocklist & GeoIP sets, an autonomous Unbound RPZ DNS sinkhole, Suricata 7+ IPS, and CrowdSec intrusion defense.

Dynamic Threat Feeds, XDP DDoS Drop & nftables Interval Sets

Traditional firewalls update aliases by reloading thousands of individual packet filter rules, exhausting CPU and causing micro-outages. Axonwall combines Ring-0 Dual-Stack IPv4/IPv6 + 802.1Q/802.1ad QinQ VLAN XDP fast-drop (autonomously dropping external flood source IPs exceeding 50,000 pps or monotonic TTL-bounded blocklist_map / blocklist6_map entries in driver NIC memory before sk_buff allocation) with aggregated intelligence feeds (Spamhaus DROP, AbuseIPDB, FireHOL, Emerging Threats) compiled into high-performance Linux kernel interval sets.

CIDR Normalization & Interval Minimization

Raw threat feeds frequently contain redundant, overlapping, or fragmented IP allocations. Axonwall's feed compiler runs an intelligent normalization algorithm:

  • Syntax Sanitization: Validates IPv4 and IPv6 CIDRs, dropping malformed entries.
  • Subsumption Pruning: Automatically collapses child subnets into parent CIDRs (e.g., 198.51.100.0/24 absorbs 198.51.100.128/25).
  • Contiguous Coalescing: Adjacent matching prefixes are combined into supernets.
Kernel Set Definition
nftables
table inet axonwall {
  # Interval set with auto-merge hardware tree lookup
  set threat_feed_ips {
    type ipv4_addr
    flags interval
    auto-merge
    elements = {
      1.10.16.0/20,
      1.19.0.0/16,
      14.136.0.0/15
    }
  }

  chain prerouting {
    type filter hook prerouting priority -150; policy accept;
    # Instant kernel-level packet drop before conntrack state creation
    ip saddr @threat_feed_ips counter drop
    ip daddr @threat_feed_ips counter drop
  }
}

DNS Sinkhole & Unbound RPZ Compiler

Malware, phishing, and ad-tracking domains are neutralized at the DNS query resolution stage before any TCP/UDP connection can be initialized. Configured under dns.blocklist in /etc/axonwall/services.yaml, Axonwall compiles domain blocklists into native Response Policy Zone (RPZ) format according to RFC 7766.

Subdomain Pruning Optimization

Public blocklists often contain hundreds of thousands of redundant subdomains (e.g. tracker.ads.evil.com alongside evil.com). Axonwall's RPZ compiler prunes these redundant entries, reducing memory consumption by over 65%:

/etc/axonwall/services.yaml — Unbound DNS Blocklist & RPZ Sinkhole
yaml
dns:
  enabled: true
  dnssec: true
  blocklist:
    enabled: true
    refreshIntervalHours: 12
    feeds:
      - name: stevenblack-hosts
        url: https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts
        enabled: true
      - name: urlhaus-rpz
        url: https://urlhaus.abuse.ch/downloads/rpz/
        enabled: true
    allowlistDomains:
      - telemetry.microsoft.com
    customBlockedDomains:
      - malware-c2.com
      - phishing-login.net
/etc/unbound/zones/axonwall-sinkhole.zone
zonefile
$TTL 300
@ IN SOA localhost. hostmaster.axonwall.local. (
  2026101301 ; serial
  3600       ; refresh
  1800       ; retry
  604800     ; expire
  300        ; minimum
)
@ IN NS localhost.

; Strict allowlist overrides (rpz-passthru.)
telemetry.microsoft.com CNAME rpz-passthru.
*.telemetry.microsoft.com CNAME rpz-passthru.

; Sinkholed malware and tracking domains (NXDOMAIN redirect)
malware-c2.com CNAME .
*.malware-c2.com CNAME .
phishing-login.net CNAME .
*.phishing-login.net CNAME .
Unbound Integration
Axonwall configures Unbound with module-config: "respip validator iterator", allowing microsecond local interception without external upstream DNS latency.

Suricata 7+ IPS, CrowdSec & GeoIP (/etc/axonwall/security.yaml)

Suricata 7+ Deep Packet Inspection

Operates in inline IPS or IDS mode utilizing Linux AF_PACKET multi-queue ring buffers with eBPF/XDP hardware bypass. Inspects application payloads, TLS SNI/JA4 fingerprints, and detects protocol anomalies at line-rate.

CrowdSec Community Cyber Defense

Analyzes authentication logs and firewall drop events using behavioral heuristics (SSH brute-force, web port scanning, API credential stuffing) and injects dynamic remediation bans directly into nftables sets.

/etc/axonwall/security.yaml — Suricata IPS, CrowdSec & GeoIP Policy
yaml
suricata:
  enabled: true
  mode: ips
  interfaces:
    - wan
    - lan
  rulesetAutoUpdate: true

crowdsec:
  enabled: true
  bouncerEnabled: true
  banDurationSeconds: 14400
  collections:
    - crowdsecurity/linux
    - crowdsecurity/sshd
    - crowdsecurity/http-cve

geoip:
  enabled: true
  mode: blocklist
  countries:
    - KP
    - IR
  applyToInterfaces:
    - wan
Autonomous AI Tactical Leases & Ring-0 XDP Fast-Drop via MCP
Security operations agents and LLM SecOps workflows can issue both TTL-bounded nftables IP blackhole / DNS sinkhole leases and pre-sk_buff Dual-Stack IPv4/IPv6 + LPM Trie CIDR XDP_DROP bans (mcp_xdp_fast_drop / axonwallctl ebpf xdp-drop) with built-in RFC 1918 & management-session anti-lockout guards through the 25-tool Axonwall MCP server. See /docs/mcp-ai-control for full tool schemas and lease lifecycles.