ISPConfig 3 - Roundcube-Plugins auf Debian 10 installieren

Die ispconfig3_roundcube-Plugins integrieren Ihre ISPConfig-Mailkontoeinstellungen in Roundcube. In diesem Tutorial führe ich Sie durch den Installationsprozess.

Voraussetzungen

• Roundcube muss mit apt installiert sein. Andernfalls müssen Sie möglicherweise die in diesem Tutorial verwendeten Dateipfade ändern.
• Stellen Sie sicher, dass Ihre ISPConfig- und Roundcube-Installation auf dem neuesten Stand ist.

Hinzufügen eines Remote-Benutzers

Die ISPConfig 3-Plugins verwenden die API, um sich mit Ihrem System zu verbinden. Daher müssen wir einen Remote-Benutzer im Kontrollpanel erstellen.

Melden Sie sich in Ihrem Panel an, gehen Sie zu System -> Remote-Benutzer und klicken Sie auf “Neuen Remote-Benutzer hinzufügen”. Geben Sie im Formular Ihrem neuen Benutzer einen Namen und ein Passwort. Ich werde rc-example mit dem Passwort examplepass verwenden. Verwenden Sie nicht dieselben Anmeldeinformationen, sondern erstellen Sie Ihre eigenen. Mein Beispielpanel befindet sich unter https://panel.example.com:8080 mit einem gültigen SSL-Zertifikat.

Aktivieren Sie die folgende Funktion für Ihren Remote-Benutzer:

• Roundcube-Plugin-Funktionen

Und aktivieren Sie den Remote-Zugriff für die IPv4- und IPv6-Adresse Ihres Webmail-Servers.

Plugins herunterladen

Führen Sie die folgenden Befehle aus:

cd /tmp  
wget https://github.com/w2c/ispconfig3_roundcube/archive/master.zip  
unzip master.zip  
cd ./ispconfig3_roundcube-master  
cp -r ./ispconfig3_* /usr/share/roundcube/plugins  
ln -s /usr/share/roundcube/plugins/ispconfig* /var/lib/roundcube/plugins/

Die Plugins befinden sich jetzt im richtigen Ordner, mit einem Symlink von /var/lib/roundcube/plugins. Der nächste Schritt besteht darin, sie so zu konfigurieren, dass sie unseren Remote-Benutzer verwenden. Führen Sie dies aus, um die Beispielkonfiguration zu kopieren und zu bearbeiten:

cp /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php.dist /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php
nano /usr/share/roundcube/plugins/ispconfig3_account/config/config.inc.php

Sie werden diese Konfigurationsdatei sehen:

$config['identity_limit'] = false;
$config['remote_soap_user'] = '{REMOTE USERNAME}';
$config['remote_soap_pass'] = '{REMOTE PASSWORD}';
$config['soap_url'] = 'https://{YOUR SERVER}:8080/remote/';
$config['soap_validate_cert'] = true;

Ich werde dies ändern in:

$config['identity_limit'] = false;
$config['remote_soap_user'] = 'rc-example';
$config['remote_soap_pass'] = 'examplepass';
$config['soap_url'] = 'https://panel.example.com:8080/remote/';
$config['soap_validate_cert'] = true;

Stellen Sie sicher, dass Sie den rot unterstrichenen Text durch Ihre eigenen Anmeldeinformationen und die Panel-Adresse ersetzen. Ändern Sie soap_validate_cert in false, wenn Sie https verwenden, aber kein vertrauenswürdiges SSL-Zertifikat installiert haben.

Aktivieren der Plugins

Um die Plugins zu aktivieren, öffnen Sie die Roundcube-Konfiguration:

nano /etc/roundcube/config.inc.php

Und suchen Sie nach diesen Zeilen:

// Liste der aktiven Plugins (im plugins/-Verzeichnis)
$config['plugins'] = array();

Um die Plugins zu aktivieren, fügen Sie dies zwischen die Klammern ein:

"jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist"

Die Zeile sieht dann so aus:

// Liste der aktiven Plugins (im plugins/-Verzeichnis)
$config['plugins'] = array("jqueryui", "ispconfig3_account", "ispconfig3_autoreply", "ispconfig3_pass", "ispconfig3_spam", "ispconfig3_fetchmail", "ispconfig3_filter", "ispconfig3_forward", "ispconfig3_wblist");

Einige Anmerkungen dazu:

• Das jqueryui-Plugin muss vor den anderen Plugins platziert werden.
• Wenn Sie ein Plugin nicht verwenden möchten, z. B. das fetchmail-Plugin, lassen Sie ispconfig3_fetchmail weg.
• Wenn Sie mehr als einen Mailserver verwenden, fügen Sie ispconfig3_autoselect zur Liste hinzu und lassen Sie $config['default_host'] leer. ispconfig3_autoselect wählt automatisch den richtigen Server für den Benutzer aus, der sich anmeldet. Sie können die eigene Konfigurationsdatei bearbeiten, um tls/ssl-Verbindungen zwischen Roundcube und dem externen Mailserver in ispconfig3_autoselect/config/config.inc.php.dist zu aktivieren.

Nach dem Speichern der Konfigurationsdatei wird ein neuer Tab “Konto” in den Webmail-Einstellungen angezeigt:

Wir sind fertig!

Wenn Sie auf Probleme stoßen, werfen Sie einen Blick in die FAQ zur Fehlersuche unter https://github.com/w2c/ispconfig3_roundcube/wiki/Troubleshooting—FAQ

Wenn Sie Fragen oder Kommentare haben, können Sie diese in den Antworten hinterlassen oder einen Forenbeitrag erstellen.