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

Apache mod_lua: diagnosticare errori 500 nell’AccessChecker

Pubblicato il 18/11/2026

Il problema

Un access checker Lua difettoso può provocare HTTP 500 a tutte le richieste soggette al controllo. Un semplice apache2ctl configtest non verifica i percorsi logici eseguiti durante una richiesta.

Procedura tecnica

Partiamo da una configurazione minima e riproducibile, da adattare al proprio virtual host. I valori e i nomi esemplificativi non vanno copiati senza controllo.

apache2ctl configtest
ls -l /etc/apache2/browser-check.lua
journalctl -u apache2 -n 80 --no-pager
tail -n 100 /var/log/apache2/error.log

Interpretare il risultato e prevenire errori

Verifica permessi di lettura del Lua per il processo Apache, librerie utilizzate e messaggi del runtime. Esegui una richiesta che bypassa il gate e una che dovrebbe attivarlo. Non mettere chiavi di firma nel codice pubblicato o nei log. Conserva sempre una procedura rapida per disattivare l'hook.

Controlli finali

Conserva il backup, esegui apache2ctl configtest, verifica le risposte prima e dopo un reload e controlla i log di Apache. I test devono includere gli accessi da dispositivi mobili, il dominio con e senza www e gli eventuali reverse proxy.

Approfondimenti: GeoIP su Apache e challenge mod_lua.