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.