From b741e042ac09a8f546fb465627d4d11756251377 Mon Sep 17 00:00:00 2001 From: loki5512344 Date: Fri, 16 Oct 2026 23:15:33 +0200 Subject: [PATCH] fix: report unsupported CLI operations honestly --- TODO.md | 6 +++--- docs/api.md | 2 +- docs/runbook.md | 18 ++++-------------- src/cli/commands/config.rs | 11 +++-------- src/cli/commands/node/drain.rs | 6 +----- src/cli/commands/node/emergency.rs | 8 ++------ 6 files changed, 14 insertions(+), 37 deletions(-) diff --git a/TODO.md b/TODO.md index f115755..fe25fa8 100644 --- a/TODO.md +++ b/TODO.md @@ -151,10 +151,10 @@ guard/ bin-файлы тонкие (rampart.rs: 330 → 6 строк). ### Новые найденные проблемы (чинить в v0.4) -- [ ] Redis blacklist: сохранять срок/причину бана и восстанавливать edge-состояние после reconnect; - Pub/Sub сейчас только для подключённых узлов. +- [x] Redis blacklist: срок/причина сохраняются; edge восстанавливает снимок после reconnect; + локальные autoban-события публикуются в Redis с retry и absolute expiry. - [ ] Minecraft Java: Velocity modern forwarding, игровые netns smoke-тесты и нагрузочная проверка. -- [ ] Принимать client IP от внешнего DDoS-прокси через доверенный inbound PROXY protocol. +- [x] Принимать client IP от внешнего DDoS-прокси через доверенные CIDR и ограниченный PROXY v2 parser. - [x] `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` гейтом. diff --git a/docs/api.md b/docs/api.md index 4d04d80..4f5e30e 100644 --- a/docs/api.md +++ b/docs/api.md @@ -127,7 +127,7 @@ Edge подписывается на Pub/Sub перед загрузкой сн Честно, на текущий момент в API **нет**: -- drain нод через API (есть только CLI `rampart-cli drain`); +- drain нод через API или CLI; - webhooks, metrics summary, challenge management; - регистрации нод через `POST /api/v1/nodes`; - rate limiting на сами запросы API (кроме login). diff --git a/docs/runbook.md b/docs/runbook.md index 2c557df..ea75479 100644 --- a/docs/runbook.md +++ b/docs/runbook.md @@ -39,19 +39,11 @@ rampart-cli blacklist list # C) Доверенные IP (мониторинг, админы) → whitelist в config.toml # (только IP-адреса), затем systemctl restart rampart -# D) Повысить стоимость флуда → включить PoW: -# [pow] -# enabled = true -# difficulty = 5 -systemctl restart rampart +# D) Для Minecraft Java PoW не включай: он несовместим с протоколом. +# Проверь фильтрацию трафика у upstream game-proxy и его лимиты. # ── ШАГ 4: Если не помогает ── -# Emergency mode (через CLI): -rampart-cli emergency enable -# ... и обратно после атаки: -rampart-cli emergency disable - # В крайнем случае — закрыть порт на firewall и разбираться: iptables -A INPUT -p tcp --dport 25565 -j DROP @@ -66,6 +58,8 @@ clickhouse-client --query "SELECT count() FROM rampart.events WHERE event_type=' > Честно: hot-reload конфига не реализован — изменения применяются рестартом. > ASN/CIDR-баны, GeoIP-блокировки стран и выбор типов challenge через CLI не > реализованы; blacklist принимает цели в том виде, в котором их хранит Manager. +> Команды `emergency`, `drain` и `config set` пока не реализованы и завершатся +> явной ошибкой вместо изменения состояния. ## 2. Edge нода не стартует @@ -142,13 +136,9 @@ clickhouse-client --query "ALTER TABLE rampart.events MODIFY TTL ts + INTERVAL 9 ```bash rampart-cli status # Общее состояние системы rampart-cli doctor # Полная диагностика -rampart-cli config get # Получить параметр -rampart-cli config set # Установить параметр rampart-cli blacklist add [reason] rampart-cli blacklist remove rampart-cli blacklist list -rampart-cli emergency enable|disable # Emergency mode -rampart-cli drain # Плавно вывести ноду ``` Полный список: `rampart-cli --help` (источник — src/bin/rampart-cli.rs). diff --git a/src/cli/commands/config.rs b/src/cli/commands/config.rs index 48830a7..4c97383 100644 --- a/src/cli/commands/config.rs +++ b/src/cli/commands/config.rs @@ -1,14 +1,9 @@ pub async fn run(key: Option, value: Option) -> anyhow::Result<()> { match (key, value) { - (Some(k), Some(v)) => { - println!("Setting {k} = {v}"); - Ok(()) - }, - (Some(k), None) => { - println!("Reading config key: {k}"); - println!("(not implemented in v0.1)"); - Ok(()) + (Some(_), Some(_)) => { + anyhow::bail!("config updates are not implemented; edit the edge config and restart Rampart") }, + (Some(_), None) => anyhow::bail!("config lookup is not implemented"), (None, Some(_)) | (None, None) => { println!("Configuration"); println!("=============\n"); diff --git a/src/cli/commands/node/drain.rs b/src/cli/commands/node/drain.rs index bfe2041..3d33261 100644 --- a/src/cli/commands/node/drain.rs +++ b/src/cli/commands/node/drain.rs @@ -1,7 +1,3 @@ pub async fn run(node: &str) -> anyhow::Result<()> { - println!("Draining node: {node}"); - println!("Waiting for active connections to drain..."); - tokio::time::sleep(std::time::Duration::from_secs(2)).await; - println!("Node {node} drained successfully."); - Ok(()) + anyhow::bail!("graceful drain is not implemented for node {node}") } diff --git a/src/cli/commands/node/emergency.rs b/src/cli/commands/node/emergency.rs index efe7392..91b88e2 100644 --- a/src/cli/commands/node/emergency.rs +++ b/src/cli/commands/node/emergency.rs @@ -1,11 +1,7 @@ pub async fn enable() -> anyhow::Result<()> { - println!("Emergency mode ENABLED"); - println!("Only whitelisted IPs will be allowed through."); - Ok(()) + anyhow::bail!("emergency mode is not implemented; change the edge policy and restart Rampart") } pub async fn disable() -> anyhow::Result<()> { - println!("Emergency mode DISABLED"); - println!("Normal filtering resumed."); - Ok(()) + anyhow::bail!("emergency mode is not implemented; change the edge policy and restart Rampart") }