Установка EPESI CRM на Ubuntu 18.04

EPESI — бесплатная open source CRM на PHP/Ajax. В этой подробной инструкции показано, как установить LAMP (Apache, MariaDB, PHP), подготовить базу данных, скачать EPESI из Git, установить зависимости через Composer, настроить права и виртуальный хост Apache, а затем пройти веб‑мастер установки. Включены советы по безопасности, проверке работоспособности и альтернативные подходы.

Что такое EPESI (в одной строке)

EPESI — это веб‑приложение CRM с поддержкой совместной работы, заметок, вложений, почтового клиента и трекинга задач и звонков.

Основные преимущества

• Лёгкий и быстрый интерфейс.
• Веб‑интерфейс, доступный из браузера.
• Неограниченные заметки и вложения файлов.
• Встроенный почтовый клиент Roundcube.
• Управление проектами, звонками и контактами.

Требования

• Сервер с Ubuntu 18.04 LTS.
• Ненулевой пользователь с правами sudo.
• Доступ в интернет для загрузки пакетов и репозиториев.

Важно: если вы планируете использовать EPESI в продакшн, рекомендуем тестировать установку на отдельной виртуальной машине перед переносом на рабочий сервер.

Подготовка системы

Перед началом обновите пакеты и перезагрузите систему:

sudo apt-get update -y
sudo apt-get upgrade -y
sudo reboot

После перезагрузки войдите снова и продолжите.

Установка LAMP (Apache, MariaDB, PHP и модули)

Установим веб‑сервер, СУБД и необходимые модули PHP (в примере — PHP 7.2, совместимая с Ubuntu 18.04):

sudo apt-get install apache2 mariadb-server php7.2 libapache2-mod-php7.2 php7.2-common php7.2-mbstring php7.2-xmlrpc php7.2-soap php7.2-gd php7.2-xml php7.2-intl php7.2-mysql php7.2-cli php7.2-ldap php7.2-zip php7.2-curl php7.2-imap unzip -y

Затем отредактируйте конфигурацию PHP для веб‑сервера:

sudo nano /etc/php/7.2/apache2/php.ini

Измените или добавьте следующие параметры (локализовал timezone для России — при необходимости укажите свою зону):

memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M
max_execution_time = 30
max_input_vars = 1500
date.timezone = Europe/Moscow

Сохраните файл и закройте редактор.

Запустите и включите службы Apache и MariaDB:

sudo systemctl start apache2
sudo systemctl enable apache2
sudo systemctl start mariadb
sudo systemctl enable mariadb

Настройка MariaDB

Безопасность MariaDB по умолчанию минимальна — запустите скрипт настройки:

sudo mysql_secure_installation

Следуйте подсказкам: задайте пароль root, удалите анонимных пользователей, запретите удалённый вход root и удалите тестовую базу.

Далее создайте базу данных и пользователя для EPESI:

sudo mysql -u root -p

Внутри консоли MariaDB выполните:

CREATE DATABASE epesidb;
CREATE USER 'epesi'@'localhost' IDENTIFIED BY 'Ваш_надёжный_пароль';
GRANT ALL PRIVILEGES ON epesidb.* TO 'epesi'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Подсказка: замените ‘Вашнадёжныйпароль’ на случайную длинную фразу. Храните пароль в менеджере паролей.

Загрузка и установка EPESI

Перейдите в /tmp и клонируйте репозиторий:

cd /tmp
git clone https://github.com/Telaxus/EPESI.git

Скопируйте файлы в корневую папку веб‑сервера:

sudo cp -r EPESI /var/www/html/epesi

Установите Composer (менеджер зависимостей PHP):

curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/local/bin --filename=composer

Перейдите в директорию EPESI и установите зависимости (рекомендуется запустить от пользователя с ограниченными правами, но если вы используете sudo, учтите предупреждение Composer):

cd /var/www/html/epesi
sudo composer install

Вы увидите вывод установки зависимостей. Это нормально, если появятся предложения установить дополнительные расширения PHP — они увеличат функциональность, но не всегда обязательны.

После установки зависимостей установите корректные права:

sudo chown -R www-data:www-data /var/www/html/epesi
sudo chmod -R 775 /var/www/html/epesi

Важно: держите файлы под пользователем веб‑сервера (www-data) и не делайте их доступными для всех.

Настройка Apache для EPESI

Создайте файл виртуального хоста:

sudo nano /etc/apache2/sites-available/epesi.conf

Вставьте конфигурацию (замените example.com на ваш домен или IP):

     ServerAdmin [email protected]
     DocumentRoot /var/www/html/epesi
     ServerName example.com
     ServerAlias www.example.com

     
          Options +FollowSymlinks
          AllowOverride All
          Require all granted
     

     ErrorLog ${APACHE_LOG_DIR}/epesi_error.log
     CustomLog ${APACHE_LOG_DIR}/epesi_access.log combined

Сохраните файл, затем включите сайт и модуль перезаписи URL:

sudo a2ensite epesi
sudo a2enmod rewrite
sudo systemctl restart apache2

Совет: если на сервере уже есть SSL, настройте HTTPS и перенаправление с 80 на 443.

Доступ к веб‑мастеру установки EPESI

Откройте браузер и перейдите по адресу http://example.com (замените на ваш хост). Процедура установки в веб‑интерфейсе состоит из нескольких шагов:

1. Выбор языка.
2. Принятие лицензионного соглашения.
3. Проверка системных требований — при появлении предупреждений можно нажать OK и продолжить, но устранение предупреждений повысит стабильность.
4. Ввод данных базы данных (epesidb, epesi, пароль).
5. Создание администратора и почтовых настроек.
6. Настройка формата даты, времени и информации о компании.

После успешной установки вы попадёте на дашборд EPESI.

ALT примечание: все изображения имеют описательные подписи на русском языке в атрибуте alt для удобства пользователей и доступности.

Проверка и тестирование после установки

Короткий чек‑лист для проверки работоспособности:

• Войдите под созданным админом и проверьте доступность основных модулей (контакты, календари, почта).
• Загрузите файл в карточку контакта — проверьте права доступа и сохранение.
• Отправьте тестовое письмо, если настроен SMTP.
• Проверьте логи Apache (/var/log/apache2/epesi_error.log) и MariaDB при ошибках.

Критерии приёмки

• Веб‑интерфейс загружается без 500 ошибок.
• База данных подключается и выполняет миграции/создание таблиц.
• Администратор может создать и редактировать записи.

Примеры тестов приёмки

• Создать контакт, прикрепить файл 2–5 МБ и убедиться, что он скачивается.
• Создать задачу, назначить на пользователя и проверить уведомления.

Безопасность и усиление защиты

Рекомендуемые шаги безопасности перед переходом в продакшн:

• Настройте HTTPS (Let’s Encrypt/certbot) и перенаправление с HTTP на HTTPS.
• Установите Firewall (ufw) и откройте только нужные порты (80, 443, SSH).
• Отключите вход root по SSH и используйте ключи вместо паролей.
• Обновляйте систему и зависимости регулярно (apt, composer).
• Делайте регулярные бэкапы базы данных и файлов (rsync, mysqldump).
• Отключите показ версий серверных компонентов в заголовках.

Пример быстрой настройки HTTPS с certbot:

sudo apt-get install certbot python-certbot-apache -y
sudo certbot --apache -d example.com -d www.example.com

Частые ошибки и их исправление

• Проблема: 500 Internal Server Error на страницах EPESI.

  • Причина: права файлов, отсутствие PHP‑модуля или синтаксическая ошибка в конфиге.
  • Решение: проверьте /var/log/apache2/epesi_error.log, убедитесь, что www-data владеет файлами, установите недостающие модули.

• Проблема: не подключается база данных.

  • Причина: неверные данные подключения или пользователь без прав.
  • Решение: проверьте credentials в мастере установки, убедитесь, что GRANT выполнен и FLUSH PRIVILEGES применён.

• Проблема: Composer выдаёт предупреждение “Do not run Composer as root”.

  • Решение: запустите composer под обычным пользователем, затем исправьте владельца директорий.

Альтернативные подходы

• Docker: собрать контейнеры для Apache/Nginx, PHP‑FPM и MariaDB. Упрощает переносимость и изоляцию.
• Использовать Nginx + PHP‑FPM вместо Apache для более высокой производительности на высоких нагрузках.
• Развертывание на управляемом хостинге для упрощения обслуживания (если нельзя управлять сервером вручную).

Краткая инструкция для Docker (идейный пример):

• Создайте docker‑compose с сервисами: web (nginx), php (php-fpm), db (mariadb), volume для данных.
• Подключите том с кодом EPESI к контейнеру php и настройте nginx как reverse proxy.

Роли и чек‑листы

Администратор сервера:

• Установить и обновить ОС.
• Настроить firewall и SSH.
• Настроить HTTPS и бэкапы.

Разработчик / интегратор:

• Клонировать репозиторий и установить зависимости.
• Настроить виртуальный хост и права.
• Подготовить конфигурации для почты и интеграций.

Конечный пользователь (админ EPESI):

• Создать учётных записей пользователей.
• Настроить шаблоны почты и права доступа.
• Импортировать контакты/данные и проверить целостность.

Миграция и совместимость

• Перед обновлением EPESI делайте бэкап базы и файлов.
• Сравнивайте требования новой версии EPESI к PHP/расширениям.
• При переходе с другой CRM экспортируйте данные в CSV/Excel и импортируйте через инструменты EPESI.

Когда EPESI не подходит (контрпример)

• Если вам нужна узконаправленная отраслевое решение с готовыми нативными модулями (например, ERP с глубоким учётом запасов), возможно, лучше рассмотреть специализированные системы.
• Если вы не готовы поддерживать сервер и обновления, выбирайте SaaS‑CRM‑решения.

Короткий справочник (1‑строчные определения)

• LAMP — набор: Linux, Apache, MariaDB/MySQL, PHP.
• Composer — менеджер зависимостей для PHP.
• VirtualHost — конфигурация Apache для отдельного сайта.

Резюме

• EPESI можно развернуть на Ubuntu 18.04: установить LAMP, настроить MariaDB, скачать репозиторий и установить зависимости через Composer.
• Настройте права на файлы, виртуальный хост Apache и HTTPS перед эксплуатацией в продакшн.
• Используйте чек‑листы ролей, выполняйте тесты приёмки и планируйте бэкапы и обновления.

Поздравляем — EPESI установлен и доступен в браузере. После развёртывания выполните базовую настройку безопасности, настройте бэкапы и проверьте интеграции с почтой и внешними сервисами.

Важно: всегда заменяйте примерные значения (example.com, пароли) на реальные и надёжные данные перед публикацией в сети.