Розгортання Mautic

Конфігурація

Після встановлення всіх компонентів необхідно налаштувати Nginx для обслуговування Mautic, забезпечити HTTPS-з'єднання та виконати початкове налаштування самого Mautic.

1. Налаштування Nginx для Mautic

Створіть новий файл конфігурації Nginx для вашого домену. Замініть your_domain.com на ваш фактичний домен.

sudo nano /etc/nginx/sites-available/your_domain.com
# Створення нового файлу конфігурації Nginx

Вставте наступний конфіг Nginx:

server {
    listen 80;
    server_name your_domain.com www.your_domain.com;
    root /var/www/mautic/docroot; # Mautic 5.x+ використовує піддиректорію docroot

    index index.php index.html index.htm;

    error_log /var/log/nginx/mautic_error.log;
    access_log /var/log/nginx/mautic_access.log;

    client_max_body_size 100M; # Збільшуємо ліміт на розмір завантажуваних файлів

    location / {
        try_files $uri /index.php$is_args$args;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }

    location ~ /(app|bin|cache|translations|vendor|src)/ {
        deny all;
        return 404;
    }

    location ~ /(composer.json|composer.lock|nginx.conf|Dockerfile) {
        deny all;
        return 404;
    }

    # Для Mautic 5.x+ рекомендується використання /media/images/
    location ~ ^/media/images/(.)$ {
        try_files $uri @asset;
        expires max;
        add_header Cache-Control "public";
    }

    location @asset {
        rewrite ^/media/images/(.)$ /media/images/$1 break;
        proxy_pass http://127.0.0.1:8000; # Замініть на ваш PHP-FPM сокет, якщо не використовується Nginx
    }
}

Збережіть файл та вийдіть. Потім активуйте конфігурацію, створивши символічне посилання, та перевірте синтаксис Nginx:

sudo ln -s /etc/nginx/sites-available/your_domain.com /etc/nginx/sites-enabled/
# Активація конфігурації Nginx
sudo nginx -t
# Перевірка синтаксису конфігурації Nginx
sudo systemctl restart nginx
# Перезапуск Nginx для застосування змін

Тепер, якщо ви введете http://your_domain.com у браузері, ви повинні побачити сторінку встановлення Mautic.

2. Налаштування HTTPS за допомогою Certbot (Let's Encrypt)

Для безпечного з'єднання та підвищення довіри SEO, налаштуємо HTTPS за допомогою безкоштовних сертифікатів Let's Encrypt через Certbot.

sudo apt install certbot python3-certbot-nginx -y
# Встановлення Certbot та плагіна для Nginx
sudo certbot --nginx -d your_domain.com -d www.your_domain.com
# Запуск Certbot для отримання та встановлення сертифікатів
# Дотримуйтесь інструкцій: введіть email, погодьтеся з умовами, виберіть перенаправлення HTTP на HTTPS

Certbot автоматично змінить ваш конфіг Nginx, додавши секції для HTTPS. Він також налаштує автоматичне оновлення сертифікатів. Перевірити статус автоматичного оновлення можна так:

sudo systemctl status certbot.timer
# Перевірка статусу таймера Certbot для автоматичного оновлення
sudo certbot renew --dry-run
# Тестовий запуск оновлення сертифікатів

3. Завершення встановлення Mautic через вебінтерфейс

Відкрийте ваш домен (https://your_domain.com) у браузері. Ви побачите сторінку встановлення Mautic. Дотримуйтесь кроків:

1. Крок 1: Права доступу. Переконайтеся, що всі права доступу відзначені зеленим.
2. Крок 2: Налаштування бази даних. Введіть дані, які ви створили раніше:
   • Database Driver: MySQL PDO
   • Database Host: localhost
   • Database Port: 3306
   • Database Name: mautic_db
   • Database Username: mautic_user
   • Database Password: strong_password
   • Table Prefix: (можна залишити пустим або вказати mt_)
3. Крок 3: Налаштування адміністратора. Створіть обліковий запис адміністратора Mautic. Використовуйте надійний пароль.
4. Крок 4: Налаштування email. Налаштуйте SMTP-сервер для надсилання листів. Рекомендується використовувати зовнішній сервіс (SendGrid, Mailgun, Amazon SES) замість прямого SMTP з VPS, щоб уникнути проблем з доставкою.

Після завершення ви будете перенаправлені на сторінку входу в адмін-панель Mautic.

4. Налаштування Cron-завдань для Mautic

Mautic вимагає виконання регулярних фонових завдань (обробка email-черг, сегментація, оновлення даних). Ці завдання налаштовуються через Cron.

sudo -u mauticuser crontab -e
# Відкриття crontab для користувача mauticuser

Вставте наступні рядки в кінець файлу (переконайтеся, що шлях до PHP CLI правильний, у цьому випадку /usr/bin/php8.3):

# Cron-завдання Mautic
5,20,35,50     /usr/bin/php8.3 /var/www/mautic/bin/console mautic:segments:update > /dev/null 2>&1
# Оновлення сегментів (кожні 15 хвилин)
10,25,40,55     /usr/bin/php8.3 /var/www/mautic/bin/console mautic:campaigns:update > /dev/null 2>&1
# Оновлення кампаній (кожні 15 хвилин)
0,15,30,45     /usr/bin/php8.3 /var/www/mautic/bin/console mautic:campaigns:trigger > /dev/null 2>&1
# Запуск тригерів кампаній (кожні 15 хвилин)
0,30     /usr/bin/php8.3 /var/www/mautic/bin/console mautic:emails:send > /dev/null 2>&1
# Надсилання листів з черги (кожні 30 хвилин)
0 0    /usr/bin/php8.3 /var/www/mautic/bin/console mautic:maintenance:cleanup --days=365 > /dev/null 2>&1
# Очищення старих даних (раз на день, наприклад, логів старше 365 днів)
0 2    /usr/bin/php8.3 /var/www/mautic/bin/console mautic:webhooks:send > /dev/null 2>&1
# Надсилання вебхуків (раз на день)

Збережіть та закрийте файл. Cron-завдання виконуватимуться автоматично.

5. Перевірка працездатності

Переконайтеся, що Mautic доступний і працює коректно.

curl -I https://your_domain.com
# Перевірка HTTP-заголовків вашого домену. Повинен бути статус 200 OK та перенаправлення на HTTPS.

Увійдіть в адмін-панель Mautic. Перейдіть до розділу "Налаштування" -> "Системна інформація". Переконайтеся, що всі компоненти відзначені як робочі, і немає критичних помилок.

Резервне копіювання та обслуговування

Регулярне резервне копіювання (бекапи) та своєчасне обслуговування — ключ до стабільної та безпечної роботи Mautic. У цьому розділі ми розглянемо, що саме потрібно бекапити, як автоматизувати процес та як підтримувати систему в актуальному стані.

1. Що бекапити

Для повного відновлення Mautic вам знадобляться три основні групи даних:

• База даних Mautic: Містить усі ваші контакти, кампанії, сегменти, email-и, звіти та інші динамічні дані. Це найважливіший компонент.
• Файли Mautic: Включають ядро Mautic, плагіни, теми, завантажені медіафайли (зображення, документи), а також файли конфігурації. Директорія /var/www/mautic/.
• Конфігураційні файли сервера: Налаштування Nginx, PHP-FPM, Certbot, Fail2Ban, UFW. Хоча їх можна відновити вручну, бекап прискорить процес.

2. Простий скрипт автобекапу (cron + rsync + mysqldump)

Створимо простий скрипт, який виконуватиме бекап бази даних та файлів, а потім зберігатиме їх в окрему директорію. Для зберігання бекапів рекомендується використовувати зовнішнє сховище, таке як S3-сумісне хмарне сховище або окремий VPS.

sudo mkdir -p /opt/backups/mautic
# Створення директорії для зберігання бекапів
sudo chown mauticuser:mauticuser /opt/backups/mautic
# Встановлення власника для директорії бекапів
sudo nano /opt/backups/mautic_backup.sh
# Створення скрипта бекапу

Вставте наступний код у файл mautic_backup.sh. Замініть mautic_user, strong_password, mautic_db на свої дані. Також вкажіть шлях до зовнішнього сховища, якщо воно використовується.

#!/bin/bash

# Параметри бази даних
DB_USER="mautic_user"
DB_PASS="strong_password"
DB_NAME="mautic_db"

# Шляхи
MAUTIC_ROOT="/var/www/mautic"
BACKUP_DIR="/opt/backups/mautic"
DATE=$(date +%Y%m%d%H%M%S)
KEEP_DAYS=7 # Скільки днів зберігати бекапи

# 1. Бекап бази даних
echo "Dumping database..."
mysqldump -u ${DB_USER} -p"${DB_PASS}" ${DB_NAME} | gzip > ${BACKUP_DIR}/mautic_db_${DATE}.sql.gz

if [ $? -eq 0 ]; then
    echo "Бекап бази даних створено: ${BACKUP_DIR}/mautic_db_${DATE}.sql.gz"
else
    echo "Помилка: Бекап бази даних не вдався!"
    exit 1
fi

# 2. Бекап файлів Mautic (без кешу та логів)
echo "Archiving Mautic files..."
tar -czf ${BACKUP_DIR}/mautic_files_${DATE}.tar.gz \
    --exclude='${MAUTIC_ROOT}/var/cache/' \
    --exclude='${MAUTIC_ROOT}/var/logs/' \
    --exclude='${MAUTIC_ROOT}/vendor/' \
    ${MAUTIC_ROOT}

if [ $? -eq 0 ]; then
    echo "Бекап файлів Mautic створено: ${BACKUP_DIR}/mautic_files_${DATE}.tar.gz"
else
    echo "Помилка: Бекап файлів Mautic не вдався!"
    exit 1
fi

# 3. Очищення старих бекапів
echo "Очищення старих бекапів..."
find ${BACKUP_DIR} -type f -name "mautic_db_.sql.gz" -mtime +${KEEP_DAYS} -delete
find ${BACKUP_DIR} -type f -name "mautic_files_.tar.gz" -mtime +${KEEP_DAYS} -delete
echo "Старі бекапи очищено."

# 4. Синхронізація із зовнішнім сховищем (приклад для rsync)
# Якщо у вас є зовнішній сервер або S3-бакет, налаштуйте синхронізацію тут.
# Наприклад, для rsync:
# rsync -avz --delete ${BACKUP_DIR}/ user@remote_server:/path/to/remote/backups/
# Для S3-сумісного сховища використовуйте s3cmd або aws cli

echo "Процес резервного копіювання завершено."

sudo chmod +x /opt/backups/mautic_backup.sh
# Робимо скрипт виконуваним

sudo -u mauticuser crontab -e
# Відкриття crontab для користувача mauticuser

0 3    /opt/backups/mautic_backup.sh > /dev/null 2>&1
# Щоденний запуск скрипта бекапу о 3:00 ночі

3. Куди зберігати бекапи

Ніколи не зберігайте бекапи на тому ж сервері, що й робочі дані. Це зводить нанівець сенс бекапу при виході сервера з ладу. Рекомендовані варіанти:

• Зовнішнє S3-сумісне сховище: Хмарні сервіси (Amazon S3, DigitalOcean Spaces, Backblaze B2) пропонують надійне та недороге зберігання. Використовуйте утиліти типу s3cmd або rclone для синхронізації.
• Окремий VPS або виділений сервер: Ви можете використовувати інший сервер виключно для зберігання бекапів, синхронізуючи їх по SSH за допомогою rsync.
• Локальне сховище із синхронізацією: Для дуже маленьких проєктів можна тимчасово зберігати бекапи локально, але обов'язково налаштувати їх автоматичне завантаження на хмарний диск (Google Drive, Dropbox) за допомогою скриптів.

4. Оновлення: rolling vs maintenance window

Підтримка Mautic та всіх компонентів системи в актуальному стані критично важлива для безпеки та отримання нових функцій. Використовуйте наступну стратегію:

• Оновлення ОС (Ubuntu): Виконуйте sudo apt update && sudo apt upgrade -y регулярно, наприклад, раз на тиждень. Якщо потрібне перезавантаження ядра, плануйте перезавантаження сервера.
• Оновлення PHP, Nginx, MySQL: Ці компоненти зазвичай оновлюються разом з ОС. Однак, при переході на нову мажорну версію (наприклад, з PHP 8.3 на 8.4), плануйте це як окреме вікно обслуговування, оскільки можуть знадобитися зміни в конфігурації або коді Mautic.
• Оновлення Mautic: Mautic випускає регулярні оновлення (патчі, мінорні та мажорні версії).
  • Патчі та мінорні оновлення (5.1.0 -> 5.1.1): Зазвичай можуть бути застосовані в "rolling" режимі, але завжди рекомендується робити бекап перед оновленням. Використовуйте команду php /var/www/mautic/bin/console mautic:update:find і потім php /var/www/mautic/bin/console mautic:update:apply.
  • Мажорні оновлення (5.x -> 6.x): Вимагають планування "maintenance window" (вікна обслуговування). Заздалегідь вивчіть офіційну документацію щодо оновлення Mautic, оскільки можуть бути зміни у вимогах до PHP, структурі бази даних або файловій системі. Обов'язково зробіть повний бекап перед таким оновленням.

Завжди тестуйте оновлення на стейджинг-сервері, якщо це можливо, перш ніж застосовувати їх на продакшені. Якщо стейджинг-сервера немає, ретельно вивчайте changelog і робіть бекап.

Вирішення проблем + FAQ

Навіть при найретельнішому налаштуванні можуть виникнути проблеми. Цей розділ допоможе вам діагностувати та вирішити найпоширеніші з них, а також відповість на часті запитання.

Mautic видає помилку 500 Internal Server Error або білу сторінку

Що перевірити:

1. Логи Nginx: Перевірте /var/log/nginx/mautic_error.log.
2. Логи PHP-FPM: Перевірте /var/log/php8.3-fpm.log (або аналогічний шлях).
3. Логи Mautic: Перевірте /var/www/mautic/var/logs/mautic_prod.php.
4. Права доступу до файлів: Переконайтеся, що користувач www-data (або користувач, під яким працює Nginx та PHP-FPM) має права на читання/запис у директорії Mautic, особливо в /var/www/mautic/var. Виконайте sudo chown -R www-data:www-data /var/www/mautic та sudo chmod -R 775 /var/www/mautic.
5. Ліміти PHP: Переконайтеся, що memory_limit та max_execution_time у php.ini достатні (наприклад, 512M та 300).

Email-и не надсилаються з Mautic

Що перевірити:

1. Налаштування SMTP в Mautic: У розділі "Налаштування" -> "Конфігурація" -> "Налаштування Email". Переконайтеся, що дані SMTP-сервера (хост, порт, логін, пароль) вірні і ви використовуєте надійний зовнішній SMTP-провайдер.
2. Логи Mautic: Шукайте помилки, пов'язані з надсиланням email, у /var/www/mautic/var/logs/mautic_prod.php.
3. Cron-завдання: Переконайтеся, що mautic:emails:send запускається регулярно (sudo -u mauticuser crontab -l).
4. Наявність спам-фільтрів: Переконайтеся, що ваш домен правильно налаштований (SPF, DKIM, DMARC записи в DNS), щоб уникнути потрапляння в спам.

Mautic працює повільно або зависає при великих обсягах даних

Що перевірити:

1. Ресурси сервера: Використовуйте htop, free -h, df -h для моніторингу CPU, RAM та диска. Чи не вистачає ресурсів?
2. Логи MySQL: Шукайте повільні запити.
3. Індекси бази даних: Переконайтеся, що MySQL правильно індексує таблиці Mautic.
4. Кеш Mautic: Переконайтеся, що кеш працює (Mautic використовує файловий кеш за замовчуванням, можна налаштувати Redis для великих інсталяцій).
5. Cron-завдання: Переконайтеся, що вони не перекриваються і виконуються своєчасно, не створюючи надмірне навантаження.

Який VPS-конфіг мінімально підійде?

Для тестової установки або дуже невеликого проєкту (до 5000 контактів, 1-2 кампанії) можна почати з 2 ядер CPU, 4 ГБ RAM та 80 ГБ NVMe SSD. Однак, як тільки ви почнете активно використовувати Mautic, рекомендується перейти на конфігурацію з 4 ядрами, 8 ГБ RAM та 160+ ГБ NVMe SSD для забезпечення стабільної та швидкої роботи.

Що обрати — VPS чи dedicated для цього завдання?

Для більшості користувачів, що починають з Mautic, VPS є оптимальним вибором. Він пропонує достатню гнучкість, продуктивність та економічність. Dedicated сервер стає виправданим при дуже великих обсягах даних (сотні тисяч контактів), високій частоті розсилок (мільйони листів на місяць) або якщо у вас є суворі вимоги до повної ізоляції ресурсів та максимальної продуктивності, які не може забезпечити VPS через віртуалізацію.

Як оновити Mautic?

Увійдіть до Mautic як адміністратор. Перейдіть до "Налаштування" (значок шестерні у правому верхньому куті) -> "Компоненти" -> "Оновити Mautic". Якщо доступне оновлення, Mautic запропонує його встановити. Також можна оновити через CLI, використовуючи команди php /var/www/mautic/bin/console mautic:update:find та php /var/www/mautic/bin/console mautic:update:apply. Завжди робіть бекап перед оновленням!

Як збільшити ліміт на завантаження файлів у Mautic?

Збільште значення upload_max_filesize та post_max_size у файлі /etc/php/8.3/fpm/php.ini. Також переконайтеся, що в конфігурації Nginx (/etc/nginx/sites-available/your_domain.com) параметр client_max_body_size встановлений на достатнє значення (наприклад, 100M). Після змін перезапустіть PHP-FPM та Nginx.

Висновки та наступні кроки

Вітаємо! Ви успішно розгорнули та налаштували Mautic на своєму VPS. Тепер у вас є потужний та гнучкий інструмент для автоматизації маркетингу, який повністю знаходиться під вашим контролем. Ви отримали не тільки функціональну платформу, а й цінний досвід у налаштуванні серверної інфраструктури, що стане в пригоді для будь-яких майбутніх проєктів.

Ось кілька кроків, куди можна рухатися далі, щоб максимально ефективно використовувати ваш Mautic:

• Інтеграція з CRM та іншими сервісами: Mautic має безліч плагінів для інтеграції з популярними CRM-системами (Salesforce, HubSpot, Zoho CRM), CMS (WordPress, Drupal), а також із зовнішніми SMTP-провайдерами для покращення доставлення листів. Вивчіть доступні плагіни та налаштуйте їх під свої потреби.
• Оптимізація продуктивності: Для великих інсталяцій розгляньте використання Redis або Memcached для кешування, а також налаштування оптимізації MySQL. Можливо, знадобиться горизонтальне масштабування, якщо навантаження стає занадто високим.
• Розширена безпека: Додатково посильте безпеку, налаштувавши двофакторну автентифікацію для входу в Mautic, використовуючи складніші правила для Fail2Ban та регулярно проводячи аудит безпеки сервера.