guard/docs/testing.md
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

3.5 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-датаграммы), снятие бана, истечение TTL по монотонным часам и udp_policy = "rate-limit" для IPv6 (политика патчится в .rodata до загрузки). scripts/xdp_netns_smoke.sh дополнительно гоняет реальный бинарь rampart end-to-end (требует hping3).


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

bash deploy/test/run_test.sh

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


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

Много-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   # только на свои серверы!

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

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