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

Versão 1.0
Autor: Falko Timme
Siga-me no Twitter

Este guia explica como instalar o Maia Mailguard, um sistema de gerenciamento de spam e vírus, em um servidor de e-mail Debian Lenny. O Maia Mailguard é uma interface baseada na web e um sistema de gerenciamento baseado no popular scanner de e-mail amavisd-new e SpamAssassin. Escrito em Perl e PHP, o Maia Mailguard dá aos usuários finais controle sobre como seu e-mail é processado por scanners de vírus e filtros de spam, enquanto dá aos administradores de e-mail 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 Lenny), então você deve ter isso configurado. Se sua configuração de e-mail for diferente, este tutorial pode não funcionar para você, ou você pode ter que fazer alguns ajustes.

Meu servidor tem o nome do host server1.example.com e o endereço IP 192.168.0.100. Vou instalar a interface web do Maia no diretório raiz do Apache 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 temos que instalar o Subversion primeiro:

aptitude install subversion

Quero baixar as 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 1495. Então comece o download da seguinte forma:

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

(Certifique-se de substituir 1495 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 'passwd';

FLUSH PRIVILEGES;

quit;

(Você pode substituir passwd por uma senha de sua escolha, mas lembre-se de 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 em seu /etc/mysql/my.cnf (na seção [mysqld]). Esta configuração determina o tamanho do maior item de e-mail que você poderá processar com o Maia, então certifique-se de definir esse valor grande o suficiente para atender às suas necessidades.

vi /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 Templates Do Maia

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

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

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

vi /etc/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 = "passwd"; # O diretório onde os scripts Perl do Maia podem ser encontrados. $script_dir = "/var/lib/amavis/maia/scripts"; [...] # Localização para gravar 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://example.com/"; # Diretório de templates $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.