Instalación de Dolibarr

Configuración

Después de instalar todos los componentes, es necesario configurarlos correctamente. Esto incluye Nginx para servir Dolibarr, PHP-FPM para procesar scripts y asegurar la conexión HTTPS usando Let's Encrypt.

1. Configuración de Nginx para Dolibarr

Cree un nuevo archivo de configuración de Nginx para su dominio (por ejemplo, yourdomain.com). Reemplace yourdomain.com con su dominio real.

sudo nano /etc/nginx/sites-available/dolibarr.conf

Pegue el siguiente contenido:

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /var/www/dolibarr;
    index index.php index.html index.htm;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.4-fpm.sock; # Убедитесь, что это правильная версия PHP
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # Запрещаем доступ к конфиденциальным файлам Dolibarr
    location ~ /(build|config|data|docs|install|lib|locale|sql|test)/ {
        deny all;
    }
    location ~ /\.ht {
        deny all;
    }
    location ~ \.log$ {
        deny all;
    }
    location ~ \.sql$ {
        deny all;
    }
    location ~ \.conf$ {
        deny all;
    }
    location ~ \.ini$ {
        deny all;
        # Запрещаем также .env файлы, если они используются для секретов
    }
}

Cree un enlace simbólico a este archivo en sites-enabled y elimine la configuración predeterminada de Nginx:

sudo ln -s /etc/nginx/sites-available/dolibarr.conf /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default # Удаляем дефолтный конфиг Nginx
sudo nginx -t # Проверяем синтаксис конфига Nginx
sudo systemctl restart nginx # Перезапускаем Nginx

2. Configuración de PHP-FPM

A veces es necesario aumentar los límites de memoria y tiempo de ejecución para PHP. Edite el archivo php.ini para PHP 8.4 FPM:

sudo nano /etc/php/8.4/fpm/php.ini

Encuentre y modifique los siguientes parámetros:

memory_limit = 256M # Или выше, если у вас много RAM и пользователей
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
date.timezone = Europe/Moscow # Или ваш часовой пояс

Reinicie PHP-FPM para aplicar los cambios:

sudo systemctl restart php8.4-fpm

3. Obtención de un certificado SSL con Let's Encrypt (Certbot)

HTTPS es obligatorio para cualquier aplicación web moderna. Certbot automatiza la obtención e instalación de certificados Let's Encrypt.

sudo apt install certbot python3-certbot-nginx -y # Устанавливаем Certbot для Nginx
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com # Запускаем Certbot

Siga las instrucciones de Certbot. Automáticamente modificará su configuración de Nginx, agregará redirecciones HTTPS y configurará la renovación automática del certificado. Una vez completado, su configuración de Nginx se actualizará y Dolibarr estará disponible a través de HTTPS.

4. Finalización de la instalación de Dolibarr a través de la interfaz web

Ahora que todo está configurado, abra su dominio (https://yourdomain.com) en el navegador. Verá la página de instalación de Dolibarr:

1. Paso 1: Verifique los requisitos del sistema. Asegúrese de que todas las extensiones PHP necesarias y los permisos de archivos/directorios estén marcados como "OK".
2. Paso 2: Configuración de la base de datos.
   • Tipo de base de datos: PostgreSQL
   • Nombre de host del SGBD: localhost
   • Puerto del SGBD: 5432
   • Nombre de la BD: dolibarrdb (que creamos)
   • Login de usuario de la BD: dolibarruserdb (que creamos)
   • Contraseña de usuario de la BD: su_contraseña_de_bd
3. Paso 3: Configuración de Dolibarr.
   • Ruta al directorio de datos (Dolibarr data directory): /var/lib/dolibarr/documents
   • Nombre de administrador: admin (u otro)
   • Contraseña de administrador: su_contraseña_de_administrador

Después de completar la instalación, Dolibarr le pedirá que elimine o cambie el nombre del archivo install.lock. Este es un paso importante para la seguridad:

sudo rm /var/www/dolibarr/install.lock

Ahora puede iniciar sesión en Dolibarr con el administrador creado.

5. Verificación de la funcionalidad

Abra su dominio en el navegador (https://yourdomain.com). Debería ver la página de inicio de sesión de Dolibarr. También puede verificar la accesibilidad usando curl desde el servidor:

curl -v https://yourdomain.com

En la salida, debería ver una respuesta HTTP exitosa (código 200) e información sobre el certificado Let's Encrypt.

Copias de seguridad y mantenimiento

Las copias de seguridad regulares y el mantenimiento oportuno son clave para el funcionamiento estable y seguro de Dolibarr. La pérdida de datos puede ser catastrófica para cualquier negocio.

Qué respaldar

Para una recuperación completa de Dolibarr, necesitará tres componentes principales:

1. Base de datos PostgreSQL: Contiene todos sus datos de negocio (clientes, facturas, pedidos, productos, etc.). Este es el componente más crítico.
2. Directorio de documentos de Dolibarr: /var/lib/dolibarr/documents. Aquí se almacenan los archivos adjuntos, facturas en PDF, informes de usuario y otros datos no estructurados.
3. Archivos de configuración de Dolibarr: /var/www/dolibarr/conf/conf.php. Contiene los parámetros de conexión a la base de datos y otras configuraciones importantes. También es útil respaldar los archivos de configuración de Nginx (/etc/nginx/sites-available/dolibarr.conf) y PHP (/etc/php/8.4/fpm/php.ini).

Script sencillo de copia de seguridad automática

Crearemos un script sencillo que realizará un volcado de la base de datos y archivará el directorio de documentos. Luego, estos archivos se moverán a una ubicación segura.

sudo mkdir -p /opt/backups/dolibarr # Creamos el directorio para las copias de seguridad
sudo nano /opt/backups/dolibarr_backup.sh

Pegue el siguiente contenido en el archivo dolibarr_backup.sh. Reemplace YOUR_DB_PASSWORD con la contraseña del usuario de la base de datos dolibarruserdb.

#!/bin/bash

# Variables
DB_NAME="dolibarrdb"
DB_USER="dolibarruserdb"
DB_PASSWORD="YOUR_DB_PASSWORD" # Ingrese su contraseña de la BD
BACKUP_DIR="/opt/backups/dolibarr"
DOLIBARR_DOCS_DIR="/var/lib/dolibarr/documents"
CONFIG_FILE="/var/www/dolibarr/conf/conf.php"
NGINX_CONFIG="/etc/nginx/sites-available/dolibarr.conf"
PHP_CONFIG="/etc/php/8.4/fpm/php.ini"
DATE=$(date +%Y%m%d%H%M%S)
FILENAME_PREFIX="dolibarr_backup_${DATE}"

# Creación del volcado de la base de datos PostgreSQL
echo "Creando volcado de la base de datos..."
PGPASSWORD="${DB_PASSWORD}" pg_dump -U "${DB_USER}" -d "${DB_NAME}" > "${BACKUP_DIR}/${FILENAME_PREFIX}_db.sql"
if [ $? -eq 0 ]; then
    echo "Volcado de la base de datos creado exitosamente: ${BACKUP_DIR}/${FILENAME_PREFIX}_db.sql"
else
    echo "¡Error al crear el volcado de la base de datos!"
    exit 1
fi

# Archivando el directorio de documentos y configuraciones
echo "Archivando el directorio de documentos y configuraciones..."
tar -czf "${BACKUP_DIR}/${FILENAME_PREFIX}_files.tar.gz" -C "$(dirname ${DOLIBARR_DOCS_DIR})" "$(basename ${DOLIBARR_DOCS_DIR})" \
    -C "$(dirname ${CONFIG_FILE})" "$(basename ${CONFIG_FILE})" \
    -C "$(dirname ${NGINX_CONFIG})" "$(basename ${NGINX_CONFIG})" \
    -C "$(dirname ${PHP_CONFIG})" "$(basename ${PHP_CONFIG})"
if [ $? -eq 0 ]; then
    echo "Archivo de ficheros creado exitosamente: ${BACKUP_DIR}/${FILENAME_PREFIX}_files.tar.gz"
else
    echo "¡Error al archivar los ficheros!"
    exit 1
fi

# Eliminando copias de seguridad antiguas (guardamos las últimas 7 días)
echo "Eliminando copias de seguridad antiguas..."
find "${BACKUP_DIR}" -type f -name "dolibarr_backup_*.sql" -mtime +7 -delete
find "${BACKUP_DIR}" -type f -name "dolibarr_backup_*.tar.gz" -mtime +7 -delete
echo "Copias de seguridad de más de 7 días eliminadas."

echo "Copia de seguridad de Dolibarr completada."

Haga el script ejecutable:

sudo chmod +x /opt/backups/dolibarr_backup.sh

Agregue el script a cron para su ejecución diaria (por ejemplo, a las 3:00 AM):

sudo crontab -e

Agregue la siguiente línea al final del archivo:

0 3 * * * /opt/backups/dolibarr_backup.sh >> /var/log/dolibarr_backup.log 2>&1

Dónde almacenar las copias de seguridad

Almacenar las copias de seguridad en el mismo servidor que Dolibarr es muy arriesgado. Si el servidor falla, perderá tanto el sistema como las copias de seguridad. Se recomienda utilizar una de las siguientes soluciones:

• Almacenamiento de objetos externo compatible con S3: La opción más fiable y escalable. Utilice utilidades como s3cmd, rclone o awscli (si usa AWS S3) para la carga automática de copias de seguridad.
• VPS o servidor dedicado separado: Simplemente sincronice las copias de seguridad por SSH usando rsync a otro servidor.
• Almacenamiento en red NFS/SMB: Si tiene una red local con un NAS.

Ejemplo de cómo añadir rsync al script (después de eliminar las copias de seguridad antiguas):

# Sincronización de copias de seguridad a un servidor remoto (reemplace user@remote_host:/path/to/backups)
echo "Sincronizando copias de seguridad a un servidor remoto..."
rsync -avz --remove-source-files "${BACKUP_DIR}/" user@remote_host:/path/to/backups/
if [ $? -eq 0 ]; then
    echo "Copias de seguridad sincronizadas exitosamente al servidor remoto."
else
    echo "¡Error al sincronizar las copias de seguridad al servidor remoto!"
fi

Actualizaciones: rolling vs ventana de mantenimiento

• Actualizaciones del SO y del stack de software (Nginx, PHP, PostgreSQL): Para el software del sistema, se recomienda utilizar una "ventana de mantenimiento". Programe un momento en el que el sistema se utilice mínimamente y ejecute sudo apt update && sudo apt upgrade -y. Siempre realice una copia de seguridad antes de actualizar.
• Actualizaciones de Dolibarr: La actualización del propio sistema Dolibarr (por ejemplo, de la versión 20.0 a la 21.0) requiere un enfoque diferente. Normalmente, esto implica descargar la nueva versión, reemplazar los archivos (excepto los directorios conf y documents) y luego ejecutar el script de actualización a través de la interfaz web. Siempre lea la documentación oficial de actualización de Dolibarr para la versión específica y realice una copia de seguridad completa antes de comenzar.
• Renovación automática de Let's Encrypt: Certbot está configurado por defecto para la renovación automática de certificados. Puede verificar el estado de la tarea cron para Certbot: sudo systemctl status certbot.timer.

Troubleshooting + FAQ

Incluso con una configuración cuidadosa, pueden surgir problemas. A continuación, se presentan preguntas frecuentes y sus soluciones.

No puedo acceder a Dolibarr a través del navegador (HTTP 502 Bad Gateway)

Qué verificar: El error 502 generalmente significa que Nginx no puede comunicarse con PHP-FPM.

• Verifique si PHP-FPM está en ejecución:

  sudo systemctl status php8.4-fpm

• Verifique los logs de PHP-FPM:

  sudo journalctl -u php8.4-fpm

• Verifique si la ruta al socket de PHP-FPM está correctamente especificada en la configuración de Nginx (fastcgi_pass unix:/run/php/php8.4-fpm.sock;).
• Asegúrese de que el usuario www-data (bajo el cual se ejecuta Nginx) tenga permisos de lectura/escritura para el socket de PHP-FPM.

No puedo acceder a Dolibarr a través del navegador (HTTP 403 Forbidden)

Qué verificar: El error 403 generalmente significa que Nginx puede encontrar los archivos, pero tiene prohibido servirlos.

• Verifique los permisos del directorio /var/www/dolibarr. El usuario www-data debe ser el propietario o tener permisos de lectura/ejecución.

  sudo ls -la /var/www/dolibarr

• Verifique que no haya reglas deny all; en la configuración de Nginx que bloqueen erróneamente el acceso a los archivos necesarios.

sudo chown -R www-data:www-data /var/www/dolibarr && sudo chmod -R 750 /var/www/dolibarr

No puedo conectar a la base de datos PostgreSQL desde Dolibarr

Qué verificar:

• Asegúrese de que PostgreSQL esté en ejecución:

  sudo systemctl status postgresql

• Verifique el nombre de la base de datos, el usuario y la contraseña en el archivo /var/www/dolibarr/conf/conf.php (después de la instalación a través de la interfaz web).
• Intente conectar a la base de datos manualmente desde el servidor:

  sudo -i -u postgres psql -d dolibarrdb -U dolibarruserdb

  (ingrese la contraseña).
• Verifique los logs de PostgreSQL en busca de errores:

  sudo journalctl -u postgresql

El certificado Let's Encrypt no se renueva automáticamente

Qué verificar:

• Verifique el estado del temporizador de Certbot:

  sudo systemctl status certbot.timer

• Intente realizar la renovación manualmente:

  sudo certbot renew --dry-run

  (para prueba) o

  sudo certbot renew

  (para renovación real).
• Verifique los logs de Certbot:

  sudo less /var/log/letsencrypt/letsencrypt.log

• Asegúrese de que los puertos 80 y 443 estén abiertos en UFW.

No puedo subir archivos a Dolibarr (por ejemplo, adjuntos a facturas)

Qué verificar:

• Verifique los permisos del directorio de datos de Dolibarr: /var/lib/dolibarr/documents. El usuario www-data debe tener permisos de escritura.

  sudo ls -la /var/lib/dolibarr/documents

• Verifique los valores de upload_max_filesize y post_max_size en /etc/php/8.4/fpm/php.ini. Si los archivos son demasiado grandes, PHP podría rechazarlos.

sudo chown -R www-data:www-data /var/lib/dolibarr/documents && sudo chmod -R 750 /var/lib/dolibarr/documents

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

Para un equipo pequeño (1-5 usuarios activos) y un uso moderado de Dolibarr, un VPS con 2 núcleos de CPU, 4 GB de RAM y 80 GB de SSD NVMe será mínimamente adecuado. Esto proporcionará suficientes recursos para el sistema operativo, PostgreSQL, Nginx y PHP-FPM. Sin embargo, a medida que aumente el número de usuarios o la intensidad del trabajo con el sistema, se recomienda escalar los recursos para evitar ralentizaciones y garantizar un funcionamiento cómodo.

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

Para la mayoría de las pequeñas y medianas empresas, autónomos y startups, un VPS será la opción óptima. Ofrece suficiente rendimiento, flexibilidad y rentabilidad. Un servidor dedicado tiene sentido si tiene un equipo muy grande (más de 50 usuarios), altos requisitos de rendimiento de la base de datos, estrictas normativas de seguridad y aislamiento, o si planea alojar muchos otros servicios que consumen muchos recursos en un solo host. Los servidores dedicados proporcionan control total sobre el hardware y recursos exclusivos, pero son significativamente más caros y requieren un mayor nivel de administración.

Conclusiones y próximos pasos

Ha desplegado con éxito Dolibarr ERP/CRM en su VPS, utilizando el stack Nginx, PostgreSQL y PHP-FPM, y ha asegurado una conexión segura con Let's Encrypt. Ahora tiene una plataforma potente y flexible para gestionar todos los aspectos de su negocio, completamente bajo su control.

Aquí hay algunos pasos que puede seguir para el desarrollo y la optimización de su sistema:

1. Configuración de monitoreo: Instale sistemas de monitoreo (por ejemplo, Prometheus + Grafana o Zabbix) para rastrear el rendimiento del servidor, el uso de recursos y la salud de Dolibarr. Esto ayudará a identificar problemas antes de que se vuelvan críticos.
2. Exploración de módulos de Dolibarr: Dolibarr cuenta con una amplia tienda de módulos (DoliStore) que pueden extender la funcionalidad del sistema para las necesidades específicas de su negocio. Explore las integraciones y extensiones disponibles.
3. Optimización del rendimiento: A medida que la carga aumente, puede considerar la optimización de PostgreSQL (ajuste de postgresql.conf), PHP-FPM (configuración de pools de procesos) y Nginx (almacenamiento en caché).
4. Implementación de CI/CD: Para desarrolladores o equipos que personalizan activamente Dolibarr, la configuración de un pipeline de integración continua/entrega continua (CI/CD) ayudará a automatizar el despliegue de actualizaciones y cambios.