Konfigurieren von Z-Push ActiveSync für Ubuntu Email Server

Z-Push ActiveSync ist wichtig, wenn Sie Aufgaben, Kontakte und E-Mails zwischen dem Desktop-Gerät und mobilen Geräten synchronisieren möchten.

Standardmäßig haben Nutzer von E-Mail-Clients ein bestimmtes Zeitfenster, in dem der Server abgefragt wird und Push-E-Mails erscheinen. Um diesen Vorgang zu beschleunigen, kann auch Z-Push verwendet werden. In dieser Anleitung werden wir daher einige Konfigurationstipps zu Z-Push für Ubuntu-Benutzer besprechen.

Was Sie für den Einstieg benötigen

Um den Vorgang zu starten, sollten Sie bereits über einen ordnungsgemäß funktionierenden Ubuntu-Mailserver verfügen. Falls Sie noch keinen haben, gibt es zahlreiche Anleitungen mit detaillierten Erklärungen, wie Sie alles ordnungsgemäß einrichten.

Schritt 1: Richten Sie Z-Push auf Ihrem Ubuntu-Mailserver ein

Geben Sie den Mailserver ein und verwenden Sie die folgende Zeile:

sudo apt install z-push z-push-backend-imap z-push-common

Im Verlauf des Installationsvorgangs werden Ihnen Lighttpd oder Apache als Webserver für die automatische Konfiguration angeboten. Falls Sie den Nginx-Server verwenden, sollten Sie die Tabulatortaste und die Eingabetaste drücken, um diesen Auswahlvorgang zu überspringen.

Wer den Apache-Server auswählt, erstellt zwei Konfigurationsdateien. In dieser Anleitung beschreiben wir jedoch nur den Einrichtungsprozess mit dem IMAP-Backend für die E-Mail-Synchronisierung.

 sudo apt install z-push-backend-combined z-push-backend-caldav z-push-backend-carddav z-push-backend-kopano

Verwenden Sie für die Konfiguration der automatischen Erkennung folgenden Befehl:

 sudo nano /etc/z-push/utodiscover.conf.php

Suchen Sie anschließend Ihre Zeitzone und richten Sie sie ein. Suchen Sie dann die nächste Zeile, in der Sie „false“ in „true“ ändern sollten:

define('USE_FULLEMAIL_FOR_LOGIN', false);

Suchen Sie anschließend die Backend-Einstellung, aktivieren Sie das IMAP-Backend und schließen Sie die Datei mit allen gespeicherten Änderungen.

Nun bearbeiten wir die Datei „imap.conf.php“:

sudo nano /etc/z-push/imap.conf.php

Suchen Sie den Abschnitt mit den IMAP-Einstellungen, in dem Sie die TLS-Verschlüsselung aktivieren sollten. Geben Sie die Serveradresse im Definitionsabschnitt an, fügen Sie den Port hinzu und fügen Sie „/ssl“ in IMAP_OPTIONS ein.

Als Nächstes geben Sie „smtp“ in „IMAP_SMTP_METHOD“ an. Fügen Sie in diesem Parameter „$imap_smtp_params“ die SMTP-Einstellungen des Servers hinzu, darunter Adresse, Port, Benutzername und Passwort. Als Letztes müssen Sie vor dem Speichern noch den Wert von IMAP_FOLDER_CONFIGURED auf „true“ setzen. Sobald dies erledigt ist, können Sie die Datei mit allen gespeicherten Änderungen schließen.

Schritt 2: Wichtige PHP-Erweiterungen hinzufügen

Z-Push ist nicht mit PHP 8 kompatibel, daher können Sie Version 7.4 verwenden; die Installation sieht wie folgt aus:

sudo apt install software-properties-common

sudo add-apt-repository ppa:ondrej/php

sudo apt update

sudo apt install php-soap php7.4-common php7.4-soap php7.4-fpm php7.4-imap php7.4-mbstring

Falls Sie einen Apache-Server verwenden, beginnt der Vorgang mit der Deaktivierung von PHP7 und MPM:

sudo a2dismod php7.4 

sudo a2dismod mpm_prefork

Verwenden Sie anschließend die folgenden Befehle:

sudo a2enmod mpm_event proxy_fcgi setenvif

sudo a2enconf php7.4-fpm

Abschließend starten Sie den Apache-Server mit folgendem Befehl neu:

sudo systemctl restart apache2

Schritt 3: Konfigurieren Sie Ihren Webserver für Z-Push

Nginx-Konfiguration für Z-Push

Beginnen Sie den Vorgang mit der Erstellung der Datei:

sudo nano /etc/nginx/conf.d/z-push.conf

Fügen Sie der Datei die folgenden Zeilen hinzu:
server {

     listen 80;

     listen [::]:80;

     server_name Geben Sie Ihren tatsächlichen Namen ein;

     access_log /var/log/nginx/z-push.access;

     error_log /var/log/nginx/z-push.error;

     location ~* /AutoDiscover/AutoDiscover.xml {

             alias /usr/share/z-push/autodiscover/autodiscover.php;

             include /etc/nginx/fastcgi.conf;

             fastcgi_read_timeout 3660;

         &    fastcgi_pass unix:/run/php/php7.4-fpm.sock;

     }

     location ~* /Microsoft-Server-ActiveSync {

             alias /usr/share/z-push/index.php;

             include /etc/nginx/fastcgi.conf;

         &    fastcgi_read_timeout 3660;

             fastcgi_pass unix:/run/php/php7.4-fpm.sock;

     }

}

Testen Sie anschließend, ob alles ordnungsgemäß funktioniert, und starten Sie den Nginx-Server neu.

Apache-Konfiguration für Z-Push

Beginnen Sie mit der Erstellung der Datei:

sudo nano /etc/apache2/sites-available/z-push.conf

Fügen Sie der erstellten Datei folgende Informationen hinzu:

<VirtualHost *:80>

  ServerName hier den tatsächlichen Namen einfügen

  <IfModule mod_alias.c>

Alias /Microsoft-Server-ActiveSync /usr/share/z-push/index.php

  </IfModule>

  <Directory /usr/share/z-push>

DirectoryIndex index.php

Options -Indexes +FollowSymLinks

AllowOverride none

<IfModule mod_authz_core.c>

     Require all granted

</IfModule>

<Files „config.php“>

   <IfModule mod_authz_core.c>

     Require all denied

   </IfModule>

</Files>

  </Directory>

  <IfModule mod_alias.c>

Alias /AutoDiscover/AutoDiscover.xml "/usr/share/z-push/autodiscover/autodiscover.php"

Alias /Autodiscover/Autodiscover.xml "/usr/share/z-push/autodiscover/autodiscover.php"

Alias /autodiscover/autodiscover.xml "/usr/share/z-push/autodiscover/autodiscover.php"

  </IfModule>

  Include /etc/apache2/conf-available/php7.4-fpm.conf

</VirtualHost>

Anschließend sollten Sie den Server neu starten.

Schritt 4: Sichern Sie Ihre E-Mail mit HTTPS

Um Ihre E-Mail zu sichern, installieren Sie Let’s Encrypt mit dem folgenden Befehl:

sudo apt install certbot

Für Nutzer von Nginx ist es außerdem erforderlich, diesen Schritt hinzuzufügen:

sudo apt install python3-certbot-nginx

Um das Zertifikat zu installieren, verwenden Sie die folgende Zeile:

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email you@name.com -d autodiscover.name.com

Für Apache-Benutzer beginnen Sie mit:

sudo apt install python3-certbot-apache

Um das Zertifikat zu installieren, verwenden Sie die folgende Zeile:

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email you@name.com -d autodiscover.name.com

Nachdem Sie den Server neu gestartet haben, sollte alles ordnungsgemäß funktionieren. Falls nicht, werden wir Ihnen später in dieser Anleitung einige Fehler nennen, die Sie leicht beheben können.

Schritt 5: Push-E-Mails auf Mobilgeräten aktivieren

iPhone-Nutzer können Push-E-Mails aktivieren, indem sie in die Einstellungen gehen, „Mail“ und dann „Accounts“ auswählen und einen Account hinzufügen. Wählen Sie bei der Aktivierung „Microsoft Exchange“ aus. Geben Sie anschließend die E-Mail-Adresse ein, wählen Sie „Manuelle Konfiguration“ und geben Sie das Passwort ein. Geben Sie die Anmeldedaten erneut ein und fügen Sie die Serverdaten hinzu.  

Verbindung zum Server fehlgeschlagen? Hier ist der Grund

In der Regel tritt ein Verbindungsfehler zum Server aufgrund einer falschen PHP-Version auf; aktualisieren Sie diese daher einfach, damit Z-Push ordnungsgemäß funktioniert.

Kontoinformationen können nicht überprüft werden? So beheben Sie das Problem

Um die Kontoinformationen zu überprüfen, müssen Sie die Dovecot-Konfigurationsdatei bearbeiten. Öffnen Sie die Datei mit:

sudo nano /etc/dovecot/conf.d/10-auth.conf

Suchen Sie die Zeile mit dem Standard-Realm, entfernen Sie die Auskommentierung, fügen Sie dort die Domain hinzu und starten Sie den Dienst neu.

So diagnostizieren Sie Probleme mithilfe von Serverprotokollen

Für Nginx verwenden Sie:

/var/log/nginx/z-push.error.

So analysieren Sie die Serverprotokolle in Apache:

/var/log/apache2/z-push_error.log.

Z-Push-Protokolle:

/var/log/z-push/

Zusammenfassung

Wir hoffen, dass Sie nun über alle Informationen zur Konfiguration von Z-Push ActiveSync für den Ubuntu-E-Mail-Server verfügen.