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

46 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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, размер программы в лимитах.
- [ ] Фича выключена по умолчанию и не ломает сборку без неё.