Installation von Maia Mailguard auf Debian Squeeze (Virtuelle Benutzer/Domains mit Postfix/MySQL)

Version 1.0
Autoren: Falko Timme, Dominik Najberg

Dieser Leitfaden erklärt, wie man Maia Mailguard, ein Spam- und Virenmanagementsystem, auf einem Debian Squeeze-Mailserver installiert. Maia Mailguard ist eine webbasierte Schnittstelle und ein Verwaltungssystem, das auf dem beliebten amavisd-new E-Mail-Scanner und SpamAssassin basiert. Geschrieben in Perl und PHP, gibt Maia Mailguard den Endbenutzern die Kontrolle darüber, wie ihre E-Mails von Virenscannern und Spamfiltern verarbeitet werden, während es den Mailadministratoren die Möglichkeit gibt, standortweite Standards und Grenzen zu konfigurieren.

Ich gebe keine Garantie, dass dies bei Ihnen funktioniert!

1 Vorbemerkung

Dieses Tutorial basiert auf Virtuellen Benutzern und Domains mit Postfix, Courier, MySQL und SquirrelMail (Debian Squeeze), daher sollten Sie dies bereits eingerichtet haben. Wenn Ihre Mail-Konfiguration anders ist, funktioniert dieses Tutorial möglicherweise nicht für Sie, oder Sie müssen einige Anpassungen vornehmen.

Mein Server hat den Hostnamen mail.example.com und die IP-Adresse 192.168.0.1. Ich werde Maias Webschnittstelle im Standard-Dokumentenstamm von Debian, /var/www, installieren und ich werde www.example.com verwenden, um auf die Webschnittstelle zuzugreifen. Sie müssen dies anpassen, wenn Ihr Dokumentenstamm und Ihre Domain abweichen.

2 Herunterladen von Maia Mailguard

Maia Mailguard kann nur von SVN heruntergeladen werden, daher müssen wir zuerst Subversion installieren:

aptitude install subversion

Ich möchte die Quellen nach /usr/src/maia herunterladen:

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

Öffnen Sie einen Browser und gehen Sie zu https://www.maiamailguard.com/svn/branches/1.0, um herauszufinden, was die neueste Revision ist - in meinem Fall war es 1578. Dann starten Sie den Download wie folgt:

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

(Stellen Sie sicher, dass Sie 1578 durch die neueste Revision ersetzen.)

3 Erstellen einer Datenbank für Maia Mailguard

Melden Sie sich als nächstes bei MySQL an…

mysql -u root -p

… und erstellen Sie eine Datenbank namens maia:

CREATE DATABASE maia;

Verlassen Sie danach die MySQL-Shell:

quit;

Importieren Sie Maias SQL-Dump in die leere maia-Datenbank:

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

Melden Sie sich dann erneut bei MySQL an…

mysql -u root -p maia

… und erstellen Sie einen MySQL-Benutzer namens amavis:

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

FLUSH PRIVILEGES;

Beheben Sie das Problem mit der unbekannten Spalte ‘discard_ham’, das verhindert, dass E-Mails irgendwohin gesendet werden:

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

Verlassen Sie MySQL:

quit;

(Sie können amavismysqlpasswd durch ein Passwort Ihrer Wahl ersetzen, aber beachten Sie, dass Sie dieses Passwort später in der Maia-Konfiguration verwenden müssen!)

Stellen Sie als nächstes sicher, dass Sie einen großen genug Wert für max_allowed_packet in Ihrer /etc/mysql/my.cnf (im Abschnitt [mysqld]) haben. Diese Einstellung bestimmt die Größe des größten E-Mail-Elements, das Sie mit Maia verarbeiten können, also stellen Sie sicher, dass Sie diesen Wert groß genug setzen, um Ihren Bedürfnissen gerecht zu werden.

nano /etc/mysql/my.cnf

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

Starten Sie MySQL neu, wenn Sie den Wert von max_allowed_packet geändert haben:

/etc/init.d/mysql restart

4 Installation von Maias Skripten und Vorlagen

Das Home-Verzeichnis des amavis-Benutzers auf Debian Squeeze ist /var/lib/amavis, und dort erstellen wir ein Unterverzeichnis namens maia. In diesem Unterverzeichnis werden wir Maias Skripte und Vorlagen ablegen:

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 Konfiguration von Maia

Als nächstes benennen wir /usr/src/maia/1.0/maia.conf.dist in /etc/maia/maia.conf um:

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

Öffnen Sie /etc/maia/maia.conf und passen Sie die folgenden Einstellungen an:

nano /etc/maia/maia.conf

| [...] # Konfigurieren Sie hier Ihren Maia-Datenbank-DSN $dsn = "DBI:mysql:maia:localhost:3306"; # Der Benutzername Ihres Maia-Datenbankbenutzers $username = "amavis"; # Das Passwort Ihres Maia-Datenbankbenutzers $password = "amavismysqlpasswd"; # Das Verzeichnis, in dem Maias Perl-Skripte zu finden sind. $script_dir = "/var/lib/amavis/maia/scripts"; [...] # Speicherort zum Schreiben der Lock/PID-Dateien (muss beschreibbar sein von Ihrem # amavis-Benutzer) $pid_dir = "/var/lib/amavis/"; [...] # Basis-URL zu Maias PHP-Skripten $base_url = "http://www.example.com/"; # Vorlagenverzeichnis $template_dir = "/var/lib/amavis/maia/templates/"; [...] |

Stellen Sie sicher, dass Sie das richtige Passwort für den MySQL-Benutzer amavis in der $password-Zeile eintragen. Füllen Sie auch die richtige URL in der $base_url-Zeile aus.