Одна команда. Полная защита.
Агент CASTOVIA устанавливается менее чем за 60 секунд, автоматически обеспечивает безопасность и связывается с CASTOVIA Cloud по зашифрованным каналам. Никаких ручных правил firewall, SSH-ключей или VPN.
Что означает команда установки
Что именно происходит, когда вы запускаете однострочный установщик на Linux-сервере.
Что делает команда
Однострочная команда установки, которую вы копируете из админ-панели CASTOVIA, выполняет на вашем Linux-сервере следующие шаги:
Фактическая команда
Команда, которую вы видите в своей админ-панели, выглядит так:
curl -sSL https://install.castovia.com/agent | sudo bash -s -- --token YOUR_SERVER_TOKENYOUR_SERVER_TOKEN — это уникальный одноразовый токен, создаваемый для каждого узла. Если его не использовать, он истекает через 24 часа.
Чего агент НЕ делает
Чёткие границы. Агент намеренно ограничен по функциям.
Безопасность — встроена, а не добавлена потом
Каждая мера безопасности автоматическая. Ручная настройка не требуется.
Аутентификация по серверному токену
автоматическиКаждому узлу назначается уникальный, криптографически случайный серверный токен (256-bit). Этот токен создаётся в админке CASTOVIA при добавлении узла. Он используется один раз во время регистрации, после чего заменяется вращающимся TLS client certificate.
Шифрование TLS 1.3
автоматическиВся связь между агентом и CASTOVIA Cloud использует TLS 1.3. Агент проверяет цепочку сертификатов CASTOVIA по закреплённому root CA — доверие к системному хранилищу сертификатов не используется. Атаки man-in-the-middle невозможны.
Требования к firewall
автоматическиАгенту нужен только исходящий HTTPS (порт 443) до CASTOVIA Cloud. Открывать входящие порты не требуется. Правила firewall на вашем сервере остаются без изменений — агент не модифицирует iptables, nftables или firewalld.
Во время работы root не требуется
автоматическиАгент работает под отдельным непривилегированным пользователем (castovia-agent). Root нужен только во время установки (для создания systemd-службы). Во время работы он действует с минимальными правами — доступ на чтение к источникам потоков, доступ на запись к собственному каталогу кэша.
Автоматическая ротация сертификатов
автоматическиClient certificates ротируются каждые 7 дней. Агент прозрачно выполняет продление. Если сертификат истёк (например, сервер был офлайн), агент использует безопасный поток повторной регистрации, который требует одобрения в админке CASTOVIA.
Мониторинг состояния и самовосстановление
автоматическиАгент отслеживает собственное состояние. Если он аварийно завершится, systemd перезапустит его в течение 5 секунд. Если он не может связаться с CASTOVIA Cloud, он продолжит отдавать кэшированную конфигурацию и поставит метрики в очередь для последующей отправки.
Протокол связи
Как данные передаются между вашим сервером и CASTOVIA Cloud.
CASTOVIA Cloud → Агент (передача конфигурации)
Техническое: Конфигурация доставляется в виде подписанных JSON-пакетов. Агент проверяет каждый пакет перед применением. Никакого сырого SQL и никаких shell-команд — только структурированная конфигурация.
Агент → CASTOVIA Cloud (телеметрия)
Техническое: Телеметрия отправляется каждые 30 секунд через HTTPS POST. Полезная нагрузка сжимается (gzip) и шифруется. Средний размер: 2–5 КБ за интервал.
Сводка по сети
| Параметр | Детали |
|---|---|
| Протокол | HTTPS (TLS 1.3) с закреплением сертификата |
| Исходящий порт | 443 (только HTTPS) |
| Входящие порты | CASTOVIA не требует |
| Heartbeat | Каждые 30 секунд (2–5 КБ сжато) |
| Аутентификация | Вращающиеся TLS client certificates (ротация каждые 7 дней) |
| Пропускная способность | < 1 МБ/час для управляющего трафика |
| Поведение офлайн | Отдаёт кэшированную конфигурацию, ставит телеметрию в очередь, автоматически переподключается |
| Потоковый трафик | Никогда не идёт через CASTOVIA — остаётся в вашей сети |
Полное удаление
Если вы удаляете узел, агент полностью очищается:
sudo castovia-agent uninstall --purge