guard/docs/testing.md
loki5512344 72c1f45d62
perf: criterion benchmarks for the per-connection hot path
- benches/hot_paths.rs measures RateLimiter::check, Blacklist exact/CIDR/miss
  lookups, SubnetDetector::evaluate over 256 prefixes and HTTP request-head
  validation; `cargo bench --all-features --bench hot_paths`, HTML report in
  target/criterion.
- Dev-machine medians recorded in docs/testing.md (~110 ns rate limit,
  ~70 ns exact ban lookup, ~220 ns CIDR lookup, ~2.6 us detector window,
  ~280 ns HTTP head).
- Makefile `bench` target; the bench is gated on protocol-http.
2026-11-16 12:55:51 +01:00

6.2 KiB
Raw Blame History

Testing - Rampart

Как тестировать: unit, integration, нагрузочное, DDoS simulation.


1. Unit и integration тесты (Rust)

cargo test                    # все тесты
cargo test --test config_parse
cargo test -- --nocapture     # с выводом

Существующие наборы (tests/):

Тест Что покрывает
config_parse Парсинг и валидация единого конфига (src/config)
filter_logic Blacklist, rate limit, geo-фильтры
pow_roundtrip Выдача/решение/проверка PoW challenge
protocol_registry Реестр протокольных плагинов

2. Статический анализ

cargo fmt --all --check
cargo clippy --all-targets --all-features -- -D warnings
cargo deny check

XDP: smoke-check компиляции BPF-программы:

clang -O2 -g -target bpf -c xdp/core/universal_filter.c -o /tmp/universal_filter.o

Функциональные проверки на реальном ядре (нужен root: CAP_BPF + CAP_NET_ADMIN, bpftool, clang, python3):

sudo bash scripts/xdp_ipv6_smoke.sh

Поднимает netns + veth, грузит программу через verifier и проверяет: бан IPv6 и IPv4 (включая короткие UDP-датаграммы), снятие бана, whitelist поверх активного бана, истечение TTL по монотонным часам и udp_policy = "rate-limit" для IPv6 (политика патчится в .rodata до загрузки).

sudo bash scripts/xdp_pkt_test.sh

Проверяет то, что veth-смок поймать не может по построению: Ethernet-паддинг (длина TCP-payload по ip->tot_len), VLAN/QinQ-теги и фрагменты — забаненный источник не должен проходить ни тегированным, ни фрагментированным.

scripts/xdp_netns_smoke.sh дополнительно гоняет реальный бинарь rampart end-to-end (требует hping3).


3. Fuzzing

Внешние парсеры (HTTP request-head и PROXY protocol v2) фаззятся через cargo-fuzz. Нужен nightly-тулчейн и установленный cargo-fuzz:

rustup toolchain install nightly
cargo install cargo-fuzz

# короткий прогон (60 с на цель), как в CI-смоуке
make fuzz

# длительная кампания локально
cargo +nightly fuzz run http_head fuzz/seeds/http_head -- -max_total_time=600
cargo +nightly fuzz run proxy_v2 -- -max_total_time=600

Найденный краш сохраняется в fuzz/artifacts/<target>/; воспроизведение — cargo +nightly fuzz run <target> fuzz/artifacts/<target>/<file>. Цели лежат в fuzz/fuzz_targets/, сиды — в fuzz/seeds/ (каталоги corpus/, artifacts/ в git не попадают).

Инварианты, которые проверяют цели: парсер не паникует на произвольных байтах, scan_head не выходит за буфер, parse_v2_header не потребляет больше переданного и не принимает заголовок выше лимита, семейство адреса совпадает с байтом family.


4. Бенчмарки горячего пути

Микробенчмарки (criterion) для того, что выполняется на каждое соединение:

cargo bench --all-features --bench hot_paths
# HTML-отчёт: target/criterion/report/index.html

Замеряются: RateLimiter::check, exact/CIDR/miss lookup в Blacklist, SubnetDetector::evaluate на окне из 256 префиксов и разбор HTTP request-head. Сравнивай медианы до/после изменения на одной машине; абсолютные числа зависят от CPU. Порядок величин на dev-машине (2 vCPU):

Бенчмарк Медиана
rate_limiter/check ~110 ns
blacklist/is_blocked_exact ~70 ns
blacklist/is_blocked_cidr ~220 ns
subnet_detector/evaluate_256 ~2.6 µs
http_parser/evaluate ~280 ns

5. Локальный integration-стенд (Docker)

bash deploy/test/run_test.sh

Поднимает backend-stub (TCP echo), edge (rampart с config.test.toml) и attacker-контейнер. Сценарии — в deploy/test/README.md.


6. Нагрузочное тестирование

Много-IP TCP flood на VDS (edge-only)

deploy/test/stress/ — полный цикл без Redis/ClickHouse: edge-контейнер с stub-бэкендом (socat echo) + attacker-контейнер со 100 source IP. flood.py шлёт чистые TCP-соединения (connect / slowloris / keepalive), во время флуда параллельно подключаются generic TCP-клиенты (legit.py), замеряющие RTT.

git clone https://github.com/loki5512344ss/guard.git && cd guard
cargo build --release --bin rampart
cd deploy/test/stress && bash run-stress.sh

Фазы: A — сырая пропускная способность (лимиты сняты), B — защита (per-IP rate limit + reputation bans), C — SYN flood hping3, D — активные соединения.

tcpkali / hping3

tcpkali --connections 1000 --connect-rate 5000 --duration 60s EDGE_IP:25565
hping3 -S --flood -p 25565 --rand-source EDGE_IP   # только на свои серверы!

7. Метрики для проверки во время теста

curl -s http://localhost:9090/metrics | grep rampart_
# rampart_connections_total{result="allowed|blocked"}
# rampart_rate_limit_hits
# rampart_pow_challenges_total{result=...}
# rampart_attack_status

Версия: 2.0 | Август 2026