KoaVM
Pagine della guida

Guida · Per gli amministratori

Clienti e VPS

Clienti

In Clienti e piani › Clienti crei i clienti (nome, azienda, email). Al cliente nuovo il pannello genera una password da dargli; da lì puoi anche generarne una nuova. I clienti creati dall'API (WHMCS, KoaBilling) nascono da soli, riconosciuti per email.

Con il self-service acceso, Self-service dà al cliente un pacchetto di risorse con cui crea da solo le sue VPS: vedi Self-service e uso a ore.

Team e chiavi API del cliente

Dalla 0.13 ogni cliente invita nel suo conto altre persone (pagina Team e API dell'area clienti), ognuna con la sua email, la sua password e un ruolo: amministratore (tutto quello che fa il cliente), tecnico (lavora sulle VPS ma non le crea e non le cancella) o sola lettura. Il cliente crea anche chiavi API con un ruolo per i suoi script: valgono sull'API del pannello (/api/…), con gli stessi permessi dell'interfaccia, non su /api/v1.

Dalla 1.13 il segno 2FA accanto al nome dice che il cliente ha la verifica in due passaggi; il pulsante con lo scudo gliela toglie se ha perso il telefono e i codici di recupero (vedi Verifica in due passaggi).

Nell'elenco dei clienti, sotto il nome, compaiono quante persone e chiavi ha il cliente. Il pulsante con il badge apre Team, chiavi API e registro: togli una persona (esce subito da tutte le sessioni), la sua verifica in due passaggi o una chiave, e leggi chi ha fatto cosa nel conto del cliente. Ogni email entra in un solo conto: un cliente nuovo non può avere l'email di una persona del team di un altro.

Creare una VPS

VPS › Crea VPS:

  • cliente e piano;
  • sistema, con le icone: quelli che non vanno con il piano restano spenti con il motivo (RAM o disco minimi, piani permessi);
  • applicazione da installare al primo avvio (facoltativa): si vedono solo quelle che vanno con il sistema e con il piano;
  • nome host (es. web1.esempio.it);
  • nodo o zona (vuoto = il nodo con più RAM ancora assegnabile);
  • password di root (di Administrator per Windows) o chiave SSH;
  • un'ISO da montare (facoltativa, in Avvio da un'ISO), per esempio per installare a mano dalla console grafica.

La creazione è un lavoro in coda: in meno di un minuto una VPS Linux è accesa e raggiungibile; Windows ci mette qualche minuto in più. Un'applicazione si installa dopo, mentre la VPS è già accesa: lo stato è nella pagina della VPS.

Il pannello controlla che sul nodo ci sia posto: RAM e disco assegnati con l'overbooking del nodo e il freno sull'uso vero.

Se il nome host è un dominio completo e l'IP è di un fornitore collegato, il pannello imposta anche il DNS inverso.

La pagina della VPS

  • Accendi, Spegni, Riavvia, e Spegni forzato se il sistema non risponde.
  • Console: seriale o grafica (lo schermo vero della VM), nel browser. Windows e le VPS che partono da un'ISO aprono subito quella grafica; per le VPS Hetzner Cloud c'è quella grafica del fornitore.
  • Genera nuova password: nuova password di root (la VPS deve essere accesa: la cambia l'agente dentro la VPS). Su Windows la password si cambia dal desktop remoto.
  • Reinstalla il sistema: cancella il disco e gli snapshot e riparte da zero con lo stesso IP, anche con un altro sistema o un'applicazione; va confermata scrivendo il nome host. I backup restano.
  • Applicazione: passo dell'installazione, alla fine indirizzo, utente e password, e il registro.
  • CD / ISO: monta un'ISO, anche con avvio dal CD, e la smonta.
  • Snapshot e backup: vedi Backup e snapshot.
  • Rete: IPv4, IPv6, MAC, velocità, DNS inverso; gli IP aggiuntivi si spostano su un'altra VPS del cliente.
  • Firewall: regole sul traffico in entrata, applicate dal nodo. Vedi Firewall, volumi e IP flottanti.
  • Grafici: CPU, RAM, disco e traffico del mese.

Solo per te:

  • Cambia piano: CPU e RAM cambiano al riavvio (puoi riavviare subito), il disco cresce subito e il file system si allarga al riavvio. Il disco non si può ridurre. I limiti del disco e della CPU del piano nuovo valgono entro 30 secondi, anche a VPS accesa. Senza riavvio, se il disco principale della VPS è virtio-blk (quasi tutte le VPS Linux) cresce subito ma la sua dimensione nella configurazione si aggiorna alla prima volta che la VPS è spenta (accensione o riavvio dal pannello, o da sola entro qualche minuto se la spegni): il lavoro lo dice.
  • Risorse su misura: vCPU, RAM, disco (solo in su), velocità e traffico di questa VPS, senza cambiare piano. Il pannello controlla che sul nodo ci sia posto (overbooking del nodo e freno sull'uso vero). Accanto al piano compare «su misura»; un cambio piano rimette i valori del piano. Dalla 1.14 anche i limiti del disco e della CPU: togli la spunta Come il piano e scegli quelli di questa VPS (valgono entro 30 secondi, anche a VPS accesa; vedi Piani e sistemi).
  • Dischi aggiuntivi (vedi sotto).
  • Sospendi / Riattiva con un motivo (amministratore, pagamento, traffico, abuso): la VPS si spegne e il cliente non può riaccenderla.
  • Aggiungi IPv6 / Riconfigura.
  • Elimina: cancella la VPS, i suoi backup e libera gli IP.

Modalità di soccorso

Avvia in modalità di soccorso (lo fanno anche il cliente e il suo team, amministratori e tecnici) riavvia la VPS in un sistema Debian 13 con la sua rete, l'accesso SSH di root con una password temporanea (mostrata una volta) e il disco della VPS collegato ma non montato. Cosa vede il cliente è in La tua VPS.

Come funziona sul nodo:

  • la prima volta su un nodo (e pool) il nodo scarica l'immagine cloud Debian 13 «generic» da cloud.debian.org (controllata con SHA512SUMS, tenuta in /var/lib/koavm-rescue) e il pannello ne fa il disco base koavm-rescue-base-… sul pool predefinito; servono curl, qemu-img e sgdisk o sfdisk (la preparazione dei nodi li installa). L'immagine parte con BIOS e con UEFI. Il disco base ha identificativi suoi (PARTUUID nuovo, grub che cerca un file segnaposto e non l'UUID): un disco del cliente nato dalla stessa immagine non viene scambiato per il sistema di soccorso;
  • per ogni soccorso una copia veloce del disco base (koavm-rescue-<id>, su ZFS un clone) in cui il pannello scrive il seme NoCloud locale (instance-id nuovo, password, chiavi, rete della VPS). La VPS si spegne, la copia si collega con la priorità di avvio più alta e la VPS si riaccende. La configurazione cloud-init della VPS non cambia: all'uscita il sistema del cliente non rifà il primo avvio;
  • Esci, o dopo 24 ore da solo: spegne, stacca e cancella la copia, riaccende la VPS. Se l'uscita automatica non riesce, il pannello riprova con attese crescenti (5 minuti, poi 10, 20… fino a 6 ore) e manda l'avviso Modalità di soccorso: uscita non riuscita. Se il pannello si riavvia a metà, o un soccorso resta a metà senza il suo lavoro, il pannello rimette la VPS com'era.

Durante il soccorso la VPS è nello stato In soccorso (anche nell'elenco delle VPS): niente snapshot, backup (quelli automatici si saltano), spostamenti, reinstallazioni, cambi di piano e di pool. Non c'è per le VPS dei fornitori, per quelle sospese e per le macchine dei load balancer e dei router. Per preparare il disco base prima che serva (o rifarlo da un mirror): POST /api/admin/nodes/{id}/rescue-base con {"url": "https://…/trixie/latest"} facoltativo (solo https://, o file:// per un'immagine già sul nodo; un'immagine che rimanda ad altri file, backing file o data file, si rifiuta); GET /api/admin/rescue-bases dice lo stato su ogni nodo. Il disco base di prima si cancella appena nessun soccorso lo usa più. Sui pool LVM non thin la parte del disco base oltre l'immagine si azzera.

Dischi aggiuntivi

Nel riquadro Dischi aggiuntivi della VPS: Aggiungi disco con la dimensione in GB. Il disco si collega subito, anche a VPS accesa. Se lasci attivo Formattalo e montalo, il pannello lo prepara con l'agente (ext4) e lo monta nella cartella scelta (di solito /mnt/disco1, /mnt/disco2…), con una riga in /etc/fstab che lo rimonta ai riavvii. Su Windows il disco si prepara da Gestione disco.

  • Allarga: il disco cresce subito e, se l'ha montato il pannello, anche il filesystem, senza spegnere la VPS. Un disco non si può ridurre.
  • Monta: per un disco non ancora montato (per esempio aggiunto a VPS spenta).
  • Stacca: smonta e scollega il disco senza cancellarlo: diventa un volume staccato, che si collega a un'altra VPS dello stesso cliente sullo stesso nodo (pagina Volumi). Lo può fare anche il cliente, come Monta.
  • Togli: smonta il disco, lo scollega e lo cancella. Va confermato scrivendo il nome del disco (es. disk1).

I dischi aggiuntivi sono compresi negli snapshot e nei backup e contano nello spazio del nodo. Dopo una reinstallazione il sistema nuovo li rimonta dove erano. Le VPS arrivate con la migrazione mostrano da sole i loro dischi in più.

Lavori

In Lavori c'è tutto quello che il pannello fa, con chi l'ha chiesto, quanto è durato e l'eventuale errore. Un lavoro non riuscito si può riprovare (pulsante Riprova). Su ogni nodo i lavori pesanti (creazioni, migrazioni, backup, ripristini) vanno uno alla volta.