Настройка Z-Push ActiveSync для сервера электронной почты Ubuntu

Z-Push ActiveSync играет важную роль, если вам необходимо синхронизировать задачи, контакты и электронные письма между настольным устройством и мобильными гаджетами.

По умолчанию у пользователей почтовых клиентов есть определённый интервал времени, в течение которого происходит проверка сервера и появляются push-сообщения. Чтобы ускорить этот процесс, можно также использовать Z-Push. Итак, в этом руководстве мы рассмотрим некоторые рекомендации по настройке Z-Push для пользователей Ubuntu.

Что понадобится для начала работы

Чтобы приступить к настройке, у вас уже должен быть исправно работающий почтовый сервер Ubuntu. Если у вас его нет, в сети есть множество руководств с подробными инструкциями по правильной настройке.

Шаг 1: Настройте Z-Push на почтовом сервере Ubuntu

Войдите на почтовый сервер и введите следующую команду:

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

В процессе установки вам будет предложено выбрать Lighttpd или Apache в качестве веб-сервера для автоматической настройки. Если вы используете сервер Nginx, нажмите клавиши Tab и Enter, чтобы пропустить этот этап выбора.

Те, кто выберет сервер Apache, создадут 2 конфигурационных файла. Однако в данном руководстве мы расскажем только о процессе настройки с использованием IMAP-бэкенда для синхронизации электронной почты.

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

Для настройки автоматического обнаружения используйте:

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

После этого найдите и настройте свой часовой пояс, а затем найдите следующую строку, в которой необходимо заменить false на true:

define('USE_FULLEMAIL_FOR_LOGIN', false);

Затем найдите настройки бэкэнда и включите IMAP-бэкэнд, после чего закройте файл, сохранив все изменения.

Теперь давайте отредактируем файл imap.conf.php:

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

Найдите раздел с настройками IMAP, где необходимо включить шифрование TLS. Укажите адрес сервера в соответствующем поле, добавьте порт и добавьте /ssl в IMAP_OPTIONS.

Далее укажите smtp в IMAP_SMTP_METHOD. В этом параметре $imap_smtp_params добавьте настройки SMTP-сервера, включая адрес, порт, имя пользователя и пароль. Последнее, что нужно изменить перед сохранением, — это значение IMAP_FOLDER_CONFIGURED, оно должно быть true. После этого можно закрыть файл со всеми сохраненными изменениями.

Шаг 2: Добавьте необходимые расширения PHP

Z-Push несовместим с PHP 8, поэтому можно использовать версию 7.4; установка выглядит следующим образом:

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

Если вы используете сервер Apache, процесс начинается с отключения PHP7 и MPM:

sudo a2dismod php7.4 

sudo a2dismod mpm_prefork

Затем выполните следующие команды:

sudo a2enmod mpm_event proxy_fcgi setenvif

sudo a2enconf php7.4-fpm

Заключительным шагом станет перезапуск сервера Apache с помощью команды:

sudo systemctl restart apache2

Шаг 3: Настройте веб-сервер для работы с Z-Push

Настройка Nginx для Z-Push

Начните процесс с создания файла:

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

Добавьте в файл следующие строки:
server {

     listen 80;

     listen [::]:80;

     server_name вставьте своё настоящее имя;

     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;

     }

}

Затем проверьте, всё ли работает правильно, и перезагрузите сервер Nginx.

Настройка Apache для Z-Push

Начните с создания файла:

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

Добавьте в созданный файл следующую информацию:

<VirtualHost *:80>

  ServerName вставьте здесь реальное имя

  &<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>

<Файл «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>

После этого необходимо перезапустить сервер.

Шаг 4: Защитите свою электронную почту с помощью HTTPS

Чтобы защитить свою электронную почту, установите Let’s Encrypt с помощью следующей команды:

sudo apt install certbot

Пользователям Nginx также необходимо выполнить следующий шаг:

sudo apt install python3-certbot-nginx

Для установки сертификата используйте следующую строку:

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

Пользователям Apache следует начать с:

sudo apt install python3-certbot-apache

Для установки сертификата используйте следующую строку:

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

После перезапуска сервера всё должно работать как положено. Если нет, далее в руководстве мы расскажем о нескольких ошибках, которые вы сможете легко исправить.

Шаг 5: Активация push-уведомлений на мобильных устройствах

Пользователи iPhone могут активировать push-уведомления, перейдя в настройки, выбрав «Почта», затем «Учётные записи» и добавив учётную запись. В процессе активации выберите «Microsoft Exchange». После этого введите адрес электронной почты, выберите «Ручная настройка» и введите пароль. Введите учетные данные еще раз и добавьте информацию о сервере.  

Не удалось подключиться к серверу? Вот в чём причина

Обычно сбой при подключении к серверу происходит из-за неправильной версии PHP, поэтому вам просто нужно обновить её, чтобы Z-Push работал правильно.

Не удаётся проверить данные учётной записи? Исправьте это здесь

Чтобы подтвердить данные учетной записи, вам нужно отредактировать файл конфигурации Dovecot. Откройте файл с помощью:

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

Найдите строку с реалмом по умолчанию, удалите комментарий, добавьте туда домен и перезапустите сервер.

Как диагностировать проблемы с помощью журналов сервера

Для Nginx используйте:

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

Для диагностики с помощью журналов сервера Apache:

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

Журналы Z-Push:

/var/log/z-push/

Подводя итог

Надеемся, теперь у вас есть полная информация о настройке Z-Push ActiveSync для почтового сервера Ubuntu.