- 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.
2.3 KiB
2.3 KiB
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
- Прототип отдельной BPF-программы с
test_runна сохранённых пакетах. - Сравнить pps/CPU с текущим userspace-путём на
deploy/test/stress/. - Только при выигрыше — интегрировать в загрузчик и конфиг.
Критерии приёмки
- Хук не меняет вердикты userspace-фильтра (property-тесты на одних байтах).
- Бенчмарк показывает измеримый выигрыш на HTTP-flood.
- Верификатор проходит на kernel ≥ 5.10, размер программы в лимитах.
- Фича выключена по умолчанию и не ломает сборку без неё.