Despliegue de M

Configuración

Después de instalar todos los componentes, es necesario configurar Nginx para servir Mautic, asegurar una conexión HTTPS y realizar la configuración inicial del propio Mautic.

1. Configuración de Nginx para Mautic

Cree un nuevo archivo de configuración de Nginx para su dominio. Reemplace your_domain.com con su dominio real.

sudo nano /etc/nginx/sites-available/your_domain.com
# Crear un nuevo archivo de configuración de Nginx

Pegue la siguiente configuración de Nginx:

server {
    listen 80;
    server_name your_domain.com www.your_domain.com;
    root /var/www/mautic/docroot; # Mautic 5.x+ utiliza el subdirectorio 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; # Aumentamos el límite de tamaño de los archivos subidos

    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;
    }

    # Para Mautic 5.x+ se recomienda el uso de /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; # Reemplace con su socket PHP-FPM si no se usa Nginx
    }
}

Guarde el archivo y salga. Luego, active la configuración creando un enlace simbólico y verifique la sintaxis de Nginx:

sudo ln -s /etc/nginx/sites-available/your_domain.com /etc/nginx/sites-enabled/
# Activación de la configuración de Nginx
sudo nginx -t
# Verificación de la sintaxis de la configuración de Nginx
sudo systemctl restart nginx
# Reiniciar Nginx para aplicar los cambios

Ahora, si ingresa http://your_domain.com en el navegador, debería ver la página de instalación de Mautic.

2. Configuración de HTTPS con Certbot (Let's Encrypt)

Para una conexión segura y mejorar la confianza SEO, configuraremos HTTPS utilizando certificados gratuitos de Let's Encrypt a través de Certbot.

sudo apt install certbot python3-certbot-nginx -y
# Instalación de Certbot y el plugin para Nginx
sudo certbot --nginx -d your_domain.com -d www.your_domain.com
# Ejecutar Certbot para obtener e instalar certificados
# Siga las instrucciones: ingrese su correo electrónico, acepte los términos, elija la redirección de HTTP a HTTPS

Certbot modificará automáticamente su configuración de Nginx, añadiendo secciones para HTTPS. También configurará la renovación automática de certificados. Puede verificar el estado de la renovación automática de la siguiente manera:

sudo systemctl status certbot.timer
# Verificar el estado del temporizador de Certbot para la renovación automática
sudo certbot renew --dry-run
# Ejecución de prueba de la renovación de certificados

3. Finalización de la instalación de Mautic a través de la interfaz web

Abra su dominio (https://your_domain.com) en el navegador. Verá la página de instalación de Mautic. Siga los pasos:

1. Paso 1: Permisos de acceso. Asegúrese de que todos los permisos de acceso estén marcados en verde.
2. Paso 2: Configuración de la base de datos. Ingrese los datos que creó anteriormente:
   • Database Driver: MySQL PDO
   • Database Host: localhost
   • Database Port: 3306
   • Database Name: mautic_db
   • Database Username: mautic_user
   • Database Password: strong_password
   • Table Prefix: (puede dejarlo en blanco o especificar mt_)
3. Paso 3: Configuración del administrador. Cree una cuenta de administrador de Mautic. Utilice una contraseña segura.
4. Paso 4: Configuración de correo electrónico. Configure el servidor SMTP para enviar correos electrónicos. Se recomienda utilizar un servicio externo (SendGrid, Mailgun, Amazon SES) en lugar de SMTP directo desde un VPS para evitar problemas de entregabilidad.

Una vez completado, será redirigido a la página de inicio de sesión del panel de administración de Mautic.

4. Configuración de tareas Cron para Mautic

Mautic requiere la ejecución de tareas en segundo plano regulares (procesamiento de colas de correo electrónico, segmentación, actualización de datos). Estas tareas se configuran a través de Cron.

sudo -u mauticuser crontab -e
# Abrir crontab para el usuario mauticuser

Pegue las siguientes líneas al final del archivo (asegúrese de que la ruta a PHP CLI sea correcta, en este caso /usr/bin/php8.3):

# Mautic Cron Jobs
5,20,35,50     /usr/bin/php8.3 /var/www/mautic/bin/console mautic:segments:update > /dev/null 2>&1
# Actualización de segmentos (cada 15 minutos)
10,25,40,55     /usr/bin/php8.3 /var/www/mautic/bin/console mautic:campaigns:update > /dev/null 2>&1
# Actualización de campañas (cada 15 minutos)
0,15,30,45     /usr/bin/php8.3 /var/www/mautic/bin/console mautic:campaigns:trigger > /dev/null 2>&1
# Ejecución de disparadores de campañas (cada 15 minutos)
0,30     /usr/bin/php8.3 /var/www/mautic/bin/console mautic:emails:send > /dev/null 2>&1
# Envío de correos electrónicos desde la cola (cada 30 minutos)
0 0    /usr/bin/php8.3 /var/www/mautic/bin/console mautic:maintenance:cleanup --days=365 > /dev/null 2>&1
# Limpieza de datos antiguos (una vez al día, por ejemplo, registros de más de 365 días)
0 2    /usr/bin/php8.3 /var/www/mautic/bin/console mautic:webhooks:send > /dev/null 2>&1
# Envío de webhooks (una vez al día)

Guarde y cierre el archivo. Las tareas Cron se ejecutarán automáticamente.

5. Verificación de la operatividad

Asegúrese de que Mautic esté accesible y funcione correctamente.

curl -I https://your_domain.com
# Verificación de los encabezados HTTP de su dominio. Debería tener un estado 200 OK y una redirección a HTTPS.

Inicie sesión en el panel de administración de Mautic. Vaya a la sección "Configuración" -> "Información del sistema". Asegúrese de que todos los componentes estén marcados como operativos y que no haya errores críticos.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno son clave para el funcionamiento estable y seguro de Mautic. En esta sección, veremos qué exactamente necesita ser respaldado, cómo automatizar el proceso y cómo mantener el sistema actualizado.

1. Qué respaldar

Para una recuperación completa de Mautic, necesitará tres grupos principales de datos:

• Base de datos de Mautic: Contiene todos sus contactos, campañas, segmentos, correos electrónicos, informes y otros datos dinámicos. Este es el componente más importante.
• Archivos de Mautic: Incluyen el núcleo de Mautic, plugins, temas, archivos multimedia cargados (imágenes, documentos), así como archivos de configuración. El directorio /var/www/mautic/.
• Archivos de configuración del servidor: Configuraciones de Nginx, PHP-FPM, Certbot, Fail2Ban, UFW. Aunque se pueden restaurar manualmente, una copia de seguridad acelerará el proceso.

2. Script simple de copia de seguridad automática (cron + rsync + mysqldump)

Crearemos un script simple que realizará una copia de seguridad de la base de datos y los archivos, y luego los guardará en un directorio separado. Para almacenar las copias de seguridad, se recomienda utilizar un almacenamiento externo, como un almacenamiento en la nube compatible con S3 o un VPS separado.

sudo mkdir -p /opt/backups/mautic
# Создание директории для хранения бэкапов
sudo chown mauticuser:mauticuser /opt/backups/mautic
# Установка владельца для директории бэкапов
sudo nano /opt/backups/mautic_backup.sh
# Создание скрипта бэкапа

Pegue el siguiente código en el archivo mautic_backup.sh. Reemplace mautic_user, strong_password, mautic_db con sus propios datos. También especifique la ruta al almacenamiento externo si se utiliza.

#!/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 "Database backup created: ${BACKUP_DIR}/mautic_db_${DATE}.sql.gz"
else
    echo "Error: Database backup failed!"
    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 files backup created: ${BACKUP_DIR}/mautic_files_${DATE}.tar.gz"
else
    echo "Error: Mautic files backup failed!"
    exit 1
fi

# 3. Очистка старых бэкапов
echo "Cleaning up old backups..."
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 "Old backups cleaned."

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

echo "Backup process finished."

Haga que el script sea ejecutable:

sudo chmod +x /opt/backups/mautic_backup.sh
# Делаем скрипт исполняемым

Agregue el script al crontab del usuario mauticuser para su ejecución diaria:

sudo -u mauticuser crontab -e
# Открытие crontab для пользователя mauticuser

Agregue la siguiente línea al final del archivo, por ejemplo, para que se ejecute a las 3:00 de la mañana:

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

3. Dónde almacenar las copias de seguridad

Nunca almacene las copias de seguridad en el mismo servidor que los datos de producción. Esto anula el propósito de la copia de seguridad si el servidor falla. Opciones recomendadas:

• Almacenamiento externo compatible con S3: Los servicios en la nube (Amazon S3, DigitalOcean Spaces, Backblaze B2) ofrecen almacenamiento fiable y asequible. Utilice utilidades como s3cmd o rclone para la sincronización.
• VPS o servidor dedicado separado: Puede utilizar otro servidor exclusivamente para almacenar copias de seguridad, sincronizándolas a través de SSH con rsync.
• Almacenamiento local con sincronización: Para proyectos muy pequeños, las copias de seguridad se pueden almacenar temporalmente de forma local, pero es esencial configurar su carga automática a un disco en la nube (Google Drive, Dropbox) utilizando scripts.

4. Actualizaciones: rolling vs. ventana de mantenimiento

Mantener Mautic y todos los componentes del sistema actualizados es fundamental para la seguridad y para obtener nuevas funcionalidades. Utilice la siguiente estrategia:

• Actualizaciones del SO (Ubuntu): Ejecute sudo apt update && sudo apt upgrade -y regularmente, por ejemplo, una vez a la semana. Si se requiere una recarga del kernel, planifique un reinicio del servidor.
• Actualizaciones de PHP, Nginx, MySQL: Estos componentes suelen actualizarse junto con el SO. Sin embargo, al pasar a una nueva versión principal (por ejemplo, de PHP 8.3 a 8.4), planifíquelo como una ventana de mantenimiento separada, ya que pueden ser necesarios cambios en la configuración o el código de Mautic.
• Actualizaciones de Mautic: Mautic lanza actualizaciones regulares (parches, versiones menores y mayores).
  • Parches y actualizaciones menores (5.1.0 -> 5.1.1): Generalmente se pueden aplicar en modo "rolling", pero siempre se recomienda hacer una copia de seguridad antes de actualizar. Utilice el comando php /var/www/mautic/bin/console mautic:update:find y luego php /var/www/mautic/bin/console mautic:update:apply.
  • Actualizaciones mayores (5.x -> 6.x): Requieren la planificación de una "ventana de mantenimiento". Estudie de antemano la documentación oficial de actualización de Mautic, ya que puede haber cambios en los requisitos de PHP, la estructura de la base de datos o el sistema de archivos. Asegúrese de hacer una copia de seguridad completa antes de dicha actualización.

Siempre pruebe las actualizaciones en un servidor de staging, si es posible, antes de aplicarlas en producción. Si no hay un servidor de staging, estudie cuidadosamente el changelog y haga una copia de seguridad.

Solución de problemas + Preguntas frecuentes

Incluso con la configuración más cuidadosa, pueden surgir problemas. Esta sección le ayudará a diagnosticar y resolver los más comunes, así como a responder preguntas frecuentes.

Mautic muestra un error 500 Internal Server Error o una página en blanco

Qué verificar:

1. Registros de Nginx: Verifique /var/log/nginx/mautic_error.log.
2. Registros de PHP-FPM: Verifique /var/log/php8.3-fpm.log (o una ruta similar).
3. Registros de Mautic: Verifique /var/www/mautic/var/logs/mautic_prod.php.
4. Permisos de archivos: Asegúrese de que el usuario www-data (o el usuario bajo el cual se ejecutan Nginx y PHP-FPM) tenga permisos de lectura/escritura en el directorio de Mautic, especialmente en /var/www/mautic/var. Ejecute sudo chown -R www-data:www-data /var/www/mautic y sudo chmod -R 775 /var/www/mautic.
5. Límites de PHP: Asegúrese de que memory_limit y max_execution_time en php.ini sean suficientes (por ejemplo, 512M y 300).

Los correos electrónicos no se envían desde Mautic

Qué verificar:

1. Configuración SMTP en Mautic: En "Configuración" -> "Configuración" -> "Configuración de correo electrónico". Asegúrese de que los datos del servidor SMTP (host, puerto, nombre de usuario, contraseña) sean correctos y de que esté utilizando un proveedor SMTP externo fiable.
2. Registros de Mautic: Busque errores relacionados con el envío de correo electrónico en /var/www/mautic/var/logs/mautic_prod.php.
3. Tareas Cron: Asegúrese de que mautic:emails:send se ejecute regularmente (sudo -u mauticuser crontab -l).
4. Filtros de spam: Asegúrese de que su dominio esté configurado correctamente (registros SPF, DKIM, DMARC en DNS) para evitar que los correos electrónicos terminen en spam.

Mautic funciona lento o se congela con grandes volúmenes de datos

Qué verificar:

1. Recursos del servidor: Utilice htop, free -h, df -h para monitorear CPU, RAM y disco. ¿Faltan recursos?
2. Registros de MySQL: Busque consultas lentas.
3. Índices de la base de datos: Asegúrese de que MySQL indexe correctamente las tablas de Mautic.
4. Caché de Mautic: Asegúrese de que la caché funcione (Mautic utiliza la caché de archivos por defecto, se puede configurar Redis para instalaciones grandes).
5. Tareas Cron: Asegúrese de que no se superpongan y se ejecuten a tiempo, sin crear una carga excesiva.

¿Qué configuración mínima de VPS es adecuada?

Para una instalación de prueba o un proyecto muy pequeño (hasta 5000 contactos, 1-2 campañas), puede comenzar con 2 núcleos de CPU, 4 GB de RAM y 80 GB de SSD NVMe. Sin embargo, tan pronto como comience a usar Mautic activamente, se recomienda pasar a una configuración con 4 núcleos, 8 GB de RAM y más de 160 GB de SSD NVMe para garantizar un funcionamiento estable y rápido.

¿Qué elegir: VPS o dedicado para esta tarea?

Para la mayoría de los usuarios que comienzan con Mautic, un VPS es la opción óptima. Ofrece suficiente flexibilidad, rendimiento y rentabilidad. Un servidor dedicado se justifica para volúmenes de datos muy grandes (cientos de miles de contactos), alta frecuencia de envíos (millones de correos electrónicos al mes) o si tiene requisitos estrictos de aislamiento completo de recursos y máximo rendimiento que un VPS no puede proporcionar debido a la virtualización.

¿Cómo actualizar Mautic?

Inicie sesión en Mautic como administrador. Vaya a "Configuración" (icono de engranaje en la esquina superior derecha) -> "Componentes" -> "Actualizar Mautic". Si hay una actualización disponible, Mautic le ofrecerá instalarla. También puede actualizar a través de la CLI, utilizando los comandos php /var/www/mautic/bin/console mautic:update:find y php /var/www/mautic/bin/console mautic:update:apply. ¡Siempre haga una copia de seguridad antes de actualizar!

¿Cómo aumentar el límite de carga de archivos en Mautic?

Aumente los valores de upload_max_filesize y post_max_size en el archivo /etc/php/8.3/fpm/php.ini. También asegúrese de que en la configuración de Nginx (/etc/nginx/sites-available/your_domain.com) el parámetro client_max_body_size esté configurado con un valor suficiente (por ejemplo, 100M). Después de los cambios, reinicie PHP-FPM y Nginx.

Conclusiones y próximos pasos

¡Felicidades! Ha implementado y configurado Mautic con éxito en su VPS. Ahora tiene una herramienta potente y flexible para la automatización del marketing, que está completamente bajo su control. No solo ha obtenido una plataforma funcional, sino también una valiosa experiencia en la configuración de infraestructura de servidor, lo que le será útil para cualquier proyecto futuro.

Aquí hay algunos pasos que puede seguir para utilizar su Mautic de la manera más efectiva:

• Integración con CRM y otros servicios: Mautic tiene muchos plugins para la integración con sistemas CRM populares (Salesforce, HubSpot, Zoho CRM), CMS (WordPress, Drupal), así como con proveedores SMTP externos para mejorar la entregabilidad del correo electrónico. Explore los plugins disponibles y configúrelos según sus necesidades.
• Optimización del rendimiento: Para instalaciones grandes, considere usar Redis o Memcached para el almacenamiento en caché, así como configurar la optimización de MySQL. Es posible que se requiera escalado horizontal si la carga se vuelve demasiado alta.
• Seguridad avanzada: Refuerce aún más la seguridad configurando la autenticación de dos factores para iniciar sesión en Mautic, utilizando reglas más complejas para Fail2Ban y realizando auditorías de seguridad del servidor regularmente.