boba/guard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
guard/docs/kb/README.md
loki5512344 15f474486a
feat!: universal redesign — drop Minecraft stack, single-crate architecture 
- remove Java plugins (velocity/paper), dashboard, all MC-specific code
  (handshake, death_code, varint, hostname-HMAC); available in history pre-v0.2
- merge crates/* into one package with src/bin/{rampart,rampart-manager,rampart-cli}
- ProtocolHandler trait + registry (no implementations yet), universal PoW kept
- XDP: universal L3/L4 filter (xdp/core/) + pluggable hook API (xdp/hooks/),
  fix IPv6 saddr bug; clang build verified
- docs: bilingual knowledge base (docs/kb/: attacks x4, defense-levels,
  practice x3), rewrite README/architecture for universal concept
- TODO.md v4.0: <=300-line module limit, competitor benchmark section (ref/)
- deploy/CI/docs cleanup: no MC references, new binary names

cargo build/clippy(-D warnings)/test green (55 tests)
2026-08-24 01:50:22 +02:00

3.4 KiB
Raw Blame History

Rampart Knowledge Base

Теоретическая база и практика защиты от DDoS, на которой построена платформа. Статьи двуязычные: в каждой есть разделы ## English и ## Русский.

English

Attacks — how they work

  • SYN Flood — the classic TCP half-open exhaustion attack; backlog mechanics, why one packet costs the server memory.
  • HTTP Flood — application-layer floods with syntactically perfect requests; why L3/L4 defense is powerless.
  • Slowloris & Slow Attacks — exhausting connection slots with connections that never finish; no bandwidth needed.
  • UDP Amplification — reflection and amplification factors; DNS/NTP/Memcached abuse.

Defense fundamentals

  • Defense Levels — where to filter a packet: kernel (XDP) vs userspace trade-offs, full packet path through the Linux stack, and why Rampart uses hybrid kernel fast-path + userspace smart-path.

Practice

  • Kernel Tuning — sysctl parameters that matter under flood (tcp_max_syn_backlog, somaxconn, backlog queues), ready-to-adapt config.
  • NIC Tuning — ring buffers, IRQ affinity, offloads, RPS/XPS for high pps workloads.
  • Stress Testing — methodology and tooling for load/attack simulation against your own infra.

Русский

Атаки — как они работают

  • SYN Flood — классическая атака на полуоткрытые соединения; механика backlog'а, почему один пакет стоит серверу памяти.
  • HTTP Flood — L7-флуд синтаксически корректными запросами; почему защита уровня L3/L4 бессильна.
  • Slowloris и медленные атаки — исчерпание слотов соединений соединениями, которые никогда не завершаются; полоса не нужна.
  • UDP-амплификация — рефлексия и коэффициенты усиления; злоупотребление DNS/NTP/Memcached.

Основы защиты

  • Уровни фильтрации — где дропать пакет: компромиссы ядра (XDP) и userspace, полный путь пакета через сетевой стек Linux и почему Rampart использует гибрид kernel fast-path + userspace smart-path.

Практика

  • Тюнинг ядра — значимые под флудом параметры sysctl (tcp_max_syn_backlog, somaxconn, очереди), готовый конфиг для адаптации.
  • Тюнинг NIC — ring buffers, привязка прерываний, offload'ы, RPS/XPS для высоких pps.
  • Стресс-тестирование — методика и инструменты нагрузочной/атакующей симуляции на своей инфраструктуре.