BPF program (the first two made the filter wrong on real hardware): - Compute the TCP payload length from ip->tot_len (IPv4) / payload_len (IPv6) instead of data_end. Ethernet padding on a real NIC added 6 bogus payload bytes, broke expected_seq and dropped every connection after the fourth segment. scripts/xdp_pkt_test.sh reproduces it on synthetic frames and fails against the old code. - Read map values (conn->fails, sent_at) before bpf_map_delete_elem; the LRU element is freed by the delete. - Parse up to two VLAN/QinQ tags before L3; fragments are checked against the blacklist and passed instead of bypassing all filtering; first fragments are no longer dropped. - Unknown non-SYN flows PASS: the program is a stateless filter fed by the conntrack state machine, not a firewall, so spoofed SYNs cannot evict established flows into a drop and replies to the daemon's own outbound TCP keep working. - Reset conn->fails on in-order segments, honour SYN payload (TFO), fix the IPv6 SYN-ACK address swap, count every DROP path, drop SYN with IP options. - Expired prefix bans are no longer deleted with the wrong LPM key; userspace reaps them with the exact key. Loader: - Remember the effective attach flags (native vs generic) and use them for detach/query, verifying the interface is clean afterwards. The old code always detached the native slot, leaving a generic program attached after shutdown. - DetachGuard rolls back the attach if anything after it fails. - ban_cidr validates the prefix length and masks host bits. - Whitelist maps (v4 and the new v6 LPM trie) are populated from the config at startup and fail fast on error. - Stats read all 13 counters, and a test asserts every map's key/value size against the Rust encodings. Tests: xdp_pkt_test (padding, VLAN/QinQ, fragments), xdp_loader (attach flags, rollback, detach), xdp_ban_keys, xdp_whitelist_keys, xdp_services, live xdp_attach_smoke (ignored, needs root). |
||
|---|---|---|
| .. | ||
| kb | ||
| research | ||
| api.md | ||
| configuration.md | ||
| deployment.md | ||
| disaster_recovery.md | ||
| minecraft-java.md | ||
| README.md | ||
| runbook.md | ||
| testing.md | ||
| troubleshooting.md | ||
| vds_compatibility.md | ||
Документация Rampart
Индекс всей документации проекта и правила её ведения. Точка входа — README.md; текущий статус и планы — TODO.md.
1. С чего начать
| Документ | Когда читать |
|---|---|
| deployment.md | Первый деплой edge-ноды и manager'а |
| configuration.md | Настройка config.toml, секция [xdp], переменные manager'а |
| runbook.md | Ежедневная эксплуатация и типовые операции |
2. Эксплуатация (how-to)
| Документ | О чём |
|---|---|
| runbook.md | Метрики, рестарты, снятие банов, аварийные процедуры |
| troubleshooting.md | Диагностика типовых проблем |
| disaster_recovery.md | Восстановление после отказа Redis/ноды |
| testing.md | Гейты, тесты, XDP-smoke на реальном ядре |
3. Справочник (reference)
| Документ | О чём |
|---|---|
| configuration.md | Все поля конфига и значения по умолчанию |
| api.md | HTTP API manager'а: аутентификация, эндпоинты |
| vds_compatibility.md | Ограничения окружений и ядер |
4. Протоколы
| Документ | О чём |
|---|---|
| minecraft-java.md | Minecraft-edge: Paper, PROXY protocol, закрытый backend |
5. Теория и исследования
| Раздел | О чём |
|---|---|
| kb/ | База знаний: анатомия атак, уровни защиты, практика (двуязычная) |
| research/ | Глубокие разборы: архитектура, eBPF, DDoS, Rust-производительность, конкуренты |
kb/ отвечает на вопрос «как это работает и как защищаться», research/ — на вопрос
«какое решение выбрать и почему». Статус проекта не живёт ни там, ни там — только в
TODO.md.
6. Как вести документацию
- Язык.
docs/— русский. Исключение: docs/kb/, где статьи двуязычные (## English/## Русский). Комментарии в коде — английский (TODO §0.8). - Один документ = одна задача. How-to начинается с цели («что получится в конце»), содержит копируемые команды и заканчивается проверкой результата.
- Reference синхронизируется с кодом в том же PR. Меняешь поле конфига, флаг CLI
или эндпоинт — правишь
configuration.md/api.mdтам же. Расхождение = баг. - Новый документ кладётся в подходящую категорию (2–4) и сразу добавляется в эту таблицу; если он является точкой входа — ссылка добавляется и в корневой README.
- Не размножай папки. Плоская структура
docs/*.md— норма; подпапка нужна только для серии документов (kb/,research/). - Имена файлов — kebab-case,
.md, без дат в имени; дата и версия — внутри документа. - Никаких битых ссылок. Перед коммитом:
grep -o '](\.\?[^)]*)' docs/*.mdи проверь, что цели существуют.