O singură comandă. Complet securizat.
Agentul CASTOVIA se instalează în mai puțin de 60 de secunde, gestionează automat securitatea și comunică cu CASTOVIA Cloud prin canale criptate. Fără reguli manuale de firewall, fără chei SSH, fără VPN.
Explicația comenzii de instalare
Exact ce se întâmplă când rulezi instalatorul într-o singură linie pe serverul tău Linux.
Ce face comanda
Comanda de instalare într-o singură linie pe care o copiezi din panoul de administrare CASTOVIA efectuează următorii pași pe serverul tău Linux:
Comanda propriu-zisă
Comanda pe care o vezi în panoul tău de administrare arată astfel:
curl -sSL https://install.castovia.com/agent | sudo bash -s -- --token YOUR_SERVER_TOKENYOUR_SERVER_TOKEN este un token unic, de o singură utilizare, generat per nod. Expiră după 24 de ore dacă nu este folosit.
Ce NU face agentul
Limite clare. Agentul este limitat intenționat ca domeniu de acțiune.
Securitate — integrată, nu adăugată ulterior
Fiecare măsură de securitate este automată. Nu este necesară nicio configurare manuală.
Autentificare prin token de server
automatFiecărui nod i se atribuie un token de server unic, aleator criptografic (256-bit). Acest token este generat în adminul CASTOVIA când creezi un nod. Este folosit o singură dată la înregistrare și apoi înlocuit cu un certificat client TLS rotativ.
Criptare TLS 1.3
automatToată comunicarea dintre agent și CASTOVIA Cloud folosește TLS 1.3. Agentul validează lanțul de certificate CASTOVIA împotriva unui root CA fixat — fără încredere în magazinul de certificate al sistemului. Atacurile man-in-the-middle nu sunt posibile.
Cerințe de firewall
automatAgentul are nevoie doar de trafic outbound HTTPS (portul 443) către CASTOVIA Cloud. Nu este necesară deschiderea niciunui port inbound. Regulile firewall-ului serverului rămân nemodificate — agentul nu modifică iptables, nftables sau firewalld.
Fără acces root la runtime
automatAgentul rulează ca un utilizator dedicat, fără privilegii (castovia-agent). Are nevoie de root doar în timpul instalării (pentru a crea serviciul systemd). La runtime, funcționează cu permisiuni minime — acces de citire la sursele streamurilor, acces de scriere la propriul director de cache.
Rotirea automată a certificatelor
automatCertificatele client se rotesc la fiecare 7 zile. Agentul gestionează reînnoirea transparent. Dacă un certificat expiră (de ex., serverul a fost offline), agentul folosește un flux securizat de reînrolare care necesită aprobare în adminul CASTOVIA.
Monitorizare a stării și auto-reparare
automatAgentul își monitorizează propria stare. Dacă se blochează, systemd îl repornește în 5 secunde. Dacă nu poate ajunge la CASTOVIA Cloud, continuă să servească configurația cache-uită și pune metricile în coadă pentru livrare ulterioară.
Protocol de comunicare
Cum circulă datele între serverul tău și CASTOVIA Cloud.
CASTOVIA Cloud → Agent (Configuration Push)
Tehnic: Configurația este livrată sub formă de payload-uri JSON semnate. Agentul validează fiecare payload înainte de aplicare. Fără SQL brut, fără comenzi shell — doar configurație structurată.
Agent → CASTOVIA Cloud (Telemetry)
Tehnic: Telemetry este trimisă la fiecare 30 de secunde prin HTTPS POST. Payload-ul este comprimat (gzip) și criptat. Dimensiune medie: 2–5 KB per interval.
Rezumat de rețea
| Aspect | Detaliu |
|---|---|
| Protocol | HTTPS (TLS 1.3) cu certificate pinning |
| Port outbound | 443 (doar HTTPS) |
| Porturi inbound | Niciunul necesar pentru CASTOVIA |
| Heartbeat | La fiecare 30 de secunde (2–5 KB comprimat) |
| Autentificare | Certificate client TLS rotative (rotire la 7 zile) |
| Bandă | < 1 MB/oră pentru traficul de administrare |
| Comportament offline | Servește configurația din cache, pune telemetry în coadă, se reconectează automat |
| Traficul streamurilor | Nu este niciodată rutat prin CASTOVIA — rămâne pe rețeaua ta |
Dezinstalare completă
Dacă elimini un nod, agentul se curăță complet:
sudo castovia-agent uninstall --purge