boba/guard
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
guard/docs/research
History
loki5512344 15f474486a
feat!: universal redesign — drop Minecraft stack, single-crate architecture 
- remove Java plugins (velocity/paper), dashboard, all MC-specific code
  (handshake, death_code, varint, hostname-HMAC); available in history pre-v0.2
- merge crates/* into one package with src/bin/{rampart,rampart-manager,rampart-cli}
- ProtocolHandler trait + registry (no implementations yet), universal PoW kept
- XDP: universal L3/L4 filter (xdp/core/) + pluggable hook API (xdp/hooks/),
  fix IPv6 saddr bug; clang build verified
- docs: bilingual knowledge base (docs/kb/: attacks x4, defense-levels,
  practice x3), rewrite README/architecture for universal concept
- TODO.md v4.0: <=300-line module limit, competitor benchmark section (ref/)
- deploy/CI/docs cleanup: no MC references, new binary names

cargo build/clippy(-D warnings)/test green (55 tests)
2026-08-24 01:50:22 +02: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 Initial commit: Rampart v0.2.0 2026-07-20 20:53:32 +02: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

README.md

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
minecraft-protocol.md Handshake парсинг, VarInt, Forge, fingerprinting v0.1
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 + minecraft-protocol.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
migration.md Обновление версий

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