L'installazione
Esapanel si installa su un server Debian 13 appena installato, fisico o virtuale (VMware, Hyper-V, Proxmox e gli altri ambienti KVM), anche un VPS. Uno script aggiunge il repository dei pacchetti, installa il pacchetto esapanel e lancia esapanel-setup, che configura il server e il pannello.
Prima di cominciare
- Debian 13 appena installato, architettura amd64 o arm64, con accesso da root.
- Il nome completo definitivo del server, come
log.example.com, e il suo indirizzo definitivo: il pannello li usa per il suo certificato e per la licenza. Il nome deve risolversi nell'indirizzo. - Accesso a Internet in uscita: il repository dei pacchetti in HTTPS (porta 443) e il server delle licenze (
license.esalogica.com, porta 9444). Un server senza Internet non può attivare né controllare la licenza. - Il codice di attivazione della licenza, se lo hai già: si può inserire anche dopo, nel pannello.
- Per i moduli che conservano molti dati (i log di CSP, le copie fuori sede di WFP), un disco o una partizione a parte, montata prima dell'installazione: vedi I dischi consigliati. Per cifrare i dati, il disco resta vuoto e non montato: vedi La cifratura dei dati.
I dischi consigliati
Un'idea pratica per preparare Debian prima dell'installazione; non è un obbligo:
| Dove | Quanto | Che cosa |
|---|---|---|
| Disco del sistema | 20–30 GB | Debian e Esapanel; con l'avvio UEFI anche la partizione EFI da 512 MB |
| Swap | 2–4 GB | anche un file di swap va bene |
| Disco dei dati, a parte | secondo i moduli | i database e i file del pannello: i log di CSP (Central Syslog), i report, gli archivi. Vuoto, se vuoi cifrarli |
| Un disco per ogni datastore di WFP (Web File) | lo spazio che offri | il primo con --wfp-datastore, gli altri con --wfp-add-datastore; anche cifrati |
| Backup del server | — | meglio fuori dal server, su una destinazione remota; altrimenti un disco a parte con --backups-path |
- Il disco dei dati si divide in due partizioni, o due volumi LVM, montate prima dell'installazione:
/var/lib/postgresqlper i database, la parte più grande, e/var/lib/esapanelper gli archivi e i file del pannello. - Per cifrare i dati il disco dei dati resta invece vuoto, senza partizioni né file system: lo prepara
--encrypt-data(vedi La cifratura dei dati). - Quanto spazio per CSP: circa 0,35 GB ogni milione di log, finché restano consultabili; gli archivi compressi occupano molto meno. Conta i log che i tuoi apparati mandano in un giorno per i giorni consultabili del piano, e tieni margine.
- Su una macchina virtuale è più semplice aggiungere un secondo disco virtuale che dividere il primo: si allarga dall'hypervisor senza toccare il sistema.
Installare
Come root:
wget -qO install.sh https://repo.esalogica.com/install.sh && bash install.sh --modules=csp
Su un Debian minimale senza wget, prima: apt-get install -y wget ca-certificates.
Lo script controlla il sistema, il nome e l'architettura, aggiunge la chiave e il repository dei pacchetti, installa esapanel e lancia esapanel-setup. Se mancano i dati dell'amministratore, li chiede.
Le opzioni
Le opzioni di install.sh passano a esapanel-setup:
| Opzione | Che cosa fa |
|---|---|
--channel=stable |
Il canale dei pacchetti: stable (predefinito) o testing, per i server di prova. Solo di install.sh |
--modules=csp,ucp |
I moduli da installare: csp, csph, ucp, drp, wfp, wfph, lsp, lsph, anche insieme |
--license=ESAP-XXXX-XXXX-XXXX-XXXX |
Il codice di attivazione |
--company=, --name=, --username=, --email= |
L'azienda e l'amministratore del pannello |
--sender=panel@example.com |
Il mittente della posta del pannello; senza, panel@ seguito dal nome del server |
--ssh-port=22 |
La porta SSH che il firewall lascia aperta |
--backups-path=/var/lib/esapanel/backups |
La cartella dei backup, meglio su un disco a parte |
--wfp-datastore=/srv/wfp/ds1 |
Il primo datastore di WFP (Web File) o di WFPH, meglio il mount di un disco suo |
--encrypt-data=/dev/sdb |
Sposta i dati del pannello, alla fine, su quel disco vuoto, cifrato. Si aprono con la chiave divisa con il License Server, che vuole --license, oppure con --tang=<indirizzo> o --passphrase; senza queste due, da un terminale te lo chiede alla fine (vedi La cifratura dei dati) |
La password dell'amministratore viene chiesta, oppure letta dalla variabile d'ambiente ESAPANEL_ADMIN_PASSWORD: mai sulla riga di comando.
I moduli
| Modulo | Che cosa installa |
|---|---|
csp |
CSP (Central Syslog): la ricezione dei log |
csph |
CSPH (Central Syslog Headless): la ricezione dei log per un primario di CSP, che gli dà le sue porte. Non può stare sullo stesso server di csp |
ucp |
UCP (Uptime Check): i plugin dei check e il database dei risultati |
drp |
DRP (DMARC Report): il database dei report DMARC |
wfp |
WFP (Web File): FTPS e SFTP, rsync sulla porta 60022, WebDAV sulla 443, il datastore delle copie |
wfph |
WFPH (Web File Headless): il datastore e rsync sulla porta 60022, per ricevere le copie remote di un altro server con WFP. Con wfp sullo stesso server usa quelli di WFP |
lsp |
LSP (License Server): il server delle licenze, sulla porta 9444. Serve solo a chi vende le licenze |
lsph |
LSPH (License Server Headless): il secondario del server delle licenze, sulla porta 9444. Non può stare sullo stesso server di lsp |
Un modulo si può aggiungere dopo: esegui di nuovo esapanel-setup con tutti i moduli, quelli di prima e quello nuovo. Il modulo deve essere anche nella licenza.
Dopo l'installazione
Alla fine esapanel-setup mostra l'indirizzo del pannello:
https://log.example.com:9943
- Apri l'indirizzo. Il pannello parte con un certificato autofirmato: il browser lo segnala, ed è normale. Sostituiscilo subito con uno di Let's Encrypt (vedi Certificati, posta e DNS).
- Entra con l'amministratore creato dall'installazione.
- Se non l'hai dato con
--license, inserisci il codice di attivazione (vedi La licenza). - Conferma il mittente della posta in Server › Posta: finché non lo fai, ogni pagina te lo ricorda.
- Attiva il secondo fattore sul tuo account.
- Controlla il firewall: per esempio apri SSH solo dal tuo ufficio (vedi Rete e sicurezza).
- Imposta il backup del server su una destinazione remota (vedi Disaster recovery).
- Se hai cifrato i dati, conserva fuori dal server la chiave di recupero che l'installazione ti ha mostrato (vedi La cifratura dei dati).
Eseguire di nuovo esapanel-setup
esapanel-setup si può eseguire di nuovo quando vuoi: quello che è già configurato resta (la password del database, la chiave dell'applicazione, il certificato), il resto viene riscritto, e il pannello si installa una volta sola. Serve per aggiungere un modulo, aggiungere un datastore di WFP o riscrivere gli indirizzi IP aggiunti dal pannello.
Non modificare a mano i file che esapanel-setup scrive: eseguilo di nuovo.
La sicurezza di partenza
- Il firewall del pannello è attivo dall'installazione: aperti il pannello, SSH e le porte dei moduli.
- fail2ban protegge SSH, l'accesso al pannello e il server web.
- Gli aggiornamenti di sicurezza di Debian sono automatici.