ISPConfig/Plugin/Automail: Unterschied zwischen den Versionen

Version vom 18. Juli 2026, 09:42 Uhr

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

Beschreibung

ISPConfig Automail

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

Webseite stellt die Daten zur Verfügung

Autoconfig (Thunderbird)
Autodiscover (Outlook)

Autoconfig und Autodiscover

Email-Clients nach Vorgaben konfigurieren

Unterschiedliche Adressen und unterschiedliche XML‑Files

Anforderungen

Aktuelle Version von ISPConfig
Webseite (Apache oder nginx)

Aufbau des Plug-Ins

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

Beispiel

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

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.

Aufruf

Optionen

Unix	GNU	Parameter	Beschreibung

Parameter

Umgebungsvariablen

Exit-Status

Wert	Beschreibung
0	Erfolg
>0	Fehler

Anwendung

Problembehebung

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

Plugin Konfigurieren

Provider-ID

Eindeutige ID zur Identifikation des Set-ups

Sie können den Domänennamen Ihres Servers verwenden

Hostnamen

sind die 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

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

Anhang

Siehe auch

Dokumentation

Links

Projekt

Weblinks

Autoconfig-Dienst (Thunderbird)
Autodiscover-Dienst (Outlook)

@@ Zeile 86: / Zeile 86: @@
 == Konfiguration ==
+=== Plugin aktivieren ===
+# 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
+=== Plugin Konfigurieren ===
+; Provider-ID
+Eindeutige ID zur Identifikation des Set-ups
+* Sie können den Domänennamen Ihres Servers verwenden
+; Hostnamen
+* sind die Namen, unter denen Mails abgerufen (IMAP/POP3) und versendet (SMTP) werden
+; Ports
+* Ports, die für Ihren Mailserver verwendet werden sollen
+<!--
+[[Image:Bild1.png|top|alt="ISPConfig Automailer-Setup"]]
+-->
+; SSL
+Wenn ''SSL'' aktiviert ist, wird das eingerichtete Email-Programm eine verschlüsselte Verbindung aufbauen
+'''Achtung'''
+<blockquote>
+Das Zertifikat [[MUSS]] zum Hostnamen passen
+</blockquote>
+=== DNS-Einträge ===
+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.&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.*;
+; 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 ===
 {| class="wikitable options big"
@@ Zeile 102: / Zeile 190: @@
 ----
 -->
 == Anhang ==
 === Siehe auch ===

Dirkwagner (Diskussion | Beiträge)