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.
3 KiB
3 KiB
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