ISPConfig/Plugin/Automail: Unterschied zwischen den Versionen

Aktuelle Version vom 27. Juli 2026, 09:27 Uhr

ISPConfig/Plugin/Automail - Automatische Konfiguration von E-Mail-Clients

Beschreibung

ISPConfig Automail

Email-Clients konfigurieren

Email-Clients automatisch nach Vorgaben konfigurieren
Autoconfig (Thunderbird)
Autodiscover (Outlook)
Einen oder mehrere Mailserver für Domains möglich
Definition von passenden Daten je Mailserver (Hostname, Port, ...)

Webseite

stellt die Daten zur Verfügung
Unterschiedliche Adressen und unterschiedliche XML‑Files

Anforderungen

Aktuelle Version von ISPConfig
Webseite (Apache oder nginx)

Aufbau des Plugins

Erweiterung für ISPConfig	Verwaltung der Einstellungen
Skript	XML-Dateien je Domain generieren

Installation

cd /tmp
wget https://download.schaal-it.net/ispconfig-automail.tgz
tar xfz ispconfig-automail.tgz
cd automail
php install.php
 ISPConfig Automail module has been installed.

Konfiguration

Plugin aktivieren

An ISPConfig als admin anmelden
System /CP User anhlicken
Modul automail für admin aktivieren

Nach der nächsten Anmeldung steht das Modul zur Verfügung

Remote-Benutzer

Remote-Benutzer erstellen

Automail-Funktionen aktivieren
Fernzugriff zulassen, bei mehreren Servern

Plug-In-Konfiguration

Einstellung	Beschreibung
Provider-ID	Eindeutige ID zur Identifikation des Set-ups Sie können den Domänennamen Ihres Servers verwenden
Hostnamen	Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden
Ports	Ports, die für Ihren Mailserver verwendet werden sollen
SSL	Wenn SSL aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen

Achtung

Das Zertifikat MUSS zum Hostnamen passen

DNS-Einträge

Beispiel

example.com	Domain für die Abwicklung der Einrichtung von Mailclients
client.com	Kunden-Domain, die example.com für die Einrichtung abfragt

DNS-Einträge erstellen
A/AAAA-Record für example.com

autoconfig.example.com
autodiscover.example.com

Je Kundendomäne

autoconfig.client.com. CNAME autoconfig.example.com. 
_autodiscover._tcp.client.com. SRV 0 0 443 autodiscover.example.com.

SRV-Eintrag

Für die automatische Erkennung wird ein SRV-Eintrag empfohlen

Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung
Es ist die einfachste Möglichkeit, beliebig viele Kundendomänen einzurichten

Website für Automail

Einrichten der Website in ISPConfig

autoconfig.example.de

Webseite in ISPConfig anlegen

PHP-Unterstützung
keine Auto-Subdomain
SSL

Optionen

Durch ServerAlias bzw. server_name kann diese Domain später von jedem Kunden/jeder Email-Domain genutzt werden

Apache

ServerAlias autoconfig.*

nginx

location ^~ /config\.php { deny all; }

location / { 
rewrite autodiscover\.xml$ /index.php last; 
rewrite Autodiscover\.xml$ /index.php last; 
rewrite config-v1\.1\.xml$ /index.php last; 
}
server_name autoconfig.*;

Aliasdomain

Aliasdomain anlegen autodiscover.example.de zeigt auf autoconfig.example.de

Keine Redirects
SSL-Zertifikat
- Dazu reichen A-Records im DNS, die auf Deinen Webserver zeigen, damit Du Let’s Encrypt nutzen kannst

Script einrichten

Script auf der Webseite einrichten

Laden Sie die Dateien aus dem Website -Verzeichnis aus dem Archiv auf die neu erstellte Website hoch
config.php anpassen
Benennen Sie die Datei htaccess in .htaccess um
- Wird nginx verwendet, kann die Datei gelöscht werden

Dateien

Datei	Beschreibung

Problembehebung

Anhang

Siehe auch

Dokumentation

Links

Projekt

https://schaal-it.dev/blog/ispconfig-automail

Weblinks

@@ Zeile 5: / Zeile 5: @@
 ----
 -->
-'''ISPConfig/Plugin/Automail''' - Automatischen Konfiguration von E-Mail-Clients
+'''ISPConfig/Plugin/Automail''' - Automatische Konfiguration von [[E-Mail-Client]]s
 </noinclude>
 == Beschreibung ==
-; ISPConfig Automail
+ISPConfig Automail
-* Email-Clients (Thunderbird, Outlook, ...) automatisch konfigurieren
+; [[Email-Client]]s konfigurieren
-* Einen oder mehrere Mailserver für Domains möglich
+* Email-Clients automatisch nach Vorgaben konfigurieren
+* [[Autoconfig]] ([[Thunderbird]])
+* [[Autodiscover]] ([[Outlook]])
+* Einen oder [[mehrere Mailserver]] für Domains möglich
 * Definition von passenden Daten je Mailserver (Hostname, Port, ...)
-; Webseite stellt die Daten zur Verfügung
+Webseite
-* Autoconfig (Thunderbird)
+* stellt die Daten zur Verfügung
-* Autodiscover (Outlook)
-; [[Autoconfig]] und [[Autodiscover]]
-[[Email-Client]]s nach Vorgaben konfigurieren
 * Unterschiedliche Adressen und unterschiedliche XML‑Files
@@ Zeile 26: / Zeile 25: @@
 * Webseite ([[Apache]] oder [[nginx]])
-; Aufbau des Plug-Ins
+; Aufbau des Plugins
 {| class="wikitable options big"
 | Erweiterung für [[ISPConfig]] || Verwaltung der Einstellungen
 |-
 | Skript || XML-Dateien je Domain generieren
-|}
-; Beispiel
-{| class="wikitable options big"
-| example.com || Domain, die die automatische Einrichtung der Mailclients abwickelt
-|-
-| client.com || Kunden-Domain, die example.com für die Einrichtung abfragt
 |}
@@ Zeile 50: / Zeile 42: @@
 </syntaxhighlight>
-== Aufruf ==
+== Konfiguration ==
-<syntaxhighlight lang="bash" highlight="1" line copy>
+=== Plugin aktivieren ===
-</syntaxhighlight>
+# An [[ISPConfig]] als [[ISPConfig/admin|admin]] anmelden
+# ''System ''/''CP User'' anhlicken
+# Modul ''automail'' für [[ISPConfig/admin|admin]] aktivieren
+Nach der nächsten Anmeldung steht das Modul zur Verfügung
+=== Remote-Benutzer ===
+Remote-Benutzer erstellen
+* ''Automail-Funktionen'' aktivieren
+* Fernzugriff zulassen, bei mehreren Servern
+=== Plug-In-Konfiguration ===
-=== Optionen ===
+{| class="wikitable options big"
-{| class="wikitable sortable options gnu big"
+! Einstellung !! Beschreibung
 |-
-! Unix !! GNU !! Parameter !! Beschreibung
+| Provider-ID ||
+* Eindeutige ID zur Identifikation des Set-ups
+* Sie können den Domänennamen Ihres Servers verwenden
 |-
-| || || ||
+| Hostnamen ||
+* Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden
 |-
+| Ports ||
+* Ports, die für Ihren Mailserver verwendet werden sollen
+|-
+| SSL ||
+* Wenn ''SSL'' aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen
 |}
-=== Parameter ===
+'''Achtung'''
-=== Umgebungsvariablen ===
+<blockquote>
-=== Exit-Status ===
+Das Zertifikat [[MUSS]] zum Hostnamen passen
-{| class="wikitable options col1center big"
+</blockquote>
+=== DNS-Einträge ===
+; Beispiel
+{| class="wikitable options big"
+| example.com || Domain für die Abwicklung der Einrichtung von Mailclients
 |-
-! Wert !! Beschreibung
+| client.com || Kunden-Domain, die example.com für die Einrichtung abfragt
-|-
-| 0 || Erfolg
-|-
-| >0 || Fehler
 |}
-== Anwendung ==
+; DNS-Einträge erstellen
-<syntaxhighlight lang="bash" highlight="1" line copy>
+; A/AAAA-Record für example.com
-</syntaxhighlight>
+* autoconfig.example.com
+* autodiscover.example.com
+; Je Kundendomäne
+ autoconfig.client.com. CNAME autoconfig.example.com.
+ _autodiscover._tcp.client.com. SRV 0 0 443 autodiscover.example.com.
+; SRV-Eintrag
+Für die automatische Erkennung wird ein SRV-Eintrag empfohlen
+* Dadurch erhalten Sie während der Einrichtung eine Zertifikatswarnung
+* Es ist die einfachste Möglichkeit, beliebig viele Kundendomänen einzurichten
+=== Website für Automail ===
+Einrichten der Website in [[ISPConfig]]
+; autoconfig.example.de
+Webseite in [[ISPConfig]] anlegen
+* PHP-Unterstützung
+* keine Auto-Subdomain
+* SSL
+; Optionen
+Durch ''ServerAlias'' bzw.&nbsp;''server_name'' kann diese Domain später von jedem Kunden/jeder Email-Domain genutzt werden
+'''Apache'''
+ ServerAlias autoconfig.*
+'''nginx'''
+ location ^~ /config\.php { deny all; }
+ location / {
+ rewrite autodiscover\.xml$ /index.php last;
+ rewrite Autodiscover\.xml$ /index.php last;
+ rewrite config-v1\.1\.xml$ /index.php last;
+ }
+ server_name autoconfig.*;
-<!-- output -->
+; Aliasdomain
-<syntaxhighlight lang="bash" highlight="" line>
+Aliasdomain anlegen
-</syntaxhighlight>
+''autodiscover.example.de'' zeigt auf ''autoconfig.example.de''
+* Keine Redirects
+* SSL-Zertifikat
+** Dazu reichen A-Records im DNS, die auf Deinen Webserver zeigen, damit Du Let’s Encrypt nutzen kannst
-=== Problembehebung ===
+=== Script einrichten ===
+Script auf der Webseite einrichten
+# Laden Sie die Dateien aus dem '''Website '''-Verzeichnis aus dem Archiv auf die neu erstellte Website hoch
+# config.php anpassen
+# Benennen Sie die Datei htaccess in .htaccess um
+#* Wird [[nginx]] verwendet, kann die Datei gelöscht werden
-== Konfiguration ==
 === Dateien ===
 {| class="wikitable options big"
@@ Zeile 95: / Zeile 148: @@
 | ||
 |}
+== Problembehebung ==
+<syntaxhighlight lang="bash" highlight="1" line copy>
+</syntaxhighlight>
+<!-- output -->
+<syntaxhighlight lang="bash" highlight="" line>
+</syntaxhighlight>
 <noinclude>
@@ Zeile 102: / Zeile 163: @@
 ----
 -->
 == Anhang ==
 === Siehe auch ===
@@ Zeile 120: / Zeile 182: @@
 === Links ===
 ==== Projekt ====
+# https://schaal-it.dev/blog/ispconfig-automail
 ==== Weblinks ====
-# [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Autoconfig-Dienst ](Thunderbird)
+# [https://developer.mozilla.org/en-US/docs/Mozilla/Thunderbird/Autoconfiguration Thunderbird/Autoconfiguration]
-# [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Autodiscover-Dienst ](Outlook)
+# [https://technet.microsoft.com/en-us/library/bb124251(v=exchg.160).aspx Outlook/Autodiscover]
 [[Kategorie:Autodiscover]]

Dirkwagner (Diskussion | Beiträge)