Vai al contenuto

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.

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, ucp, drp, wfp, lsp, 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), meglio il mount di un disco suo

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
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
lsp LSP (License Server): il server delle licenze, sulla porta 9444. Serve solo a chi vende le licenze

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
  1. 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).
  2. Entra con l'amministratore creato dall'installazione.
  3. Se non l'hai dato con --license, inserisci il codice di attivazione (vedi La licenza).
  4. Conferma il mittente della posta in Server › Posta: finché non lo fai, ogni pagina te lo ricorda.
  5. Attiva il secondo fattore sul tuo account.
  6. Controlla il firewall: per esempio apri SSH solo dal tuo ufficio (vedi Rete e sicurezza).
  7. Imposta il backup del server su una destinazione remota (vedi Disaster recovery).

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.