# Configuration - Rampart > Единый конфиг edge-ноды (`config.toml`) и переменные окружения Manager. > Схема конфига: `src/config/sections.rs` — единственный источник правды. ## 1. Edge (`config.toml`, путь задаётся `RAMPART_CONFIG`) ```toml # Корневые поля должны стоять до первой TOML-секции. whitelist = ["127.0.0.1", "::1"] [bind] address = "0.0.0.0" port = 25565 [backend] # Список TCP-бэкендов (addr:port). Для Minecraft нужен ровно один backend. upstreams = ["127.0.0.1:25566"] [protocol.minecraft] enabled = true max_frame_bytes = 8192 timeout_secs = 5 send_proxy_protocol = false [workers] count = 4 [limits] handshake_timeout_secs = 5 # таймаут чтения (slowloris-защита) max_connections_per_ip = 10 # одновременные соединения с одного IP rate_limit_pps = 5.0 # лимит коннектов/сек с одного IP rate_limit_burst = 10.0 # burst [ban] ban_duration_secs = 3600 [store] redis_url = "" # пусто = синхронизация блэклиста выключена blacklist_cache_ttl_secs = 300 clickhouse_url = "" # пусто = запись событий выключена [xdp] enabled = false # требует сборки --features xdp, kernel 5.10+ interface = "eth0" [logging] level = "info" # trace, debug, info, warn, error format = "text" # text или json [metrics] enabled = true port = 9090 [pow] enabled = false # PoW challenge, OFF по умолчанию difficulty = 4 # Входящий PROXY v2 от известного TCP DDoS-прокси; включай только если # прокси действительно отправляет этот заголовок. [proxy_protocol] ingress_enabled = false trusted_cidrs = [] ingress_timeout_ms = 750 max_header_bytes = 512 ``` Этот пример выбирает Minecraft Java и требует сборки с `protocol-minecraft`. Для HTTP используй сборку `protocol-http` и удали `[protocol.minecraft]`. Все секции опциональны — при отсутствии используются дефолты из таблицы выше. Для ingress PROXY v2 укажи сети именно прокси в `trusted_cidrs`; включение без доверенной сети отклоняется при чтении конфига. `send_proxy_protocol` отправляет заголовок на Paper backend; прежнее имя `proxy_protocol` внутри `[protocol.minecraft]` остаётся допустимым alias. ## 2. Manager (переменные окружения) | Переменная | Обязательна | По умолчанию | Описание | |------------|-------------|--------------|----------| | `REDIS_URL` | нет | `redis://127.0.0.1:6379/0` | Хранилище состояния | | `JWT_SECRET` | да | — | Минимум 32 байта | | `JWT_AUDIENCE` | нет | `rampart` | Audience JWT | | `JWT_EXPIRATION_SECS` | нет | `86400` | Время жизни токена | | `API_PASSWORD` | да | — | Пароль для `/api/v1/auth/login`; значение `changeme` запрещено | | `CORS_ORIGIN` | нет | `http://localhost:5173` | CORS; `*` или пусто — разрешить все | Manager всегда слушает `0.0.0.0:8080`. ## 3. Feature flags сборки (Cargo.toml) | Feature | По умолчанию | Что включает | |---------|--------------|--------------| | `store-redis` | ✅ | Redis-клиент и синхронизация блэклиста | | `geoip` | ❌ | GeoIP lookup (maxminddb) | | `xdp` | ❌ | Загрузка XDP-программы через libbpf-rs | | `io-uring` | ❌ | splice/io_uring I/O | | `protocol-http` | ❌ | HTTP/1.1 handler; включай только для HTTP upstream | | `protocol-minecraft` | ❌ | Minecraft Java TCP handshake и проксирование | Пример: `cargo build --release --features xdp --bin rampart`. ## 4. BPF/XDP программа Исходник: `xdp/core/universal_filter.c`. Smoke-check компиляции: ```bash clang -O2 -g -target bpf -c xdp/core/universal_filter.c -o /tmp/universal_filter.o ``` --- *Версия: 2.1 | Октябрь 2026*