guard/docs/research
loki5512344 a8a3057719
feat(xdp): IPv6 UDP rate limit, working loader; English comments and docs
XDP behaviour:
- udp_rate_limit6 (LRU, full 128-bit source key) plus throttle_hit6, so
  udp_policy = "rate-limit" 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).

Loader (XDP could never load before this):
- .rodata is one struct rampart_config with frozen offsets enforced by
  _Static_assert; XdpGlobals is #[repr(C)] and the image is built with
  offset_of!. Before, 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 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 checks map names and .rodata size without root.

Docs and style:
- Code comments are English, JavaDoc/Rustdoc style, without emoji or
  banners (new project rule, TODO §0.8).
- README rewritten bilingual: Russian first, English below, nav buttons,
  compact 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 covers the real-kernel smoke; stale links removed.
2026-11-15 23:50:52 +01:00
..
anti-bot.md v0.3: 6-layer architecture complete 2026-07-21 15:47:36 +02:00
architecture.md feat!: universal redesign — drop Minecraft stack, single-crate architecture 2026-08-24 01:50:22 +02:00
benchmark.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
ddos.md v0.3: 6-layer architecture complete 2026-07-21 15:47:36 +02:00
ebpf.md v0.3: 6-layer architecture complete 2026-07-21 15:47:36 +02:00
envoy.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
haproxy.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
io_uring.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
load-test-report.md feat: VDS stress test harness (edge-only) and load-test results 2026-08-04 19:16:27 +02:00
networking.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
observability.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
papers.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
README.md feat(xdp): IPv6 UDP rate limit, working loader; English comments and docs 2026-11-15 23:50:52 +01:00
rust-performance.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00
security.md Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02:00

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