# Deployment - Rampart > Как поднять Rampart с нуля. --- ## 1. Компоненты | Бинарь | Роль | Порт по умолчанию | |--------|------|-------------------| | `rampart` | Edge-нода: XDP + PoW + userspace-фильтр | 25565 (+ metrics 9090) | | `rampart-manager` | REST API управления | 8080 | | `rampart-cli` | Управление через Manager API | — | ## 2. Требования ### Edge - Ubuntu 22.04+ / Debian 12, kernel 5.10+ - KVM или bare metal (OpenVZ/LXC — XDP не работает) - Rust toolchain для сборки Для XDP дополнительно: `libelf-dev libbpf-dev clang linux-libc-dev`. ### Manager - Любая VDS с Docker (Redis обязателен) ## 3. Быстрый старт — Edge ```bash # Сборка edge для Minecraft Java git clone https://github.com/loki5512344ss/guard.git && cd guard cargo build --release --features protocol-minecraft --bin rampart # Установка sudo cp target/release/rampart /usr/local/bin/ # Конфиг sudo mkdir -p /etc/rampart sudo cp deploy/config/edge.toml /etc/rampart/config.toml # Отредактируй backend.upstreams под свои бэкенды # systemd unit cat > /etc/systemd/system/rampart.service << 'EOF' [Unit] Description=Rampart Edge Node After=network.target [Service] Type=simple Environment=RAMPART_CONFIG=/etc/rampart/config.toml ExecStart=/usr/local/bin/rampart Restart=always RestartSec=5 LimitNOFILE=65535 [Install] WantedBy=multi-user.target EOF systemctl daemon-reload systemctl enable --now rampart # Проверка journalctl -u rampart -f ``` Minecraft-конфиг рассчитан на один Paper backend. Если включён `protocol.minecraft.send_proxy_protocol`, включи `proxies.proxy-protocol: true` в Paper и закрой backend-порт firewall-ом от всех, кроме Rampart. Для подробной схемы с домашним сервером и защищённым VDS см. [Minecraft Java guide](minecraft-java.md). ## 4. Быстрый старт — Manager ```bash export REDIS_URL="redis://127.0.0.1:6379/0" export JWT_SECRET="$(openssl rand -hex 32)" # минимум 32 байта export API_PASSWORD="не-changeme" # дефолт запрещён cargo run --release --bin rampart-manager # API на 0.0.0.0:8080 ``` Manager listens on all interfaces by default. Permit `8080` only from an admin VPN or specific admin addresses; do not expose the API to the public Internet. The same applies to Redis (`6379`) and monitoring endpoints such as Prometheus (`9090`), ClickHouse (`8123`/`9000`) and Grafana (`3000`). The sample Compose file publishes ClickHouse and Grafana ports on the host, so restrict them with the host firewall or change their port bindings before deploying on a public VDS. Redis has no published host port in that Compose file and is reachable only by containers on its Docker network unless you deliberately expose it. Инфраструктура (Redis, ClickHouse, Grafana): ```bash docker compose up -d redis clickhouse grafana ``` Для нескольких edge и Manager укажи один и тот же защищённый Redis endpoint в `store.redis_url` каждого edge и `REDIS_URL` Manager. Edge передаёт туда локальные автобаны и восстанавливает общие bans после переподключения. Открой Redis только через private network/VPN; при пустом `redis_url` edge остаётся автономным, и автобаны между узлами не распространяются. ## 5. Docker ```bash # Образ edge docker build -f deploy/docker/Dockerfile.edge -t rampart-edge . # Полный стек edge + инфраструктура docker compose -f deploy/docker-compose.yml up -d ``` ## 6. Проверка после деплоя ```bash ☐ systemctl status rampart ☐ ss -tlnp | grep 25565 ☐ curl http://localhost:9090/metrics | grep rampart_ ☐ rampart-cli status # через Manager API ☐ rampart-cli doctor # диагностика ``` --- *Версия: 2.1 | Октябрь 2026*