Встановлення Dolibarr ERP

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

Після встановлення всіх компонентів необхідно їх правильно налаштувати. Це включає Nginx для обслуговування Dolibarr, PHP-FPM для обробки скриптів та забезпечення HTTPS-з'єднання за допомогою Let's Encrypt.

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

Створіть новий файл конфігурації Nginx для вашого домену (наприклад, yourdomain.com). Замініть yourdomain.com на ваш реальний домен.

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

Вставте наступний вміст:

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 файли, якщо вони використовуються для секретів
    }
}

Створіть символічне посилання на цей файл у sites-enabled та видаліть дефолтний конфіг 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. Налаштування PHP-FPM

Іноді потрібно збільшити ліміти пам'яті та часу виконання для PHP. Відредагуйте файл php.ini для PHP 8.4 FPM:

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

Знайдіть та змініть наступні параметри:

memory_limit = 256M # Або вище, якщо у вас багато RAM та користувачів
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 300
date.timezone = Europe/Moscow # Або ваш часовий пояс

Перезапустіть PHP-FPM для застосування змін:

3. Отримання SSL-сертифіката з Let's Encrypt (Certbot)

HTTPS є обов'язковим для будь-якого сучасного веб-застосунку. Certbot автоматизує отримання та встановлення сертифікатів Let's Encrypt.

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

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

4. Завершення встановлення Dolibarr через веб-інтерфейс

Тепер, коли все налаштовано, відкрийте ваш домен (https://yourdomain.com) у браузері. Ви побачите сторінку встановлення Dolibarr:

1. Крок 1: Перевірте системні вимоги. Переконайтеся, що всі необхідні розширення PHP та права доступу до файлів/директорій відзначені як "OK".
2. Крок 2: Налаштування бази даних.
   • Тип бази даних: PostgreSQL
   • Ім'я хоста СУБД: localhost
   • Порт СУБД: 5432
   • Ім'я БД: dolibarrdb (яку ми створили)
   • Логін користувача БД: dolibarruserdb (якого ми створили)
   • Пароль користувача БД: ваш_пароль_від_бд
3. Крок 3: Налаштування Dolibarr.
   • Шлях до директорії даних (Dolibarr data directory): /var/lib/dolibarr/documents
   • Ім'я адміністратора: admin (або інше)
   • Пароль адміністратора: ваш_пароль_адміністратора

Після завершення встановлення Dolibarr попросить вас видалити або перейменувати файл install.lock. Це важливий крок для безпеки:

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

Тепер ви можете увійти до Dolibarr під створеним адміністратором.

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

Відкрийте ваш домен у браузері (https://yourdomain.com). Ви повинні побачити сторінку входу до Dolibarr. Ви також можете перевірити доступність за допомогою curl з сервера:

curl -v https://yourdomain.com

У виводі ви повинні побачити успішну HTTP-відповідь (код 200) та інформацію про сертифікат Let's Encrypt.

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

Регулярне резервне копіювання та своєчасне обслуговування є ключовими для стабільної та безпечної роботи Dolibarr. Втрата даних може бути катастрофічною для будь-якого бізнесу.

Що резервувати

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

1. База даних PostgreSQL: Містить усі ваші бізнес-дані (клієнти, рахунки, замовлення, продукти тощо). Це найкритичніший компонент.
2. Директорія документів Dolibarr: /var/lib/dolibarr/documents. Тут зберігаються прикріплені файли, рахунки у PDF, користувацькі звіти та інші неструктуровані дані.
3. Конфігураційні файли Dolibarr: /var/www/dolibarr/conf/conf.php. Містить параметри підключення до бази даних та інші важливі налаштування. Також корисно резервувати конфіги Nginx (/etc/nginx/sites-available/dolibarr.conf) та PHP (/etc/php/8.4/fpm/php.ini).

Простий скрипт авторезервування

Ми створимо простий скрипт, який виконуватиме дамп бази даних та архівуватиме директорію документів. Потім ці файли будуть переміщені у безпечне місце.

sudo mkdir -p /opt/backups/dolibarr # Створюємо директорію для резервних копій
sudo nano /opt/backups/dolibarr_backup.sh

Вставте наступний вміст у файл dolibarr_backup.sh. Замініть YOUR_DB_PASSWORD на пароль користувача бази даних dolibarruserdb.

#!/bin/bash

# Переменные
DB_NAME="dolibarrdb"
DB_USER="dolibarruserdb"
DB_PASSWORD="YOUR_DB_PASSWORD" # Введіть ваш пароль від БД
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}"

# Створення дампу бази даних PostgreSQL
echo "Створення дампу бази даних..."
PGPASSWORD="${DB_PASSWORD}" pg_dump -U "${DB_USER}" -d "${DB_NAME}" > "${BACKUP_DIR}/${FILENAME_PREFIX}_db.sql"
if [ $? -eq 0 ]; then
    echo "Дамп бази даних успішно створено: ${BACKUP_DIR}/${FILENAME_PREFIX}_db.sql"
else
    echo "Помилка при створенні дампу бази даних!"
    exit 1
fi

# Архівування директорії документів та конфігів
echo "Архівування директорії документів та конфігів..."
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 "Архів файлів успішно створено: ${BACKUP_DIR}/${FILENAME_PREFIX}_files.tar.gz"
else
    echo "Помилка при архівуванні файлів!"
    exit 1
fi

# Видалення старих резервних копій (зберігаємо останні 7 днів)
echo "Видалення старих резервних копій..."
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 "Резервні копії старші 7 днів видалено."

echo "Резервне копіювання Dolibarr завершено."

Зробіть скрипт виконуваним:

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

Додайте скрипт до cron для щоденного виконання (наприклад, о 3:00 ранку):

sudo crontab -e

Додайте наступний рядок у кінець файлу:

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

Куди зберігати резервні копії

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

• Зовнішнє S3-сумісне об'єктне сховище: Найбільш надійний та масштабований варіант. Використовуйте утиліти типу s3cmd, rclone або awscli (якщо використовуєте AWS S3) для автоматичного завантаження резервних копій.
• Окремий VPS або виділений сервер: Просто синхронізуйте резервні копії по SSH за допомогою rsync на інший сервер.
• Мережеве сховище NFS/SMB: Якщо у вас є локальна мережа з NAS.

Приклад додавання rsync до скрипта (після видалення старих резервних копій):

# Синхронізація резервних копій на віддалений сервер (замініть user@remote_host:/path/to/backups)
echo "Синхронізація резервних копій на віддалений сервер..."
rsync -avz --remove-source-files "${BACKUP_DIR}/" user@remote_host:/path/to/backups/
if [ $? -eq 0 ]; then
    echo "Резервні копії успішно синхронізовано на віддалений сервер."
else
    echo "Помилка при синхронізації резервних копій на віддалений сервер!"
fi

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

• Оновлення ОС та ПЗ стеку (Nginx, PHP, PostgreSQL): Для системного ПЗ рекомендується використовувати "maintenance window" (вікно обслуговування). Заплануйте час, коли система використовується мінімально, і виконайте sudo apt update && sudo apt upgrade -y. Завжди робіть резервну копію перед оновленням.
• Оновлення Dolibarr: Оновлення самої системи Dolibarr (наприклад, з версії 20.0 до 21.0) вимагає окремого підходу. Зазвичай це включає завантаження нової версії, заміну файлів (крім директорії conf та documents), а потім запуск скрипта оновлення через веб-інтерфейс. Завжди читайте офіційну документацію щодо оновлення Dolibarr для конкретної версії та робіть повну резервну копію перед початком.
• Автоматичне продовження Let's Encrypt: Certbot за замовчуванням налаштований на автоматичне продовження сертифікатів. Ви можете перевірити статус cron-завдання для Certbot: sudo systemctl status certbot.timer.

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

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

Не можу отримати доступ до Dolibarr через браузер (HTTP 502 Bad Gateway)

Що перевірити: Помилка 502 зазвичай означає, що Nginx не може зв'язатися з PHP-FPM.

• Перевірте, чи запущено PHP-FPM:

  sudo systemctl status php8.4-fpm

• Перевірте логи PHP-FPM:

  sudo journalctl -u php8.4-fpm

• Перевірте, чи правильно вказано шлях до сокету PHP-FPM у конфігу Nginx (fastcgi_pass unix:/run/php/php8.4-fpm.sock;).
• Переконайтеся, що користувач www-data (від імені якого працює Nginx) має права на читання/запис до сокету PHP-FPM.

Не можу отримати доступ до Dolibarr через браузер (HTTP 403 Forbidden)

Що перевірити: Помилка 403 означає, що Nginx може знайти файли, але йому заборонено їх віддавати.

• Перевірте права доступу до директорії /var/www/dolibarr. Користувач www-data повинен бути власником або мати права на читання/виконання.

  sudo ls -la /var/www/dolibarr

• Перевірте, що в конфігу Nginx немає правил deny all;, які помилково блокують доступ до потрібних файлів.

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

Не можу підключитися до бази даних PostgreSQL з Dolibarr

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

• Переконайтеся, що PostgreSQL запущено:

  sudo systemctl status postgresql

• Перевірте ім'я бази даних, користувача та пароль у файлі /var/www/dolibarr/conf/conf.php (після встановлення через веб-інтерфейс).
• Спробуйте підключитися до бази даних вручну з сервера:

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

  (введіть пароль).
• Перевірте логи PostgreSQL на помилки:

  sudo journalctl -u postgresql

Сертифікат Let's Encrypt не продовжується автоматично

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

• Перевірте статус таймера Certbot:

  sudo systemctl status certbot.timer

• Спробуйте виконати продовження вручну:

  sudo certbot renew --dry-run

  (для тесту) або

  sudo certbot renew

  (для реального продовження).
• Перевірте логи Certbot:

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

• Переконайтеся, що порти 80 і 443 відкриті в UFW.

Не можу завантажити файли в Dolibarr (наприклад, вкладення до рахунків)

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

• Перевірте права доступу до директорії даних Dolibarr: /var/lib/dolibarr/documents. Користувач www-data повинен мати права на запис.

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

• Перевірте значення upload_max_filesize та post_max_size у /etc/php/8.4/fpm/php.ini. Якщо файли занадто великі, PHP може їх відхиляти.

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

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

Для невеликої команди (1-5 активних користувачів) та помірного використання Dolibarr мінімально підійде VPS з 2 ядрами CPU, 4 GB RAM та 80 GB NVMe SSD. Це забезпечить достатньо ресурсів для операційної системи, PostgreSQL, Nginx та PHP-FPM. Однак, при зростанні кількості користувачів або інтенсивності роботи з системою, рекомендується масштабувати ресурси, щоб уникнути уповільнень та забезпечити комфортну роботу.

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

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

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

Ви успішно розгорнули Dolibarr ERP/CRM на вашому VPS, використовуючи стек Nginx, PostgreSQL та PHP-FPM, а також забезпечили безпечне з'єднання за допомогою Let's Encrypt. Тепер у вас є потужна та гнучка платформа для управління всіма аспектами вашого бізнесу, повністю під вашим контролем.

Ось кілька кроків, які ви можете зробити для подальшого розвитку та оптимізації вашої системи:

1. Налаштування моніторингу: Встановіть системи моніторингу (наприклад, Prometheus + Grafana або Zabbix) для відстеження продуктивності сервера, використання ресурсів та стану Dolibarr. Це допоможе виявляти проблеми до того, як вони стануть критичними.
2. Вивчення модулів Dolibarr: Dolibarr має великий магазин модулів (DoliStore), які можуть розширити функціональність системи під специфічні потреби вашого бізнесу. Вивчіть доступні інтеграції та розширення.
3. Оптимізація продуктивності: Зі зростанням навантаження ви можете розглянути оптимізацію PostgreSQL (тюнінг postgresql.conf), PHP-FPM (налаштування пулів процесів) та Nginx (кешування).
4. Впровадження CI/CD: Для розробників або команд, які активно кастомізують Dolibarr, налаштування конвеєра безперервної інтеграції/безперервної поставки (CI/CD) допоможе автоматизувати розгортання оновлень та змін.