Instalando Maia Mailguard No Debian Squeeze (Usuários/Domínios Virtuais Com Postfix/MySQL)

Versão 1.0
Autores: Falko Timme, Dominik Najberg

Este guia explica como instalar o Maia Mailguard, um sistema de gerenciamento de spam e vírus, em um servidor de email Debian Squeeze. O Maia Mailguard é uma interface baseada na web e um sistema de gerenciamento baseado no popular scanner de email amavisd-new e SpamAssassin. Escrito em Perl e PHP, o Maia Mailguard dá aos usuários finais controle sobre como seu email é processado por scanners de vírus e filtros de spam, enquanto dá aos administradores de email o poder de configurar padrões e limites em todo o site.

Não dou nenhuma garantia de que isso funcionará para você!

1 Nota Preliminar

Este tutorial é baseado em Usuários E Domínios Virtuais Com Postfix, Courier, MySQL E SquirrelMail (Debian Squeeze), então você deve ter isso configurado. Se sua configuração de email for diferente, este tutorial pode não funcionar para você, ou você pode ter que fazer alguns ajustes.

Meu servidor tem o nome de host mail.example.com e o endereço IP 192.168.0.1. Vou instalar a interface web do Maia no diretório raiz do lighttpd padrão do Debian, /var/www, e usarei www.example.com para acessar a interface web. Você terá que ajustar isso se seu diretório raiz e seu domínio forem diferentes.

2 Baixando Maia Mailguard

O Maia Mailguard pode ser baixado apenas do SVN, então precisamos instalar o Subversion primeiro:

aptitude install subversion

Quero baixar os fontes para /usr/src/maia:

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

Abra um navegador e vá para https://www.maiamailguard.com/svn/branches/1.0 para descobrir qual é a última revisão - no meu caso foi 1578. Então inicie o download da seguinte forma:

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

(Certifique-se de substituir 1578 pela última revisão.)

3 Criando Um Banco De Dados Para Maia Mailguard

Em seguida, faça login no MySQL…

mysql -u root -p

… e crie um banco de dados chamado maia:

CREATE DATABASE maia;

Saia do shell do MySQL depois:

quit;

Importe o dump SQL do Maia para o banco de dados maia vazio:

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

Então faça login no MySQL novamente…

mysql -u root -p maia

… e crie um usuário MySQL chamado amavis:

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

FLUSH PRIVILEGES;

Corrija o problema da coluna desconhecida ‘discard_ham’ que impede que emails sejam enviados:

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

Saia do MySQL:

quit;

(Você pode substituir amavismysqlpasswd por uma senha de sua escolha, mas tenha em mente que você terá que usar essa senha mais tarde na configuração do Maia!)

Em seguida, certifique-se de ter um valor grande o suficiente para max_allowed_packet no seu /etc/mysql/my.cnf (na seção [mysqld]). Essa configuração determina o tamanho do maior item de email que você poderá processar com o Maia, então certifique-se de definir esse valor grande o suficiente para atender às suas necessidades.

nano /etc/mysql/my.cnf

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

Reinicie o MySQL se você alterou o valor de max_allowed_packet:

/etc/init.d/mysql restart

4 Instalando Os Scripts E Modelos Do Maia

O diretório home do usuário amavis no Debian Squeeze é /var/lib/amavis, e é lá que criamos um subdiretório chamado maia. Nesse subdiretório, colocaremos os scripts e modelos do 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

Em seguida, renomeamos /usr/src/maia/1.0/maia.conf.dist para /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

Abra /etc/maia/maia.conf e ajuste as seguintes configurações:

nano /etc/maia/maia.conf

| [...] # Configure seu DSN do banco de dados Maia aqui $dsn = "DBI:mysql:maia:localhost:3306"; # O nome de login do usuário do banco de dados Maia $username = "amavis"; # A senha do usuário do banco de dados Maia $password = "amavismysqlpasswd"; # O diretório onde os scripts Perl do Maia podem ser encontrados. $script_dir = "/var/lib/amavis/maia/scripts"; [...] # Localização para escrever os arquivos de lock/PID (deve ser gravável pelo seu # usuário amavis) $pid_dir = "/var/lib/amavis/"; [...] # URL base para os scripts PHP do Maia $base_url = "http://www.example.com/"; # Diretório de modelos template_dir = "/var/lib/amavis/maia/templates/"; [...] |

Certifique-se de preencher a senha correta para o usuário MySQL amavis na linha $password. Também preencha a URL correta na linha $base_url.