guard/docs/research/README.md
loki5512344 918e561a61
feat(xdp): IPv6 UDP rate limit, working loader; English JavaDoc comments
XDP behaviour:
- udp_rate_limit6 (LRU, 128-bit source key) + throttle_hit6, so
  udp_policy = "rate-limit" now applies to native IPv6 as well.
- scripts/xdp_ipv6_smoke.sh: phase 4 patches .rodata before load and
  verifies policy=2 on a real kernel (3 pass / 3 rate-limited).

XDP loader (was completely broken, never reached the verifier):
- .rodata is now one struct rampart_config with frozen offsets enforced by
  _Static_assert; XdpGlobals is #[repr(C)] and the image is built with
  offset_of!. Previously a 96-byte image was written into a 76-byte map at
  offsets clang had reordered, so load() failed with EINVAL.
- patch_rodata fails loudly when the map size and the image size diverge.
- build.rs tracks xdp/core and xdp/hooks, not just universal_filter.c.
- build_ringbuf looked for "events_map"; the map is "events_ringbuf".
- tests/xdp_object_maps.rs: verifies map names and .rodata size without root;
  the real binary was confirmed to attach in a netns.

Docs and style:
- Code comments are English, JavaDoc/Rustdoc style, without emoji or
  decorative banners (new project rule, TODO §0.8).
- README rewritten bilingual: Russian first, English below, TOC and
  copy-paste quick start.
- docs/README.md: documentation index and maintenance rules;
  configuration.md documents the whole [xdp] section and IPv4/IPv6 coverage;
  testing.md describes the real-kernel smoke; stale research links removed.
2026-11-15 23:44:07 +01:00

3 KiB
Raw Blame History

Rampart - Research & Deep Dives

Это исследовательская документация. Здесь живут глубокие разборы технологий, эксперименты и идеи для версий v0.4+.

Для текущей архитектуры (v0.1-v0.3) смотри ARCHITECTURE.md в корне репо.


Структура

Файл Что внутри Актуально с
architecture.md Общая архитектура, компоненты, схемы C4 v0.1
ddos.md Векторы атак L3/L4/L7, методы защиты, AI-боты v0.1
ebpf.md XDP/eBPF фильтр, BPF maps, ringbuf, verifier v0.4
rust-performance.md Zero-copy, io_uring, SO_REUSEPORT, NUMA, profiling v0.3
io_uring.md Объединено с rust-performance.md v0.4
haproxy.md HAProxy конфиг, mTLS, замена на Rust LB v0.2
envoy.md EWMA балансировка, Circuit Breaker, xDS API v0.5
observability.md Prometheus, OpenTelemetry, ClickHouse, Parca v0.3
anti-bot.md Sonar, challenge системы, AI-обходы, fingerprint v0.2
benchmark.md Инструменты, методология, ожидаемые результаты v0.3
security.md STRIDE, mTLS, Zero Trust, supply chain v0.2
networking.md WireGuard, BGP Anycast, QUIC, MTU v0.3
papers.md Ссылки на статьи, RFC, проекты для изучения -

Как читать

Хочу написать первую версию (v0.1)
  → architecture.md + ddos.md
Хочу добавить защиту от ботов
  → anti-bot.md

Хочу выжать максимум производительности
  → rust-performance.md + io_uring.md + ebpf.md

Хочу настроить мониторинг
  → observability.md

Хочу понять безопасность системы
  → security.md + networking.md

Операционные документы (корень docs/)

Файл Описание
deployment.md Пошаговый деплой
configuration.md Примеры конфигов
vds_compatibility.md Таблица провайдеров
disaster_recovery.md Failover сценарии
runbook.md Инструкции для админа
api.md REST API спецификация
testing.md Методология тестирования
troubleshooting.md FAQ

Версия: 0.5-research | Июль 2026