SYSADMIN JOURNAL / Linux · Networking · Security · HostingProcedure, appunti e soluzioni tecniche
Apache

ISPConfig: personalizzare i template dei virtual host senza perdere le modifiche agli aggiornamenti

Pubblicato il 18/11/2026

Il problema

Modificare direttamente un file generato in sites-available è fragile: ISPConfig può rigenerarlo quando cambi un sito dal pannello, annullando le direttive inserite a mano.

Procedura di diagnostica

Si parte dai controlli non distruttivi, si identificano i processi o i servizi responsabili e soltanto dopo si interviene sulla configurazione. I percorsi e gli host riportati sono esempi da adattare al proprio ambiente.

ls -la /usr/local/ispconfig/server/conf/
ls -la /usr/local/ispconfig/server/conf-custom/
find /usr/local/ispconfig/server/conf -maxdepth 1 -iname '*vhost*' -print
# Copiare solo il template adatto alla versione in conf-custom

Interpretazione e soluzione

ISPConfig cerca template personalizzati in conf-custom, con nomenclatura dipendente dal tipo di vhost e dalla release. Prima individua il template sorgente originale, effettua una copia e modifica esclusivamente la parte necessaria. Non inventare nomi di file o segnaposto: confronta il template effettivamente installato. Effettua un test con un sito staging, rigenera la configurazione e verifica nginx -t o apache2ctl configtest. Una modifica in conf-custom può incidere su molti vhost: conserva un piano di rollback.

Checklist prima del rilascio

  • Backup dei file interessati e verifica dello stato iniziale.
  • Test del caso che ha generato l’errore, con log e timestamp verificabili.
  • Applicazione graduale della modifica, controllo sintattico dove previsto e verifica dopo il riavvio.
  • Rollback rapido se compare una regressione o un falso positivo.

Approfondimenti: GeoIP su Apache e debug redirect Apache.