Instalando Maia Mailguard En Debian Squeeze (Usuarios/Dominios Virtuales Con Postfix/MySQL)

Versión 1.0
Autores: Falko Timme, Dominik Najberg

Esta guía explica cómo instalar Maia Mailguard, un sistema de gestión de spam y virus, en un servidor de correo Debian Squeeze. Maia Mailguard es una interfaz web y un sistema de gestión basado en el popular escáner de correo amavisd-new y SpamAssassin. Escrito en Perl y PHP, Maia Mailguard otorga a los usuarios finales control sobre cómo se procesa su correo por los escáneres de virus y filtros de spam, mientras que otorga a los administradores de correo el poder de configurar valores y límites predeterminados a nivel de sitio.

¡No emito ninguna garantía de que esto funcione para ti!

1 Nota Preliminar

Este tutorial se basa en Usuarios Y Dominios Virtuales Con Postfix, Courier, MySQL Y SquirrelMail (Debian Squeeze), así que deberías tener esto configurado ya. Si tu configuración de correo es diferente, este tutorial podría no funcionar para ti, o podrías tener que hacer algunos ajustes.

Mi servidor tiene el nombre de host mail.example.com y la dirección IP 192.168.0.1. Instalaré la interfaz web de Maia en la raíz del documento predeterminada de lighttpd de Debian, /var/www, y usaré www.example.com para acceder a la interfaz web. Tendrás que ajustar esto si tu raíz del documento y tu dominio son diferentes.

2 Descargando Maia Mailguard

Maia Mailguard solo se puede descargar desde SVN, así que primero tenemos que instalar Subversion:

aptitude install subversion

Quiero descargar las fuentes en /usr/src/maia:

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

Abre un navegador y ve a https://www.maiamailguard.com/svn/branches/1.0 para averiguar cuál es la última revisión; en mi caso fue 1578. Luego comienza la descarga de la siguiente manera:

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

(Asegúrate de reemplazar 1578 con la última revisión.)

3 Creando Una Base De Datos Para Maia Mailguard

A continuación, inicia sesión en MySQL…

mysql -u root -p

… y crea una base de datos llamada maia:

CREATE DATABASE maia;

Sal del shell de MySQL después:

quit;

Importa el volcado SQL de Maia en la base de datos maia vacía:

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

Luego inicia sesión en MySQL nuevamente…

mysql -u root -p maia

… y crea un usuario de MySQL llamado amavis:

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

FLUSH PRIVILEGES;

Soluciona el problema de la columna desconocida ‘discard_ham’ que impide que los correos electrónicos se envíen a cualquier lugar:

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

Sal de MySQL:

quit;

(Puedes reemplazar amavismysqlpasswd con una contraseña de tu elección, pero ten en cuenta que tendrás que usar esa contraseña más adelante en la configuración de Maia!)

A continuación, asegúrate de tener un valor lo suficientemente grande para max_allowed_packet en tu /etc/mysql/my.cnf (en la sección [mysqld]). Esta configuración determina el tamaño del mayor elemento de correo que podrás procesar con Maia, así que asegúrate de establecer este valor lo suficientemente grande para satisfacer tus necesidades.

nano /etc/mysql/my.cnf

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

Reinicia MySQL si has cambiado el valor de max_allowed_packet:

/etc/init.d/mysql restart

4 Instalando Los Scripts Y Plantillas De Maia

El directorio home del usuario amavis en Debian Squeeze es /var/lib/amavis, y ahí es donde creamos un subdirectorio llamado maia. En ese subdirectorio colocaremos los scripts y plantillas de 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 Configurando Maia

A continuación, renombramos /usr/src/maia/1.0/maia.conf.dist a /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

Abre /etc/maia/maia.conf y ajusta las siguientes configuraciones:

nano /etc/maia/maia.conf

| [...] # Configura tu DSN de base de datos Maia aquí $dsn = "DBI:mysql:maia:localhost:3306"; # El nombre de usuario de tu base de datos Maia $username = "amavis"; # La contraseña de tu usuario de base de datos Maia $password = "amavismysqlpasswd"; # El directorio donde se pueden encontrar los scripts Perl de Maia. $script_dir = "/var/lib/amavis/maia/scripts"; [...] # Ubicación para escribir los archivos de bloqueo/PID (debe ser escribible por tu # usuario amavis) $pid_dir = "/var/lib/amavis/"; [...] # URL base para los scripts PHP de Maia $base_url = "http://www.example.com/"; # Directorio de plantillas $template_dir = "/var/lib/amavis/maia/templates/"; [...] |

Asegúrate de llenar la contraseña correcta para el usuario MySQL amavis en la línea $password. También llena la URL correcta en la línea $base_url.