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 1: / Zeile 1: @@
-'''ISPConfig/Plugin/Automail''' - Automatischen Konfiguration von E-Mail-Clients
+<noinclude>
+<!--
+----
+{{Navigation|<zurück>|<nachste>}}
+----
+-->
+'''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
+* 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
 ; Anforderungen
-* aktuelle Version von [[ISPConfig]]
+* Aktuelle Version von [[ISPConfig]]
 * Webseite ([[Apache]] oder [[nginx]])
-; Aufbau des Plug-Ins
+; Aufbau des Plugins
 {| class="wikitable options big"
-| Erweiterung für [[ISPConfig]] || Verwalten der Einstellungen
+| Erweiterung für [[ISPConfig]] || Verwaltung der Einstellungen
 |-
-| Skript || um die entsprechenden XML-Dokumente unter der jeweiligen Domain zu generieren
+| Skript || XML-Dateien je Domain generieren
 |}
-; Beispiel
-* '''example.com''' die Domain, die die automatische Einrichtung der Mailclients abwickelt
-* '''client.com''' Kunden-Domain, die example.com für die Einrichtung abfragt
 == Installation ==
- cd /tmp
+<syntaxhighlight lang="bash" highlight="1-5" line>
- wget <nowiki>https://download.schaal-it.net/ispconfig-automail.tgz</nowiki>
+cd /tmp
- tar xfz ispconfig-automail.tgz
+wget https://download.schaal-it.net/ispconfig-automail.tgz
- cd automail
+tar xfz ispconfig-automail.tgz
- php install.php
+cd automail
-  ISPConfig Automail module has been installed.
+php install.php
+ ISPConfig Automail module has been installed.
+</syntaxhighlight>
+== Konfiguration ==
 === Plugin aktivieren ===
 # An [[ISPConfig]] als [[ISPConfig/admin|admin]] anmelden
@@ Zeile 49: / Zeile 54: @@
 * Fernzugriff zulassen, bei mehreren Servern
-=== Plugin Konfigurieren ===
+=== Plug-In-Konfiguration ===
-; Provider-ID
-Eindeutige ID zur Identifikation des Set-ups
+{| class="wikitable options big"
+! Einstellung !! Beschreibung
+|-
+| Provider-ID ||
+* Eindeutige ID zur Identifikation des Set-ups
 * Sie können den Domänennamen Ihres Servers verwenden
+|-
-; Hostnamen
+| Hostnamen ||
-* sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden
+* Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden
+|-
-; Ports
+| Ports ||
 * Ports, die für Ihren Mailserver verwendet werden sollen
+|-
-<!--
+| SSL ||
-[[Image:Bild1.png|top|alt="ISPConfig Automailer-Setup"]]
+* Wenn ''SSL'' aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen
--->
+|}
-; SSL
-Wenn ''SSL'' aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen
 '''Achtung'''
@@ Zeile 72: / Zeile 78: @@
 </blockquote>
-=== DNS-Einträge erstellen ===
+=== DNS-Einträge ===
+; Beispiel
+{| class="wikitable options big"
+| 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
@@ Zeile 81: / Zeile 95: @@
   _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
@@ Zeile 91: / Zeile 106: @@
 Webseite in [[ISPConfig]] anlegen
 * PHP-Unterstützung
-* keine Auto Subdomain
+* keine Auto-Subdomain
 * SSL
-** für [[autodiscover]] benötigt notwendig
 ; Optionen
+Durch ''ServerAlias'' bzw.&nbsp;''server_name'' kann diese Domain später von jedem Kunden/jeder Email-Domain genutzt werden
 '''Apache'''
   ServerAlias autoconfig.*
@@ Zeile 108: / Zeile 124: @@
   }
   server_name autoconfig.*;
-Durch ''ServerAlias'' bzw.&nbsp;''server_name'' kann diese Domain später von jedem Kunden/jeder Email-Domain genutzt werden
 ; Aliasdomain
-'''Aliasdomain''' autodiscover.example.de anlegen
+Aliasdomain anlegen
-zeigt auf autoconfig.example.de
+''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
-* Jetzt müssen Sie die Website autoconfig.example.com mit PHP-Unterstützung und ohne Auto-Subdomain in [[ISPConfig]] erstellen.
+=== Script einrichten ===
-* Sie sollten diese Seite auch mit SSL sichern.
+Script auf der Webseite einrichten
-* Dies ist für die automatische Konfiguration nicht erforderlich, wird aber später für die automatische Erkennung benötigt. Sie können Let's Encrypt ganz einfach verwenden
+# 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 ===
+{| class="wikitable options big"
+|-
+! Datei !! Beschreibung
+|-
+| ||
+|-
+| ||
+|}
+== Problembehebung ==
+<syntaxhighlight lang="bash" highlight="1" line copy>
+</syntaxhighlight>
+<!-- output -->
+<syntaxhighlight lang="bash" highlight="" line>
+</syntaxhighlight>
-Sie müssen die Anweisungen für Apache entsprechend setzen:
+<noinclude>
+<!--
+----
+{{Navigation|<zurück>|<nachste>}}
+----
+-->
-'''Apache '''
+== Anhang ==
- Serveralias autoconfig.*
+=== Siehe auch ===
+<div style="column-count:2">
+<categorytree hideroot=on mode="pages">{{BASEPAGENAME}}</categorytree>
+</div>
+----
+{{Special:PrefixIndex/{{BASEPAGENAME}}/}}
-Mit Alias oder Servername kann diese Domain später von beliebigen Kunden- oder E-Mail-Domains verwendet werden
+=== Dokumentation ===
-* Erstellen Sie die '''Aliasdomäne '''autodiscover.example.com und verweisen Sie sie auf autoconfig.example.com
+<!--
-* Sie brauchen keine Weiterleitungen, wichtig ist, dass die Domain ein SSL-Zertifikat hat
+; Man-Page
-* A-Records im DNS reichen aus, um auf Ihren Webserver zu verweisen, damit Sie Let's Encrypt verwenden können
+# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]
-=== Script auf der Webseite einrichten ===
+; Info-Pages
-# 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
-== Anwendungen ==
+=== Links ===
-=== Problembehebung ===
+==== Projekt ====
+# https://schaal-it.dev/blog/ispconfig-automail
-== Weblinks ==
+==== 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]]
 [[Kategorie:ISPConfig/Mail]]
 [[Kategorie:ISPConfig/Plugin]]
+</noinclude>

Dirkwagner (Diskussion | Beiträge)