← Tutti i progetti
Attivo agosto 2026

Pulizia automatica della posta (ADMailCleaner)

Un servizio che controlla più caselle IMAP a ciclo continuo e sposta nel cestino la posta indesiderata in base al mittente — niente più pulizia manuale della casella.

PythonDockerIMAPWSL2Automazione

Il problema

Alcune caselle email accumulano regolarmente posta indesiderata da mittenti sempre uguali — newsletter mai disiscritte, notifiche automatiche, promozioni. Pulirle a mano è noioso e si finisce per rimandare.

Come funziona

Un servizio containerizzato in Python controlla a ciclo continuo più caselle IMAP (sia self-hosted che Gmail), e per ogni mittente configurato marca come letta e sposta nel cestino la posta corrispondente. Le regole di corrispondenza sono flessibili: indirizzo esatto, intero dominio, o una sottostringa nel mittente — la ricerca IMAP fa un primo filtro grossolano, poi il campo From: reale viene riconfermato prima di agire, per evitare falsi positivi.

Un bug che non era del progetto, ma dell’host

Il momento più istruttivo non è stato nel codice del servizio, ma nell’infrastruttura che lo ospita. A un certo punto tutti i container Docker della macchina hanno smesso di colpo di avere accesso a Internet — non solo questo servizio, l’intero stack di automazioni di casa. La causa: le regole di firewall che permettono il traffico in uscita (FORWARD) coprivano solo l’interfaccia di rete predefinita di Docker, mentre ogni rete creata dai singoli progetti Docker Compose ne aveva bisogno di una propria — un dettaglio silenzioso, senza errori espliciti, solo connessioni che restavano appese.

La correzione è stata riavviare il motore Docker per far rigenerare l’intero set di regole di firewall corrette, con questo servizio (e un altro critico) impostato per usare in aggiunta l’interfaccia di rete predefinita come rete di riserva. Un promemoria utile: quando tutti i servizi smettono di funzionare insieme, il problema raramente è in uno di essi.

Stato

Attivo e in produzione, gira su un motore Docker nativo Linux (migrato da Docker Desktop per maggiore affidabilità), con più caselle email collegate contemporaneamente. Miglioramenti possibili: corrispondenza anche sull’oggetto, un riepilogo periodico di cosa è stato spostato, ricaricare la configurazione senza riavviare il container.

Stack

Python · IMAP · Docker · WSL2