Guida · Per gli amministratori
Nodi nuovi e acquisto automatico
Dalla 0.9 il pannello prepara i nodi da solo. Parte da un server che hai già o da uno che ordina per te a un fornitore. Installa ZFS e Incus 7.0 LTS, crea il pool per le VPS e la rete, poi collega il server come nodo. Il nodo entra anche nei tunnel delle reti private. Tutto da Nodi › Aggiungi nodo.
Un server che hai già
Serve un server x86_64 appena installato con Debian 12 o 13 (oppure Ubuntu 22.04 o 24.04), con la virtualizzazione attiva e almeno 4 GB di RAM. Per le VPS serve anche uno di questi spazi:
- un disco vuoto, senza partizioni;
- spazio non partizionato su un disco GPT (almeno 20 GB);
- una partizione montata su
/var/lib/koavm-data, che diventa il pool ZFS.
Con due dischi il pool è in mirror, con tre o più è in raidz.
- Scrivi l'indirizzo del server, la porta SSH e l'utente (
root, oppure un utente consudosenza password). Sui server OVHcloud e nelle immagini cloud la chiave messa all'installazione vale perdebianoubuntu, erootrisponde «Please login as the user…»: lasciaroot, il pannello se ne accorge ed entra con l'utente giusto. - Dai la password, oppure metti la chiave del pannello in
authorized_keys: la trovi sotto «Senza password». - Premi Controlla il server. Il pannello entra e legge sistema, CPU, RAM e dischi, senza cambiare niente.
- Scegli il nome del nodo (es.
gra-02), la città sulla mappa e l'overbooking: rapporti di RAM, disco e CPU e se la RAM può usare il disco (swap). Vedi Nodi. Poi premi Prepara il nodo.
La password serve solo per il primo accesso. Il pannello mette subito la sua chiave e la cancella appena la preparazione è finita. Di solito servono 5–10 minuti, perché il modulo ZFS si compila sul server. Il registro si segue in Nodi in preparazione.
Se qualcosa si ferma, per esempio perché serve un riavvio o manca lo spazio, trovi l'errore nel registro. Riprova riparte dal passo fermo: la preparazione si può ripetere senza problemi.
Secure Boot va spento: su Debian il modulo ZFS compilato sul server con Secure Boot attivo non viene caricato. Il controllo lo segnala prima di partire.
Porte. Il pannello parla con Incus sulla porta 8443 (TCP) del nodo e i nodi si collegano fra loro sulla 51888 (UDP) (reti private). Con ufw o firewalld la preparazione apre da sola la 8443 solo verso l'IP del pannello, la 51888, il bridge br-vps e l'inoltro del traffico delle VPS (ufw di suo lo blocca e le VPS resterebbero senza internet). Con un altro firewall (nftables a mano, il firewall del fornitore) aprile tu: Controlla il server prova la 8443 dal pannello e avvisa se non risponde.
La rete br-vps
Nelle opzioni avanzate scegli come nasce br-vps, il bridge per i blocchi di IP del nodo:
- Rete interna con NAT (predefinita):
10.89.x.1/24con uscita in NAT. Il pannello crea da solo il blocco «nome del nodo (rete NAT)» con gli indirizzi da .10 a .250, così si creano VPS subito. - Collegata a una scheda: il bridge prende una scheda del server senza indirizzo, per esempio una rete privata del fornitore.
Gli IP pubblici dei fornitori collegati (OVHcloud, Hetzner, Contabo, Scaleway) non passano da br-vps: il pannello li collega da solo all'interfaccia pubblica del nodo.
Se il server ha un indirizzo IPv6 pubblico (OVHcloud e Hetzner danno un /64 a ogni dedicato), il pannello crea anche il blocco «IPv6 nome del nodo» con quel /64: ogni VPS prende un suo IPv6 pubblico. Se il tuo fornitore non manda al server tutto il /64, togli il blocco da Rete e IP.
Un server del tuo account
Con un account OVHcloud (dedicati), Hetzner Robot o Scaleway Dedibox collegato in Rete e IP › Fornitori, la scheda Server del tuo account mostra i suoi server dedicati. Scegli il server, il nome del nodo e la città, poi scrivi il nome del server per confermare: il pannello lo reinstalla con Debian 13, la sua chiave e le partizioni per il nodo (40 GB per il sistema, il resto per le VPS), aspetta la fine dell'installazione presso il fornitore e lo prepara come sopra. Di solito 20–30 minuti.
La reinstallazione cancella tutto quello che c'è sul server. I server che sono già nodi del pannello non si possono scegliere.
Un server da ordinare
Con un account OVHcloud (dedicati), Hetzner Robot o Scaleway Dedibox collegato in Rete e IP › Fornitori, la scheda Ordina un server mostra il catalogo del fornitore. Per ogni server vedi CPU, RAM, dischi, datacenter disponibili, prezzo al mese, attivazione e tempi di consegna. Ci sono Kimsufi, So you Start, Rise e Advance di OVHcloud, il listino e le aste di Hetzner e le Dedibox.
- Scegli il server, il datacenter e il nome del nodo.
- Chiedi il prezzo: il pannello prepara l'ordine presso il fornitore e legge il prezzo esatto, cioè il canone e il primo pagamento.
- Spunta la conferma e premi Ordina il server.
Se nel frattempo il prezzo cambia, l'ordine non parte e il pannello mostra quello nuovo.
Il pagamento usa il metodo predefinito dell'account del fornitore. Poi il pannello fa tutto da solo:
- aspetta la consegna;
- installa Debian con le partizioni per il nodo (con l'API di OVHcloud e Scaleway; per Hetzner dal rescue con installimage);
- prepara il nodo come sopra;
- lo collega all'account del fornitore, così gli IP aggiuntivi e la disdetta funzionano subito.
Per Hetzner gli ordini via API vanno attivati una volta nel Robot (Impostazioni › Web service › Ordini).
Capacità e acquisto automatico
La scheda Capacità e acquisto automatico in Nodi mostra RAM e disco liberi per città, calcolati sulle risorse assegnate alle VPS rispetto a quelle assegnabili con l'overbooking di ogni nodo. Un nodo che ha superato il freno sull'uso vero conta come pieno. I nodi ordinati dal pannello prendono overbooking e swap predefiniti di Impostazioni › Nodi e overbooking. Una regola dice cosa fare quando lo spazio finisce:
- nodi controllati: una città o tutti i nodi;
- soglie: RAM libera sotto il N% o disco libero sotto il N%;
- server da ordinare: account, offerta e datacenter;
- quando serve:
- Proponi e aspetta il mio sì: il pannello prepara l'ordine e ti avvisa. Lo confermi in Nodi in preparazione con il prezzo aggiornato.
- Ordina da solo: il pannello ordina senza aspettarti, ma solo dentro il tetto al mese per gli ordini automatici e il numero massimo di nodi al mese. Oltre il tetto torna a proporre.
Il tetto parte da 0, e con il tetto a 0 le regole propongono soltanto. Il controllo gira ogni 10 minuti. Finché un nodo della regola è in arrivo non ne ordina un altro, e dopo un nodo pronto aspetta un giorno. Gli avvisi Spazio in esaurimento, Server ordinato, Nodo pronto e Preparazione ferma arrivano sui canali di Avvisi.
Dismettere un nodo
Dismetti toglie dal pannello un nodo vuoto: prima usa Svuota nodo per spostare le VPS. Il pannello toglie il proprio certificato dal server e aggiorna i tunnel delle reti private. Se il nodo è collegato a un account del fornitore puoi anche disdire il server:
- OVHcloud: niente rinnovo, il server si cancella alla scadenza;
- Hetzner: disdetta alla prima data possibile;
- Scaleway: cancellazione del server.
Per confermare si scrive il nome del nodo.