Guida · Per gli amministratori
Introduzione
KoaVM è il pannello per vendere e gestire VPS, costruito su Incus. Un solo programma fa tutto: API, interfaccia per te e per i tuoi clienti, coda dei lavori, grafici, console, migrazione dagli altri pannelli.
Come è fatto
- Il pannello gira su un server (anche uno dei nodi). È un solo binario,
koavm, con il database SQLite in/var/lib/koavm. - I nodi sono i server dove girano le VPS, con Incus installato. Il pannello parla con Incus tramite la sua API, con un certificato: sui nodi non c'è niente da installare.
- Le VPS sono macchine virtuali KVM sui nodi KoaVM. Nascono dai sistemi che offri (le distribuzioni Linux del catalogo, Windows Server, i tuoi template) con rete statica, password e chiave SSH già pronte, e se vuoi con un'applicazione già installata (WordPress, Docker, un pannello di hosting).
- RAM, disco e vCPU si contano sulle risorse assegnate alle VPS. Per ogni nodo scegli quanto vendere in più (overbooking) e se la RAM può usare il disco quando serve; la RAM che le VPS liberano torna al nodo.
- Firewall, volumi e IP flottanti: ogni VPS può avere un firewall suo, applicato dal nodo; i dischi aggiuntivi sono volumi che si staccano e si collegano a un'altra VPS; gli IP aggiuntivi passano da una VPS all'altra dello stesso cliente. Vedi Firewall, volumi e IP flottanti.
- Self-service (facoltativo, spento di default): oltre alle VPS dei piani puoi vendere un pacchetto di risorse con cui il cliente crea, cambia e cancella da solo le sue VPS; il pannello conta l'uso a ore per la fatturazione. Vedi Self-service e uso a ore.
- I fornitori (OVHcloud, Hetzner, Contabo, Scaleway) si collegano con le loro chiavi API: il pannello prende da lì gli IP aggiuntivi e, se vuoi, rivende le loro VPS col tuo marchio.
- Licenza: senza chiave il pannello funziona in prova per 30 giorni con 1 nodo e 5 VPS, con tutte le funzioni; con la licenza paghi per nodo. Le VPS dei clienti non si spengono mai per la licenza. Vedi Licenza.
- Copia del pannello: ogni notte il pannello salva una copia cifrata di sé in una destinazione dei backup, per ripartire su un altro server se il suo si perde. Vedi Aggiornamenti e versioni.
Chi vede cosa
| Amministratore | Cliente | |
|---|---|---|
| Indirizzo | /admin | / (area clienti col tuo marchio) |
| VPS | tutte | solo le sue |
| Nodi, IP, piani, fornitori | sì | no |
| Snapshot e backup | sì | nei limiti del piano |
| Team e chiavi API | — | persone con un ruolo (amministratore, tecnico, sola lettura) e chiavi per gli script |
| Load balancer | tutti, per i clienti | i suoi, se compresi nel servizio |
Requisiti
- Pannello: Debian 12/13 o Ubuntu 22.04/24.04, 1 vCPU e 1 GB di RAM bastano. Per l'HTTPS automatico servono un nome di dominio e le porte 80 e 443 libere.
- Nodi: un server Debian o Ubuntu con la virtualizzazione attiva (KVM). Il pannello lo prepara da solo (ZFS e Incus 7.0 LTS); un server con Incus 6 o più recente già installato si collega con un token. Consigliato uno storage pool ZFS; vanno bene anche LVM, dir e btrfs.
- Rete: un bridge per le VPS sul nodo (di solito
br-vps) oppure gli IP dei fornitori (il pannello crea da solo le schede giuste).
Da dove cominciare
Appena installato, la Panoramica mostra i Primi passi: marchio, primo nodo, IP, prima VPS, email, destinazione dei backup, copia del pannello, avvisi e licenza. Ogni passo si spunta da solo quando è fatto e ha il pulsante Vai per la pagina giusta; la scheda sparisce quando hai finito, o prima con Nascondi.