Verwendung von RoundCube Webmail mit ISPConfig 3 auf Debian Wheezy (nginx)

Diese Anleitung erklärt, wie man die RoundCube-Webmail-Anwendung auf einem Debian-Wheezy-Server installiert, der ISPConfig und nginx ausführt, und wie man die ISPConfig 3-Plugins für RoundCube aktiviert, damit Benutzer Aktionen wie das Ändern ihrer E-Mail-Passwörter direkt in RoundCube durchführen können. Roundcube Webmail ist ein browserbasierter mehrsprachiger IMAP-Client mit einer anwendungsähnlichen Benutzeroberfläche; es bietet Funktionen wie MIME-Unterstützung, Adressbuch, Ordnerverwaltung, Nachrichtensuche und Rechtschreibprüfung.

Ich gebe keine Garantie, dass dies bei Ihnen funktioniert!

1 Vorbemerkung

Dieses Tutorial geht davon aus, dass Sie nginx als Webserver auf Ihrem ISPConfig 3-Server verwenden; dieses Tutorial funktioniert nicht mit Apache. Ich werde RoundCube aus den Debian-Wheezy-Repositories installieren - es ist eine relativ aktuelle Version (0.7.2.9 vs 0.9.1 (aktuelle stabile Version)).

Ich werde zeigen, wie man einen vhost für RoundCube konfiguriert, damit er über den Alias /webmail (z. B. http://www.example.com/webmail) erreichbar ist.

2 Erstellen eines Remote-Benutzers in ISPConfig

Die ISPConfig 3-Plugins für RoundCube arbeiten über die Remote-API von ISPConfig. Um diese API zu nutzen, benötigen wir einen Remote-Benutzer. Um einen solchen Benutzer zu erstellen, gehen Sie zu System > Benutzerverwaltung > Remote-Benutzer und klicken Sie auf die Schaltfläche Neuer Benutzer hinzufügen:

Geben Sie einen Benutzernamen und ein Passwort für den Benutzer ein…

… und aktivieren Sie die folgenden Funktionen:

Serverfunktionen
Clientfunktionen
Mailbenutzerfunktionen
Mailaliasfunktionen
Mail-Spamfilterbenutzerfunktionen
Mail-Spamfilterrichtlinienfunktionen
Mail-Fetchmail-Funktionen
Mail-Spamfilter-Whitelistfunktionen
Mail-Spamfilter-Blacklistfunktionen
Mailbenutzersfilterfunktionen

Klicken Sie dann auf Speichern.

3 RoundCube installieren

Wir können RoundCube wie folgt installieren:

apt-get install roundcube roundcube-plugins roundcube-plugins-extra

Sie werden die folgenden Fragen sehen:

Datenbank für roundcube mit dbconfig-common konfigurieren? <– Ja
Datenbanktyp, der von roundcube verwendet werden soll: <– mysql
Passwort des administrativen Benutzers der Datenbank: <– yourrootsqlpassword (das Passwort des MySQL-Root-Benutzers)
MySQL-Anwendungspasswort für roundcube: <– roundcubesqlpassword
Passwortbestätigung: <– roundcubesqlpassword

Dies erstellt eine MySQL-Datenbank namens roundcube mit dem MySQL-Benutzer roundcube und dem Passwort roundcubesqlpassword.

Gehen Sie als Nächstes zu Ihrer Website in ISPConfig. Auf der Registerkarte Optionen sehen Sie das Feld nginx-Direktiven:

Füllen Sie die folgenden Direktiven aus und klicken Sie auf Speichern (es spielt keine Rolle, ob Sie PHP für diesen vhost aktiviert haben oder nicht, da dieser Code-Schnipsel die Standard-PHP des Systems verwendet, die unter dem Benutzer und der Gruppe www-data ausgeführt wird, was wichtig ist, da RoundCube außerhalb des Dokumentenstammverzeichnisses des vhosts installiert ist - in /var/lib/roundcube):

| client_max_body_size 100M; location /roundcube { root /var/lib/; index index.php index.html index.htm; location ~ (.+\.php)$ { try_files $uri =404; include /etc/nginx/fastcgi_params; # Um auf SquirrelMail zuzugreifen, muss der Standardbenutzer (wie www-data auf Debian/Ubuntu) verwendet werden #fastcgi_pass 127.0.0.1:9000; fastcgi_pass unix:/var/run/php5-fpm.sock; fastcgi_index index.php; fastcgi_intercept_errors on; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_buffer_size 128k; fastcgi_buffers 256 4k; fastcgi_busy_buffers_size 256k; fastcgi_temp_file_write_size 256k; } location ~* /.svn/ { deny all; } location ~* /README|INSTALL|LICENSE|SQL|bin|CHANGELOG$ { deny all; } } location /webmail { rewrite ^ /roundcube last; } |

Mit dieser Konfiguration wird RoundCube unter den URLs http://www.example.com/webmail und http://www.example.com/roundcube zugänglich sein.

4 RoundCube konfigurieren

Öffnen Sie /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… und setzen Sie $rcmail_config[‘default_host’] = ‘localhost’; (oder den Hostnamen oder die IP-Adresse Ihres Mailservers, wenn er auf einem Remote-Gerät ist):

| [...] $rcmail_config['default_host'] = 'localhost'; [...] |

Andernfalls wird RoundCube vor jedem Login nach einem Hostnamen fragen, was Ihre Benutzer überfordern könnte - wir möchten die Nutzung so einfach wie möglich gestalten.

Installieren Sie als Nächstes die ISPConfig 3-Plugins für RoundCube:

cd /tmp  
git clone https://github.com/w2c/ispconfig3_roundcube.git  
cd /tmp/ispconfig3_roundcube/  
mv ispconfig3_* /usr/share/roundcube/  
cd /usr/share/roundcube/  
mv ispconfig3_account/config/config.inc.php.dist ispconfig3_account/config/config.inc.php  
ln -s /usr/share/roundcube/ispconfig3_* /var/lib/roundcube/plugins/

Öffnen Sie ispconfig3_account/config/config.inc.php…

vi ispconfig3_account/config/config.inc.php

… und fügen Sie die Anmeldedaten Ihres ISPConfig-Remote-Benutzers und die URL der Remote-API ein - meine ISPConfig-Installation läuft auf https://192.168.0.100:8080, also ist die URL der Remote-API https://192.168.0.100:8080/remote/:

| |

Öffnen Sie schließlich erneut /etc/roundcube/main.inc.php…

vi /etc/roundcube/main.inc.php

… und aktivieren Sie das jquerui-Plugin sowie die ISPConfig 3-Plugins…

| [...] // ---------------------------------- // PLUGINS // ---------------------------------- // Liste der aktiven Plugins (im plugins/-Verzeichnis) //$rcmail_config['plugins'] = array(); $rcmail_config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter"); [...] |

… und ändern Sie das Design von default auf classic (ansonsten funktionieren die ISPConfig 3-Plugins nicht):

| [...] // skin name: folder from skins/ $rcmail_config['skin'] = 'classic'; [...] |

Das war’s; jetzt können Sie auf RoundCube unter dem Alias /webmail (z. B. www.example.com/webmail) zugreifen. Melden Sie sich mit der E-Mail-Adresse und dem Passwort eines über ISPConfig erstellten E-Mail-Kontos an: