Installazione di Maia Mailguard su Debian Squeeze (Utenti/Domini Virtuali con Postfix/MySQL)

Versione 1.0
Autori: Falko Timme, Dominik Najberg

Questa guida spiega come installare Maia Mailguard, un sistema di gestione di spam e virus, su un server di posta Debian Squeeze. Maia Mailguard è un’interfaccia web e un sistema di gestione basato sul popolare scanner di email amavisd-new e SpamAssassin. Scritto in Perl e PHP, Maia Mailguard offre agli utenti finali il controllo su come la loro posta viene elaborata da scanner di virus e filtri antispam, mentre offre agli amministratori di posta il potere di configurare impostazioni e limiti globali.

Non fornisco alcuna garanzia che questo funzionerà per te!

1 Nota Preliminare

Questo tutorial si basa su Utenti e Domini Virtuali con Postfix, Courier, MySQL e SquirrelMail (Debian Squeeze), quindi dovresti averlo già configurato. Se la tua configurazione di posta è diversa, questo tutorial potrebbe non funzionare per te, oppure potresti dover apportare alcune modifiche.

Il mio server ha il nome host mail.example.com e l’indirizzo IP 192.168.0.1. Installerò l’interfaccia web di Maia nella root del documento predefinita di lighttpd di Debian, /var/www, e utilizzerò www.example.com per accedere all’interfaccia web. Dovrai regolare questo se la tua root del documento e il tuo dominio differiscono.

2 Download di Maia Mailguard

Maia Mailguard può essere scaricato solo da SVN, quindi dobbiamo prima installare Subversion:

aptitude install subversion

Voglio scaricare i sorgenti in /usr/src/maia:

mkdir /usr/src/maia  
cd /usr/src/maia

Apri un browser e vai su https://www.maiamailguard.com/svn/branches/1.0 per scoprire qual è l’ultima revisione - nel mio caso era 1578. Poi inizia il download come segue:

svn -r 1578 checkout https://www.maiamailguard.com/svn/branches/1.0

(Assicurati di sostituire 1578 con l’ultima revisione.)

3 Creazione di un Database per Maia Mailguard

Successivamente accedi a MySQL…

mysql -u root -p

… e crea un database chiamato maia:

CREATE DATABASE maia;

Esci dalla shell di MySQL:

quit;

Importa il dump SQL di Maia nel database maia vuoto:

cd /usr/src/maia/1.0/  
mysql -u root -p maia < maia-mysql.sql

Poi accedi di nuovo a MySQL…

mysql -u root -p maia

… e crea un utente MySQL chiamato amavis:

GRANT CREATE, DROP, ALTER, SELECT, INSERT, UPDATE, DELETE ON maia.* TO amavis@localhost IDENTIFIED BY 'amavismysqlpasswd';

FLUSH PRIVILEGES;

Correggi il problema della colonna sconosciuta ‘discard_ham’ che impedisce l’invio di email:

ALTER TABLE users ADD COLUMN discard_ham char(1) NOT NULL default 'N'

Esci da MySQL:

quit;

(Puoi sostituire amavismysqlpasswd con una password a tua scelta, ma tieni presente che dovrai utilizzare quella password più avanti nella configurazione di Maia!)

Successivamente assicurati di avere un valore sufficientemente grande per max_allowed_packet nel tuo /etc/mysql/my.cnf (nella sezione [mysqld]). Questa impostazione determina la dimensione del più grande elemento di posta che sarai in grado di elaborare con Maia, quindi assicurati di impostare questo valore abbastanza grande da soddisfare le tue esigenze.

nano /etc/mysql/my.cnf

| [...] [mysqld] [...] max_allowed_packet = 16M [...] |

Riavvia MySQL se hai cambiato il valore di max_allowed_packet:

/etc/init.d/mysql restart

4 Installazione degli Script e dei Template di Maia

La home directory dell’utente amavis su Debian Squeeze è /var/lib/amavis, ed è lì che creiamo una sottodirectory chiamata maia. In quella sottodirectory posizioneremo gli script e i template di Maia:

mkdir /var/lib/amavis/maia  
mkdir /var/lib/amavis/maia/scripts  
mkdir /var/lib/amavis/maia/templates

cp -pfr /usr/src/maia/1.0/scripts/* /var/lib/amavis/maia/scripts  
cp -pfr /usr/src/maia/1.0/templates/* /var/lib/amavis/maia/templates

chown -R amavis /var/lib/amavis/maia  
chgrp -R amavis /var/lib/amavis/maia  
chmod 640 /var/lib/amavis/maia/templates/*.tpl  
chmod 750 /var/lib/amavis/maia/scripts/*.pl

5 Configurazione di Maia

Successivamente rinominiamo /usr/src/maia/1.0/maia.conf.dist in /etc/maia/maia.conf:

mkdir /etc/maia/  
cp /usr/src/maia/1.0/maia.conf.dist /etc/maia/maia.conf  
chown amavis /etc/maia/maia.conf  
chgrp amavis /etc/maia/maia.conf  
chmod 640 /etc/maia/maia.conf

Apri /etc/maia/maia.conf e regola le seguenti impostazioni:

nano /etc/maia/maia.conf

| [...] # Configura il tuo DSN del database Maia qui $dsn = "DBI:mysql:maia:localhost:3306"; # Il nome utente del tuo database Maia $username = "amavis"; # La password del tuo utente del database Maia $password = "amavismysqlpasswd"; # La directory dove si trovano gli script Perl di Maia. $script_dir = "/var/lib/amavis/maia/scripts"; [...] # Posizione per scrivere i file di lock/PID (deve essere scrivibile dal tuo # utente amavis) $pid_dir = "/var/lib/amavis/"; [...] # URL di base per gli script PHP di Maia $base_url = "http://www.example.com/"; # Directory dei template $template_dir = "/var/lib/amavis/maia/templates/"; [...] |

Assicurati di inserire la password corretta per l’utente MySQL amavis nella riga $password. Compila anche l’URL corretto nella riga $base_url.