ISPConfig 3 Roundcube Plugin auf Debian 9 (Stretch)

Betriebssystemversion: Debian 9.4 und 9.5 Stretch
Roundcube-Version: 1.2.3+dfsg.1-4+deb9u1 und u2
ISPConfig 3 Version: 3.1.11 und 3.1.13

Dieses Howto basiert auf den Installationsanweisungen von ISPConfig3_roundcube aus dem Handbuch.

Voraussetzungen

Verwenden Sie die Roundcube-Version, die mit Debian 9 geliefert wird, installieren Sie sie wie im Perfect Server Guide für Debian Stretch beschrieben.

Verwenden Sie die aktuelle ISPConfig-Version, derzeit ist die neueste Version 3.1.13.

ISPConfig Remote-Benutzer hinzufügen

Fügen Sie einen ISPConfig-Remote-Benutzer für die Verwendung mit Roundcube hinzu. Wählen Sie einen geeigneten Namen, ich verwende rcmail-remote. Wählen Sie ein gutes Passwort, ich generiere Passwörter normalerweise mit apg, führen Sie zuerst apt-get install apg aus.

apg -m 12 -l M NCL

Erstellen Sie den Remote-Benutzer im ISPConfig-Panel, Registerkarte System, unter Benutzerverwaltung ist „Remote-Benutzer“. Klicken Sie auf die Schaltfläche „Neuen Benutzer hinzufügen“.

Ich habe Remote Access: nicht angekreuzt, meine Einrichtung hat einen separaten E-Mail-Server, auf dem Mail-Dateien sowie Roundcube und Dovecot installiert sind. Daher benötigt dieser „Remote-Benutzer“ in meinem Fall keinen Remote-Zugriff.

Für diesen Benutzer wählen Sie:

- Serverfunktionen
- Clientfunktionen
- Mailbenutzerfunktionen
- Mailaliasfunktionen
- Mail-Spamfilterbenutzerfunktionen
- Mail-Spamfilterrichtlinienfunktionen
- Mail-fetchmail-Funktionen
- Mail-Spamfilter-Whitelistfunktionen
- Mail-Spamfilter-Blacklistfunktionen
- Mailbenutzerfilterfunktionen

Diese Liste ist in der Reihenfolge, in der die Elemente im ISPConfig-Panel erscheinen.

ISPConfig RoundCube-Plugin installieren

Holen Sie sich die ISPConfig3-Plugins von Github. Ich habe die neueste Version für RoundCube 1.2.3 verwendet. Der Plugin-Autor schreibt im Handbuch, dass man direkt von Subversion in das RoundCube-Stammverzeichnis auschecken soll. Ich bevorzuge es, woanders auszuchecken, damit ich das Systemverzeichnis, in dem apt-get Dateien installiert, nicht durcheinanderbringe.

Die Readme.Debian in /usr/share/doc/roundcube rät, „Ihr Plugin in /var/lib/roundcube/plugins/ hinzuzufügen.“ Ich checke von svn nach /root/ISPConfig3_plugins aus und kopiere von dort nach /var/lib/roundcube/plugins. Die Plugins aus den Debian-Paketen sind in /usr/share/roundcube installiert und es gibt einen symbolischen Link von dort nach /var/lib/roundcube/plugins. Installieren Sie Subversion, um den Befehl svn zu erhalten. (apt-get install subversion).

cd /root  
mkdir ISPConfig3_plugins  
cd ISPConfig3_plugins  
svn co https://github.com/w2c/ispconfig3_roundcube/trunk/ .

cd ispconfig3_account/config  
cp config.inc.php.dist config.inc.php

Plugin konfigurieren

Bearbeiten Sie die Datei, die im letzten Befehl der vorherigen Befehlszeilen kopiert wurde. Füllen Sie die Informationen des Remote-Benutzers aus, die in Schritt 2 erstellt wurden.

cd /root/ISPConfig3_plugins

editor ispconfig3_account/config/config.inc.php

Die Originaldatei sieht so aus:

Ändern Sie remote_soap_user, remote_soap_pass (Benutzer und Passwort, die in Schritt 2 erstellt wurden) und soap_url. Wenn Sie das ISPConfig-Panel mit https:// verwenden, verwenden Sie dasselbe hier für soap_url. Sie können die IP-Adresse oder den Hostnamen und die Domain in soap_url verwenden. Die Portnummer ist dieselbe wie für das ISPConfig-Panel.

Plugin aktivieren

Bearbeiten Sie die Roundcube-Konfiguration in der Datei /etc/roundcube/config.inc.php. Suchen Sie nach „Liste der aktiven Plugins“. Debian Stretch aktiviert standardmäßig keine Plugins, sodass die Liste leer ist, es sei denn, Sie haben bereits einige Plugins aktiviert. Wenn die Liste leer ist, d.h. so aussieht:

// Liste der aktiven Plugins (im plugins/-Verzeichnis) // Debian: installieren Sie zuerst roundcube-plugins, um welche zu haben $config['plugins'] = array( );

ersetzen Sie sie einfach durch:

$config['plugins'] = array(
"jqueryui","ispconfig3_account", "ispconfig3_autoreply", 
"ispconfig3_autoselect", "ispconfig3_pass", "ispconfig3_spam", 
"ispconfig3_fetchmail", "ispconfig3_filter", 
"ispconfig3_forward", "ispconfig3_wblist"
);

Die Reihenfolge der Plugins ist wichtig! Ändern Sie die Reihenfolge nicht, es sei denn, Sie wissen, was Sie tun.

Wenn die Liste nicht leer war, fügen Sie die ISPConfig3-Plugins nach den vorhandenen Plugins hinzu. Wenn ein Plugin nicht benötigt wird, entfernen Sie es aus der Liste und es wird nicht mehr aktiviert.

Wenn Sie nur einen Mail-Host verwenden, entfernen Sie das Plugin ispconfig3_autoselect, da Sie es in diesem Fall nicht benötigen und es nur Probleme verursacht, wenn Sie es nicht richtig konfigurieren.

Ich habe ispconfig3_forward entfernt, da ich Fehler in /var/log/roundcube/errors für Zeile 135 in der Datei ispconfig3_forward/ispconfig3_forward.php bemerkt habe.

Plugin an den Systemstandort kopieren

Jetzt müssen Sie die Plugins aus dem Checkout-Verzeichnis nach /var/lib/roundcube kopieren. Machen Sie es zum Beispiel so:

cd /root/ISPConfig3_plugins  
for f in ispconfig3_* ; do echo $f ; cp --recursive $f /var/lib/roundcube/plugins/ ; done

Testen

Wenn die neuen Plugins in den Einstellungen angezeigt werden, aber beim Klicken darauf die Fehlermeldung „Soap Error: Not Found“ oder „Soap Error: Bad Request“ erscheint, überprüfen Sie die soap_url-Einstellung. Möglicherweise fehlt das Schrägstrich-Zeichen „/“ am Ende.

Testen und genießen. Es gibt einen 5. Punkt im Einstellungsmenü, der von diesen Plugins erstellt wurde.

RoundCube-Konto

Wenn Sie Fehler erhalten, lesen Sie die Fehlerbehebung FAQ des Autors der ISPConfig3-Plugins unter https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ. Wenn das nicht hilft, lesen Sie die Protokolle aus /var/log/roundcube/errors. Wenn Sie weiterhin Probleme haben, sehen Sie sich andere Protokolle in den Verzeichnissen /var/log und /var/log/apache2 an. Wenn nichts hilft, überprüfen Sie, ob Sie den Server gemäß dem Perfect Server Guide installiert haben. Mir wurde gesagt, dass das VM-Image php-soap nicht installiert hat und dass das von Skript installierte ISPConfig auch dieses PHP-Paket nicht enthält.