Налаштування 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-availabe/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>

<Files "config.php">

   <IfModule mod_authz_core.c>

     Require all denied

   </IfModule>

</Files>

  </Directory>

  <IfModule mod_alias.c>

Псевдонім /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.