guard/docs/roadmap/v0.6-http-over-xdp.md
loki5512344 280284667f
docs: per-task roadmap, architecture and changelog
- Split TODO into a thin status index plus docs/roadmap/ with one file per
  task (v0.4 reliability, v0.5 product, v0.6 research, icebox).
- Add docs/architecture.md (current processes, packet/data path, layers,
  storage, metrics) and docs/development.md (rules, gates, DoD).
- Add CHANGELOG.md reconstructed from history; move round details out of
  TODO.
- Align docs with the code: config defaults and missing [detect]/
  [protocol.http] sections, XDP metric names, ClickHouse table and TTL,
  Redis RDB restore, multiarch clang include, CLI binary name.
- Add scripts/check_docs_links.sh and run it in CI.
- release profile: thin LTO + one codegen unit. Binary 12.3 MB -> 9.7 MB,
  http parser bench 314 ns -> 278 ns; panic=abort stays off for
  catch_unwind in the Redis subscriber.
- Drop the unused JWT role claim; fix 'rampart doctor' hints in the CLI.
2026-11-16 14:51:50 +01:00

2.3 KiB
Raw Blame History

v0.6 — HTTP поверх XDP (BPF hook)

Milestone v0.6
Status idea
Priority P1
Depends on v0.4-xdp-ci-harness, v0.5-rst-challenge-ga

Цель

Первый реальный BPF-протокол-хук: разбор начала HTTP-запроса в XDP и rate-limit по L7-признакам до того, как соединение дойдёт до userspace.

Зачем

Сейчас xdp/hooks/hook_api.h — контракт без потребителя, а HTTP-фильтрация происходит только в userspace: под флудом соединений CPU тратится на accept и чтение заголовков. Хук в ядре снимет основную часть нагрузки на дорогие атаки.

Scope

  • Ограниченный парсер: метод, путь, Host, User-Agent — с жёсткими лимитами.
  • Tail-call цепочка из основной программы в hook (без роста сложности universal_filter.c).
  • Политика: drop/rate-limit по пути и User-Agent; конфиг в .rodata.
  • Тесты в netns-стенде + fuzz-цель на тех же байтах, что и userspace-парсер.

Non-goals

  • Полный HTTP-парсер в BPF (TLS, body, chunked).
  • Замена userspace HTTP-плагина: хук — быстрый предфильтр, финальное решение остаётся за ProtocolHandler.

Approach

  1. Прототип отдельной BPF-программы с test_run на сохранённых пакетах.
  2. Сравнить pps/CPU с текущим userspace-путём на deploy/test/stress/.
  3. Только при выигрыше — интегрировать в загрузчик и конфиг.

Критерии приёмки

  • Хук не меняет вердикты userspace-фильтра (property-тесты на одних байтах).
  • Бенчмарк показывает измеримый выигрыш на HTTP-flood.
  • Верификатор проходит на kernel ≥ 5.10, размер программы в лимитах.
  • Фича выключена по умолчанию и не ломает сборку без неё.