- 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
Diese Anleitung basiert auf der ISPConfig3_roundcube Installationsanleitung aus dem Handbuch.
Voraussetzungen
Verwenden Sie die Roundcube-Version, die mit Debian 9 geliefert wird, und installieren Sie sie gemäß den Anweisungen im Perfect Server Guide for Debian Stretch.
Verwenden Sie die aktuelle ISPConfig, jetzt ist die neueste Version 3.1.13.
ISPConfig Remote-Benutzer hinzufügen
ISPConfig-Remote-Benutzer für Roundcube-Nutzung hinzufügen. Wählen Sie einen passenden Namen, ich verwende rcmail-remote . Wählen Sie ein gutes Passwort, ich generiere normalerweise Passwörter mit apg , führen Sie apt-get install apg aus zuerst.
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 Fernzugriff: nicht angekreuzt , mein Setup verfügt über einen separaten E-Mail-Server, auf dem E-Mail-Dateien sowie Roundcube und Dovecot installiert sind. Obwohl dies also ein "Remote-Benutzer" ist, ist in meinem Fall kein Remote-Zugriff erforderlich.
Wählen Sie für diesen Benutzer:
- Server functions - Client functions - Mail user functions - Mail alias functions - Mail spamfilter user functions - Mail spamfilter policy functions - Mail fetchmail functions - Mail spamfilter whitelist functions - Mail spamfilter blacklist functions - Mail user filter functions
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, um von Subversion direkt in das RoundCube-Root-Verzeichnis auszuchecken. Ich schaue lieber woanders nach, damit ich das Systemverzeichnis, in dem apt-get Dateien installiert, nicht durcheinander bringe.
Die Readme.Debian in /usr/share/doc/roundcube empfiehlt „Fügen Sie Ihr Plugin in /var/lib/roundcube/plugins hinzu.“ Ich checke von svn nach /root/ISPConfig3_plugins aus und kopiere von dort nach /var/lib/roundcube/plugins. Die Plugins aus Debian-Paketen werden in /usr/share/roundcube installiert und es gibt einen symbolischen Link zu denen aus /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 beim letzten Befehl der vorherigen Befehlszeilen kopiert wurde. Geben Sie die in Schritt 2 erstellten Remote-Benutzerinformationen ein.
cd /root/ISPConfig3_plugins
editor ispconfig3_account/config/config.inc.php
Die Originaldatei sieht so aus:
<?php $rcmail_config['identity_limit'] = false; $rcmail_config['remote_soap_user'] = 'roundcube'; $rcmail_config['remote_soap_pass'] = 'roundcube'; $rcmail_config['soap_url'] = 'http://192.177.167.44:8080/remote/'; ?>
Ändern Sie remote_soap_user, remote_soap_pass (Benutzer und Pass, 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 Domäne 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, daher ist die Liste leer, es sei denn, Sie haben bereits einige Plugins aktiviert. Wenn die Liste leer ist, also so aussieht:
// List of active plugins (in plugins/ directory) // Debian: install roundcube-plugins first to have any $config['plugins'] = array( );
Ersetzen Sie es einfach durch Folgendes:
$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 es 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 ist 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, weil ich Fehler in /var/log/roundcube/errors für Zeile 135 in der Datei ispconfig3_forward/ispconfig3_forward.php bemerkt habe.
Plug-in an Systemspeicherort kopieren
Nun 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 Anklicken die Fehlermeldung "Soap Error:Not Found" oder "Soap Error:Bad Request" angezeigt wird, überprüfen Sie die Einstellung soap_url. Vielleicht fehlt der Schrägstrich "/" am Ende.
Testen und genießen. Es gibt ein fünftes Element im Einstellungsmenü, das von diesen Plugins erstellt wird.
Wenn Sie Fehler erhalten, lesen Sie die häufig gestellten Fragen zur Fehlerbehebung vom ISPConfig3-Plugin-Autor unter https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting---FAQ. Wenn das nicht hilft, lesen Sie die Protokolle von /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 auf dem VM-Image kein php-soap installiert ist, und dem per Skript installierten ISPConfig fehlt dieses PHP-Paket ebenfalls.