The gateway already refused to ban addresses from proxy_protocol.trusted_cidrs, but the traffic-intelligence auto-ban and the subnet monitor still did, so a trusted load balancer living inside a banned /24 (or below the reputation threshold) could be knocked out together with its clients. - TrustedProxyCidr moved to src/config/trusted.rs (the edge section file hit the 250-line gate) and gained `overlaps_prefix`: a ban is suppressed when the banned prefix intersects a trusted network. - TrafficHook::with_trusted suppresses reputation and offender bans; its ban() now reports whether the ban was installed so `ban_offenders` counts real bans. - The subnet monitor takes a MonitorSetup bundle (spawn had 8 arguments) and suppresses both userspace CIDR bans and XDP prefix bans that overlap a trusted network, logging a warning instead. - IPv4-mapped addresses are normalised in `contains` too. - Tests: overlap maths (v4/v6, /0 rejected), tracker suppression vs unrelated networks, and auto-ban skipping a trusted range while still banning public offenders.
36 KiB
Rampart — Development TODO & Roadmap
Живой документ. Философия: KISS → DRY → SOLID → YAGNI.
v0.3.0-dev — big-bang редизайн: из Minecraft-специфичной защиты в универсальную L3/L4/L7 платформу сетевой защиты. MC-код, Java-плагины и dashboard удалены (доступны в git-истории до тега v0.2.0).
0. Принципы разработки
KISS
- Не добавляй абстракцию до третьего повторения.
- Функция ≤ 60 строк, файл ≤ 250 строк, ≤ 4 .rs-файлов на папку (жёсткий лимит;
больше — декомпозиция или группировка доменами с ре-экспортами в mod.rs).
Гейт:
scripts/check_module_size.sh+ ratchet-базлайн.module_size_baseline(легаси — WARN, новые нарушения — FAIL; после рефакторинга--update-baseline). - Не используй generics где хватит
&strиVec<u8>.
DRY
- Повтор > 2 раз → выноси, но лучше копипаста чем неправильная абстракция.
SOLID (Rust)
- S: один файл = одна ответственность
- O: расширяй через трейты (
ProtocolHandler,Filter,StateStore) - L:
dyn Filter— любая реализация без side effects - I: маленькие трейты вместо одного God-trait
- D: core зависит от trait-ов, не от Redis/ClickHouse напрямую
YAGNI
- Не пиши BGP до v0.6, WASM-плагины до стабилизации compile-time API.
- Не добавляй feature flag если фича не готова.
Rust-специфичные
unwrap()— только в main() и тестахunsafe— только в xdp/, комментарий// SAFETY:обязателенclone()осознанно, профилируй hot path- Блокирующие операции →
spawn_blocking - Логи:
tracing::info!/debug!/error! - Метрики: register один раз при старте, инкремент в hot path
- Тесты отдельно от кода: в .rs-файлах с кодом НЕТ
#[cfg(test)]-модулей — тесты живут вtests/(нужный хелпер делайpubс реальным вызовом-потребителем). Существующие инлайн-тесты — легаси, мигрировать постепенно (см. бэклог).
§0.8 Комментарии в коде (все языки)
- Все комментарии и doc-комментарии — на английском. Русский остаётся только в
пользовательских текстах:
docs/, README, TODO, логи (tracing::*!), сообщения CLI/ошибок. - JavaDoc/Rustdoc-стиль. C:
/** ... */над функцией/структурой/картой/глобалом с@param/@return, когда они есть. Rust://!для модуля (что он владеет),///для элемента; сохраняй секции# Errors/# Panics/# Safety. - Без эмодзи, ASCII-баннеров (
═══,───), CAPS-акцентов и декоративных разделителей. Для группировки — обычный короткий комментарий. - Инлайн-комментарий объясняет почему, а не пересказывает код. Комментарий-шум удаляй.
- Правишь файл — переводи комментарии в нём целиком (смесь языков запрещена), но не трогай строковые литералы, идентификаторы и логику.
// SAFETY:— префикс обязателен, текст по-английски.
1. Целевая структура (v0.3)
guard/
├── Cargo.toml # ОДИН пакет rampart, features = ["protocol-http", ...]
├── scripts/ # check_module_size.sh (гейт 250/4), check_default_secrets.sh
├── src/
│ ├── bin/{rampart, rampart-manager, rampart-cli, rampart-tui}.rs # тонкие, логика в lib
│ ├── app/ # thin-main: runtime wiring, services (spawn-циклы)
│ ├── engine/ # listener, tunnel; challenge/ (pow+difficulty), subnet/ (tracker+monitor)
│ ├── filter/ # blacklist, rate_limit, geo — trait Filter
│ ├── traffic/ # hook + prefix/ (key+stats) + intel/ (ewma,detector,reputation) + profile/ (profiler,alert)
│ ├── store/ # redis (+ trait StateStore)
│ ├── manager/ # api/ (+ api/inventory/), auth/, sync/
│ ├── cli/ # команды; commands/node/ (status,drain,emergency)
│ ├── config/ # config + sections/{edge,platform,detect}
│ ├── tui/ # app/state/ui + metrics/ (prometheus,fetch)
│ ├── protocol/ # trait ProtocolHandler + registry; http/ под фичей
│ └── xdp/ # filter/ (attach,maps), probe/ (diagnostics/,stats,metrics), globals, noop
├── xdp/
│ ├── core/ # universal_filter.c + maps/stats/config/common.h + prefix_stats/syn_challenge
│ └── hooks/hook_api.h # контракт подключаемых BPF-протокол-хуков
├── tests/ # интеграционные (вне гейта 4-файлов: cargo требует 1 файл = 1 бинарь)
└── docs/ # kb/ (knowledge base) + research/ + ops-доки
1a. Статус после редизайна (2026-08-24)
| Что | Статус |
|---|---|
| plugins/ velocity+paper, dashboard/ | ✅ удалены (git-история) |
crates/* → единый пакет rampart + src/bin |
✅ сделано |
| MC-код (handshake, death_code, varint, hostname-HMAC) | ✅ удалён полностью |
PoW как универсальный hashcash (engine/challenge.rs) |
✅ сохранён |
| XDP: universal L3/L4 фильтр + hooks API | ✅ код готов, clang build OK |
| IPv6 баг в XDP (daddr→saddr) | ✅ исправлен |
| Knowledge Base docs/kb (attacks, defense-levels, practice) | ✅ написана, двуязычная |
| README + architecture.md под новую концепцию | ✅ переписаны |
| cargo build / clippy -D warnings / test | ✅ зелёные |
2. Ближайшие задачи (v0.3)
Subnet-level detection (ботнет с ротацией IP) — ✅ готово (2026-08/09)
- XDP: карта
prefix_stats(LRU_HASH, ключ /24 v4 | /64 v6) — счётчики SYN/pps per-префикс (xdp/core/prefix_stats.h, трафик-слой: src/traffic/prefix/). - Detector: превышение порога префиксом при IP под лимитом → флаг подсети (src/traffic/intel/detector.rs, src/engine/subnet/).
- Мягкая эскалация: monitor → strict_limit → challenge → block (SubnetVerdict-лестница; блок /24 идёт через ban_cidr, не слепой hard-ban).
- Блок подсети через
blacklist_map(LPM trie) —XdpFilter::ban_cidr.
Движок без протоколов — сделать полезным — ✅ готово
- Первый протокол-плагин:
protocol-http— HTTP/1.1 request-head анализ (src/protocol/http/, tests/http_protocol.rs). - Minecraft Java TCP MVP: ограниченный handshake status/login, передача исходных
байтов backend и опциональный PROXY protocol v2 (
protocol-minecraft). - TCP-proxy режим: tunnel.rs + ProtocolHandler интегрированы в listener/app wiring.
- Fail-fast сообщение при пустом registry (
ProtocolRegistry::primary()).
Подключение мёртвого интеллекта (правило: «мёртвый код = баг») — ✅ готово
- Traffic Intel в hot path: AttackDetector/IpReputation → метрики + auto-ban (src/traffic/hook.rs, src/engine/tunnel.rs, src/app/services.rs).
- Blacklist:
clear_expired()по таймеру (src/app/). - RateLimiter: TTL-эвикция idle bucket'ов.
Безопасность — ✅ кроме ролей
- Rate limiter на login endpoint manager API (per-IP, tests в api/auth.rs).
- JWT: audience-валидация, secret ≥ 32 байт fail-fast (rampart-manager.rs).
- JWT-роли: сейчас единственный hardcoded
admin; RBAC-ролей нет — либо убрать поле, либо делать роли (решение отложить до второго потребителя). - Redis:
KEYS→SCAN(scan_options), pubsub-подписчик — честный reconnect с экспоненциальным backoff (src/store/redis.rs).
XDP
- Verifier-проверка на реальном ядре (live-тест 2026-09: два бага RST-challenge найдены и
исправлены,
d6bcae5). - Rust loader (
src/xdp/filter/): open/load/attach, patch глобалов G_* из config.toml (src/xdp/globals.rs), CString-safe if_nametoindex, реальный detach по fd прогрессы. - Ringbuf events → blacklist: opt-in
auto_ban([xdp] config, default OFF) — EVENT_RATE_LIMIT всегда, EVENT_CONN_DROP при fails>=порога; EVENT_BAN/POLICY_DROP не банят (ядро уже отработало / статик-политика без аккумуляции). Парсер 24-байтногоstruct xdp_eventс фиксом endianness (IP — сетевой порядок, скаляры — host), метрикаrampart_xdp_autobans_total, tests/xdp_events.rs (10 тестов). - Smoke-test attach в CI (VM runner с CAP_BPF) + netns+veth харнесс — вывод №7 из конкурентного анализа, приоритет v0.4.
Документация
- docs/deployment.md, configuration.md, runbook.md — старых крейтов/MC не упоминают (grep чисто).
- docs/kb/README.md — индекс KB со ссылками.
docs/README.md— единый индекс документации (начало работы, how-to, reference, протоколы, теория/research) + правила ведения: русский язык, один документ = одна задача, reference правится в том же PR, что и код, плоская структура, kebab-case.README.md— двуязычный: русская часть сверху, английская снизу, общая шапка/бейджи/ переключатель языка, ряд кнопок-навигации (docs, quick start, config, API, license); секции по конвенции (обзор → возможности → требования → установка → быстрый старт → конфигурация → плагины → производительность → документация → разработка → лицензия), компактный TOC строкой, копируемые команды, ссылки на docs/README.md.docs/configuration.md— полная таблица[xdp](включаяudp_policy) и покрытие IPv4/IPv6;docs/testing.md— реальные XDP-smoke'и, а не только clang-проверка.- TUI (ratatui): live-метрики из Prometheus endpoint — готово (src/tui/,
564613b).
2a. Раунд 2026-09-15 — исправлено по итогам ревью
- unsafe-баги XDP-лоадера (src/xdp/filter/):
&str.as_ptr()без NUL вif_nametoindex→CString; фиктивныйborrow_raw(-1)-fd вunload()→ реальный detach по fd прогрессы с propagatable ошибкой;unsafe impl Sendполучил// SAFETY:;saturating_mulв expiry. +5 юнит-тестов. - Redis: fake-reconnect pubsub (sleep+return) → настоящий reconnect-loop с backoff;
KEYS→SCANв heartbeat. - CI:
cargo test --all-features(раньше тесты фич не гонялись); jobrepo-gates: гейт 250/4 + grep дефолтных секретов; Makefileciобновлён. - README: несуществующие
rampart-core/rampart config init→ реальные команды; таблица компонентов/плагинов приведена к коду (http готов, minecraft удалён, добавлен rampart-tui). - Рефакторинг под новые лимиты 250/4 без изменения поведения: app/, challenge/, subnet/, prefix/, intel/, profile/, commands/node/, api/inventory/, tui/metrics/, filter/, probe/; bin-файлы тонкие (rampart.rs: 330 → 6 строк).
Новые найденные проблемы (чинить в v0.4)
- Redis blacklist: срок/причина сохраняются; edge восстанавливает снимок после reconnect; локальные autoban-события публикуются в Redis с retry и absolute expiry.
- Minecraft Java: Velocity modern forwarding, игровые netns smoke-тесты и нагрузочная проверка.
- Принимать client IP от внешнего DDoS-прокси через доверенные CIDR и ограниченный PROXY v2 parser.
cargo check --no-default-featuresпочинен (2026-09-15, раунд 2): redis-код в manager/sync/api/store/app закрыт#[cfg(feature = "store-redis")], менеджер без фичи fail-fast'ит на старте; CI теперь гоняетcargo check --no-default-features --all-targetsгейтом.src/app/runtime.rs:#[allow(clippy::exit)]убран —app::run()возвращаетRunExit, единственныйprocess::exitтеперь вmainбина (clippy там не срабатывает).- Флакающий тест
pow_roundtrip::verifier_rejects_garbage_and_replay(p≈1/16 из-за случайного токена) — сидирован, 50 прогонов до (3 fail) / после (0 fail). - IPv6-паритет XDP (вывод №8) — сделано (2026-11-15):
- [x] C:
struct lpm_key6 { u32 prefixlen; u8 addr[16]; }вcommon.h;blacklist6_map(LPM_TRIE, 20-байтный ключ, valueu64expiry, 100000, NO_PREALLOC) вmaps.h; вuniversal_filter.cnon-mapped IPv6 больше не возвращает PASS раньше времени: общий L4-парсинг + порт-гейт, затем блокif (native_v6):is_blacklisted6(lookupprefixlen=128, expiry-cleanup как у v4) → DROP; UDP приG_UDP_POLICY==1→ DROP;detect_tcp_bypass→ DROP; TCP →prefix_key_from_v6+update_prefix_stats(оживило мёртвый код, замкнуло детектор подсетей на v6); иначе PASS. Ringbuf-события для v6 не шлём (ABIsrc_ipu32). - [x] Rust:pub fn blacklist6_key(prefix_len: u8, &[u8;16]) -> [u8;20](prefixlen LE в 0..4, addr network order в 4..20);blacklist6_update;ban_cidrматчит V4/V6;gateway.rs::xdp_ban→ban_cidr(ip, 32|128, dur)для обоих семейств;ban_ipудалён (после перевода gateway вызовов не осталось — «мёртвый код = баг»),noop.rsсинхронизирован. - [x] Тесты:tests/xdp_ban_v6.rs(layout ключа/64и/128, network order);scripts/xdp_ipv6_smoke.sh— реальный netns+verifier smoke (без бана pass → с баном blacklist+drop → после снятия снова pass), проверен на ядре 7.3.4. - [x] UDP rate-limit (policy==2) для native v6 (2026-11-15):udp_rate_limit6(LRU_HASH, 16-байтный ключstruct in6_addr, valuestruct throttle_entry) +throttle_hit6вuniversal_filter.c(та же семантика окна/порога, что у v4); ветка UDP вnative_v6теперьswitch (G_UDP_POLICY): 1 → DROP, 2 →throttle_hit6→ DROP при превышении, иначе PASS. Ringbuf-события для v6 по-прежнему не шлём (ABIsrc_ipu32) — только счётчики. Проверка: фаза 4 вscripts/xdp_ipv6_smoke.sh(патч.rodataдо загрузки: policy=2, hits=3 → 3 pass, 3 rate-limit). - Non-goals (позже): conntrack/throttle/RST-challenge для нативного v6 (нужны 128-битные flow/throttle-ключи); whitelist6 (уwhitelist_mapнет писателя даже для v4); ringbuf-события для v6; unban v6. - Expiry бана из userspace не работал в ядре (найден и починен 2026-11-15, касался v4 и v6):
blacklist_expiry_nsписалSystemTime(epoch ns ≈ 1.7e18), а C сравнивает сbpf_ktime_get_ns()(monotonic ≈ uptime) — бан жил до перезагрузки. Теперь userspace пишетCLOCK_MONOTONIC-ns (xdp::monotonic_ns), регрессия —tests/xdp_ban_clock.rsи expiry-фаза вscripts/xdp_ipv6_smoke.sh. - Короткий L4-хвост обходил blacklist (найден и починен 2026-11-15, v4 и v6):
universal_filter.cтребовалsizeof(struct tcphdr)(20 байт) для всех протоколов, иначе раннийXDP_PASS— UDP-датаграмма короче 20 байт не доходила до порт-гейта и blacklist. Теперь минимум считается по протоколу (sizeof(struct udphdr)для UDP); регрессия — «короткая датаграмма» вscripts/xdp_ipv6_smoke.sh. TCP-путь не изменился: там по-прежнему требуется полныйstruct tcphdr. - XDP-загрузчик не мог загрузить программу вообще (найден и починен 2026-11-15).
Три независимых бага, каждый из которых валил
load()до verifier'а: 1..rodata-раскладка:build_rodata_imageписал 96-байтный образ в 76-байтную карту (EINVAL) и по неверным смещениям — clang переставляет отдельныеstatic volatile constглобалы (UDP-политика лежала в 4, а не в 49). Теперь вconfig.hодинstruct rampart_config(layout фиксирован C-структурой +_Static_assertна каждый offset и размер),XdpGlobalsполучил#[repr(C)], образ строится черезoffset_of!, аpatch_rodataпадает с внятным сообщением при расхождении размера. 2.build.rsотслеживал толькоuniversal_filter.c— правкаconfig.h/common.hоставляла стухший объект вOUT_DIR(и старое.rodata). Теперьrerun-if-changedнаxdp/coreиxdp/hooks. 3.build_ringbufискал картуevents_map, а в C онаevents_ringbuf—load()падал после успешного verifier'а. Регрессии:tests/xdp_object_maps.rs(имена всех карт, которые ищет загрузчик, иvalue_size.rodata==RODATA_SIZE, без root) + перезапуск реального бинаря в netns (attach подтверждён), плюс весьscripts/xdp_ipv6_smoke.sh.
2b. Ревью 2026-11-16 — качество и надёжность
Четыре независимых ревью (XDP/загрузчик, data-path, фильтры/хранилища, API/конфиг/CI)
и один раунд фиксов. Гейты после раунда: fmt, clippy -D warnings, cargo test --all-features (258 тестов), --no-default-features + тесты с protocol-http,
module-size, secrets, cargo deny, rustdoc без warning'ов, clang+verifier,
xdp_ipv6_smoke.sh, xdp_pkt_test.sh, живой attach в netns (native и generic).
Исправлено
- XDP: длина TCP-payload по
ip->tot_len/payload_len— на реальном NIC паддинг больше не ломаетexpected_seq(было: каждое соединение умирало на 4-м сегменте). Регрессия —scripts/xdp_pkt_test.sh. - XDP: чтение map-значения до
bpf_map_delete_elem(UAF), сбросfails, TFO вexpected_seq, исправленный v6 SYN-ACK,inc_drop()на всех DROP-путях, per-CPU инкремент без atomic. - XDP: VLAN/QinQ до L3, фрагменты проверяются по blacklist, неизвестный non-SYN поток → PASS
(«stateless-фильтр, не firewall»),
whitelist6_map, whitelist до state machine. - XDP spoof-gate: в
prefix_statsдобавлен 64-битный bitmap хешей source-адресов, userspace считает popcount и сбрасывает счётчики при чтении →Blockработает и на XDP-пути, а окно детектора стало честным (раньше счётчики были кумулятивными и со временем «банили» всё). - XDP: протухшие префиксные баны удаляются userspace-reaper'ом раз в 60 с (пакетный путь
больше не пытается удалить
/24ключом/32). - Загрузчик: запоминается фактический attach-флаг (native/skb) и проверяется detach;
DetachGuardоткатывает attach при ошибке; whitelist из конфига грузится в карты;ban_cidrвалидирует и маскирует префикс; статистика знает все 13 счётчиков. - Security:
API_PASSWORDне пустой и ≥16 символов,JWT_SECRET≥32 непробельных,syn_challenge_enabledтребует свойchallenge_secret_hex, compose без публичных Redis/ClickHouse и без дефолтных паролей, пустойCORS_ORIGIN→ deny. - Storage: ClickHouse с таймаутами и без lock через
.await(bounded-буфер, метрика дропов), Redis наConnectionManagerс таймаутами и реконнектом, баны из pubsub клампятся, TOCTOU в blacklist, атомарныйreplace_redis. - Data path: backoff на
accept(), корректныйshutdown.changed() == Err, глобальный бюджет соединений, rate-limit до PoW, whitelist не банится, таймауты connect/handshake/relay, idle-таймаут relay. - Детекция: score считается до обновления baseline + гистерезис выхода из
UnderAttack(атака больше не «затухает» через тик); реальный cap и инкрементальная эвикция в rate-limiter и репутации; IPv4-mapped ключи совпадают. - Blacklist: CIDR-баны хранятся диапазонами —
/24//64покрывают всю подсеть; нормализация IPv4-mapped на входе и на lookup. - CI: джоба
cargo test --no-default-features --features protocol-http,make ebpfбольше не глотает ошибки, secrets-гейт ловит слабые compose-дефолты. doctorне дёргает защищённые ручки без токена и возвращает ненулевой код при провале.- Инлайн-тесты: 25 → 10 файлов (остальные — в следующих итерациях).
Осталось
- Monitor (
add_cidr) иtraffic/hookautoban сверяются сtrusted_cidrs: бан подавляется, если префикс пересекается с доверенной сетью (TrustedProxyCidr::overlaps_prefix), о чём пишется warn. Тесты:tests/subnet_detection.rs,tests/traffic_intel.rs,tests/proxy_identity.rs.
Сделано в этом раунде
- API manager'а:
SCAN+MGETвместоKEYS/N+1, 503 вместо200 [], пагинацияlimit/offset(100 по умолчанию, 1000 максимум), GET без записи (бэкфилл метаданных вынесен в стартовую задачу),DefaultBodyLimit8 КиБ,TimeoutLayer10 с, rate-limit на все мутирующие ручки, graceful shutdown с SIGTERM и join heartbeat, эвикция login-лимитера,MANAGER_TRUSTED_PROXIESдляX-Forwarded-For. Тесты —tests/manager_api.rs(9) иtests/manager_security.rs(23). - PROXY-header IP валидируется (loopback/link-local/multicast/broadcast/unspecified и
адреса из
trusted_cidrsотклоняются, mapped-IPv4 нормализуется), баны для адресов изtrusted_cidrsподавляются; невалидный заголовок → transport-peer. - IPv6 bind в listener (парсинг
IpAddr, домен по семейству, dual-stack для::). limits.relay_idle_timeout_secs(300 по умолчанию, 1..=86400) и семафор бюджета полемGatewayвместоOnceLock.- Инлайн-тесты мигрированы:
grep -rn "#\[cfg(test)\]" src/пуст, 41 тест переехал в 10 новых сюит (manager_auth,manager_heartbeat,protocol_http_*,traffic_*,tui_prometheus); счётчик тестов не изменился.
3. Backlog
- Мигрировать существующие инлайн-тесты (
#[cfg(test)]в src/) вtests/— правило §0.7; при миграции хелперы, нужные тестам, получаютpubс потребителем. Сделано 2026-11-16: вsrc/не осталось ни одного#[cfg(test)]. - protocol-gRPC plugin (после http)
- BPF hook #1 реальный: HTTP поверх XDP (rate-limit до userspace)
- GeoIP/ASN reputation (enum есть, реализации нет)
- Bloom filter для blacklist
- io_uring runtime (feature flag)
- ML anomaly detection (Isolation Forest)
- Fuzzing парсеров (
cargo-fuzz): целиhttp_headиproxy_v2вfuzz/, сиды вfuzz/seeds/, запускmake fuzz(nightly); PROXY v2-парсер стал чистой функциейparse_v2_header+ 10 интеграционных тестов на обрезку/TLV/семейства. - BGP Anycast (AS + /24)
3a. Бенчмарк-конкуренты: чем превзойти
Все репо склонированы в
ref/(gitignored). Анализ issues/PRs проведён 2026-08-24 через gh по трекерам конкурентов. Ниже — выжимка «что у них болит и что берём».
Карта конкурентов
| Проект | Что это | Похож на Rampart тем, что | Что взять |
|---|---|---|---|
| eBPFsentinel | Rust, один бинарник: firewall+IDS+DDoS через XDP/TC/uprobe | Ближайший аналог, та же архитектура | Rootless BPF token (kernel 6.9+); tail-call цепочки; MITRE-теги алертов; Swagger UI |
| CrabShield | Rust + XDP, гибрид L7→L3 | «Умный юзерспейс, кара в ядре» | Static musl бинарник; reaper истекающих банов; (log-tailing НЕ брать — хрупко) |
| lnvps_fw | XDP+TC защита VDS | Прямо наша ниша | ⭐ SYN-proxy в XDP; port learning из TC egress; лестница PORT_FILTER→SYN_PROXY→SOURCE_BLOCK + spoof gate; netns+veth harness |
| Oubliette | Linerate scrubber | Решает нашу боль с PoW | ⭐ RST-challenge: SYN-ACK с неверным ACK → спуф молчит, живой клиент шлёт RST → whitelist. Совместимо с любым клиентом |
| Couic (CERT Франции) | XDP-фаервол + REST API | Наш manager API | Anti-lockout; теги+TTL записей; OpenAPI spec; синк инстансов; fail2ban-интеграция |
| gamemann/XDP-Firewall (~830★) | Классический C XDP-фаервол | Референс по XDP | Pinned maps для внешнего управления; их issues = карта граблей верификатора |
| gen0sec/synapse | NDR: eBPF + JA4-фингерпринты + ratatui TUI | TUI как наш план | JA4+/JA4T фингерпринтинг (бан по отпечатку); fallback-цепочка XDP→nftables→iptables |
Топ-10 выводов из их issues/PRs (приоритет)
- Диагностика окружения при старте — проверять ядро/BTF/driver NIC до загрузки, человекочитаемый вердикт. ≈80% issues XDP-Firewall — про attach на неподдерживаемом окружении (#70/#71/#9/#44). Печатать режим (native/generic) честно.
- Эскалационная лестница защиты (lnvps_fw): pass-all steady state → PORT_FILTER → SYN_PROXY (tail-call, keyed cookie, ротация секрета) → SOURCE_BLOCK только со spoof-gate.
- RST-challenge (Oubliette) вместо мёртвого текстового PoW — универсально совместимо.
- REST API + OpenAPI + pinned maps: динамические IP-списки без перекомпиляции — самый частый feature request (#79/#77/#78 у gamemann); web-панель так и не сделана автором = свободная ниша.
- Anti-lockout + per-port баны: слепой XDP_DROP по IP = self-lockout по SSH (crab-shield docs). Whitelist обязателен, но не единственная защита.
- LRU во всех data-path maps — иначе silent default-deny под атакой (netshield DD-003). Per-src-IP rate limit не работает против spoofed flood 50–100 Mpps (gamemann #45) — нужны per-port/per-subnet/flow агрегаты.
- netns+veth тестовый харнесс + eBPF test_run тесты в CI (подтверждено в 2 проектах, отсутствует у всех) — наше конкурентное преимущество в надёжности.
- IPv6-паритет с первого дня + VLAN/QinQ парсинг (issue #75 висит годами).
- Rootless BPF token как опция, fallback CAP_BPF для ядер 5.15+ — не повторять жёсткий floor 6.9+ (ebpfsentinel отсёк enterprise) и не требовать root (crab-shield).
- События атак наружу с первого дня: poll-and-persist, дедуп алертов на переходе состояния (урок LNVPS #331 — отложили = дыра в продукте).
Наши козыри (чем превзошли уже)
- Двуязыная Knowledge Base (docs/kb/) — educational killer-feature, нет ни у одного конкурента
- Один Rust-бинарник без C-зависимостей сборки (класс сегфолтов/libbpf-hell gamemann исключён)
- Честные бенчмарки: цифры только с отчётами, методология опубликована
- Модульный лимит ≤300 строк + no-dead-code политика в CI
4. Anti-Regression — правила приёмки
- No dead code: каждый
pubимеет вызова вне#[cfg(test)]. - Config field = потребитель: нет поля без использования.
- Метрика регистрируется → обновляется: единственный writer на каждую метрику.
- Feature flag = сборка в CI:
--all-featuresзелёный, иначе фичи нет. - По умолчанию безопасно: нет дефолтных секретов; отсутствие обязательного env = fail-fast.
- Интеграционный тест на слой: config parse, filter logic, registry fail-fast (есть); новый слой = новый тест.
- Файл ≤ 250 строк, папка ≤ 4 .rs: CI-гейт
scripts/check_module_size.sh(ratchet-базлайн.module_size_baseline: легаси — WARN, новые нарушения — FAIL). - CI guardrails:
cargo clippy --all-targets -- -D warnings,cargo test, clang-build xdp/core/universal_filter.c, grep наchangeme. - README/TODO не врут: каждое число имеет ссылку на тест или отчёт.
5. Definition of Done
☐ cargo check / cargo test проходят
☐ cargo clippy --all-targets -- -D warnings — 0 warnings
☐ cargo fmt --check проходит
☐ Ни один файл не превышает 250 строк; ни в одной папке src/ больше 4 .rs-файлов
☐ Unit тесты покрывают happy path + 2+ error cases
☐ Нет мёртвого кода: pub без вызовов, конфиг-поле без потребителя, метрика без writer
☐ Нет дефолтных секретов
☐ README соответствует коду
☐ Документация обновлена
☐ CI зелёный
6. Anti-Patterns
❌ Тесты после кода. Пиши вместе.
❌ Файл > 250 строк или > 4 .rs в папке — сигнал декомпозировать/сгруппировать немедленно.
❌ TODO в коде без issue.
❌ Мёртвый код: pub без вызовов, конфиг-поле без потребителя, метрика без writer.
❌ «Бумажный слой»: фича описана, но не вызывается.
❌ Дефолтный секрет.
❌ Парсер за «один read» — TCP-поток приходит фрагментами.
❌ Feature flag, который не собирается в CI.
Версия: 5.0 | Обновлён: 2026-09-15 (bug-fix раунд: XDP unsafe, Redis reconnect/SCAN, CI-гейты, лимиты 250/4)