Установка SuiteCRM · 7 min read · Oct 13, 2025

Как установить SuiteCRM на Debian 12

SuiteCRM — это бесплатное и открытое программное обеспечение CRM (Управление взаимоотношениями с клиентами), написанное на PHP. Оно помогает организовать и управлять маркетингом, продажами и службой поддержки клиентов вашего бизнеса. SuiteCRM подходит почти для каждой отрасли, такой как производство, государственный сектор, технологии, финансы, образование и т. д.

В этом руководстве мы шаг за шагом проведем вас через установку SuiteCRM на сервер Debian 12. Вы установите и запустите SuiteCRM с помощью LAMP Stack (Apache2, MariaDB и PHP) на вашем Debian-устройстве. Вы также защитите SuiteCRM с помощью сертификатов SSL/TLS от Letsencrypt.

Предварительные требования

Следующие требования необходимы для продолжения этого руководства:

  • Сервер Debian 12.
    Пользователь, не являющийся root, с правами администратора.
    Доменное имя, указывающее на IP-адрес сервера.

Установка зависимостей

SuiteCRM — это программное обеспечение CRM, написанное на PHP с MySQL/MariaDB в качестве базы данных. В этом руководстве вы будете запускать SuiteCRM с помощью LAMP Stack (Apache2, MariaDB и PHP), и теперь вы установите пакеты LAMP Stack с дополнительными расширениями PHP.

Сначала обновите индекс пакетов Debian с помощью команды apt update ниже.

sudo apt update

обновление репозитория

Теперь установите пакеты LAMP Stack (Apache2, MariaDB и PHP) с некоторыми расширениями PHP, используя следующую команду.

sudo apt install apache2 mariadb-server php php-cli php-mysql php-bcmath php-xml php-zip php-curl php-mbstring php-gd php-tidy php-intl php-cli php-opcache php-soap php-imap php-ldap unzip

Введите y, чтобы продолжить установку.

установка зависимостей

Далее выполните следующую команду systemctl, чтобы проверить службу apache2. Это обеспечит, что служба apache2 включена и работает.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Вывод enabled подтверждает, что apache2 включен, а вывод active (running) подтверждает, что apache2 работает.

проверка apache2

Проверьте службу mariadb, используя следующую команду.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Аналогично выводу службы apache2, вы должны увидеть, что служба mariadb включена и работает.

проверка mariadb

Наконец, проверьте версию PHP и некоторые включенные расширения, выполнив следующую команду.

php -v  
php -m

Следующий вывод показывает, что PHP 8.2 установлен с некоторыми включенными модулями, такими как curl, exif, fileinfo и gd.

проверка php

Настройка сервера MariaDB

После установки зависимостей вы защитите установку вашего сервера MariaDB и создадите новую базу данных и пользователя, которые будут использоваться для SuiteCRM.

Выполните команду mariadb-secure-installation ниже, чтобы защитить ваш сервер MariaDB.

sudo mariadb-secure-installation

В процессе введите Y, чтобы подтвердить конфигурацию, или n для Нет и отклонить изменения.

  • Переключиться на аутентификацию unix_socket? Введите n и нажмите ENTER. Пользователь root MariaDB уже защищен. Опционально, вы также можете включить его, введя y для да.
  • Изменить пароль root? Введите y, чтобы подтвердить и установить новый пароль root для MariaDB.
  • Удалить анонимного пользователя? Введите y, чтобы подтвердить.
  • Запретить удаленный вход root? Введите y, чтобы подтвердить. Только локальное соединение будет разрешено, если вы используете пользователя root MariaDB.
  • Удалить тестовую базу данных и доступ к ней? Введите y, чтобы подтвердить и удалить базу данных по умолчанию ‘test’.
  • Наконец, введите y снова, чтобы перезагрузить все привилегии таблиц на вашем сервере MariaDB и применить новые изменения.

Теперь, когда MariaDB защищен, вы создадите новую базу данных и пользователя для SuiteCRM.

Войдите на сервер MariaDB через команду клиента mariadb ниже. Введите свой пароль root для MariaDB, когда будет предложено.

sudo mariadb -u root -p

Далее выполните следующие запросы, чтобы создать новую базу данных suitecrmdb и пользователя suitecrm с паролем password. Обязательно измените пароль на свой собственный.

CREATE DATABASE suitecrmdb;  
CREATE USER 'suitecrm'@'localhost' IDENTIFIED BY 'password';  
GRANT ALL PRIVILEGES ON suitecrmdb.* TO 'suitecrm'@'localhost';  
FLUSH PRIVILEGES;

создание базы данных и пользователя

Теперь выполните следующий запрос, чтобы проверить пользователя suitecrm.

SHOW GRANTS FOR 'suitecrm'@'localhost';

В следующем выводе вы должны увидеть, что пользователь suitecrm имеет доступ к базе данных suitecrmdb.

проверка пользователя базы данных

Введите quit, чтобы выйти из сервера MariaDB.

Настройка PHP

Теперь, когда сервер MariaDB настроен, следующим шагом будет настройка вашей установки PHP. SuiteCRM требует некоторых изменений в конфигурациях PHP, таких как пользовательская error_reporting, включение модуля OPCache, а также пользовательские upload_max_filesize и post_max_size.

Откройте конфигурацию PHP по умолчанию /etc/php/8.2/apache2/php.ini и /etc/php/8.2/cli/php.ini с помощью следующей команды редактора nano.

sudo nano /etc/php/8.2/apache2/php.ini  
sudo nano /etc/php/8.2/cli/php.ini

Измените параметры по умолчанию некоторых конфигураций, используя следующие строки. Обязательно настройте date.timezone на ваш часовой пояс сервера и memory_limit на память сервера.

date.timezone = Europe/Amsterdam  
  
max_execution_time = 60  
memory_limit = 256M  
  
upload_max_filesize = 25M  
post_max_size = 25M

Измените параметр error_reporting по умолчанию следующим образом:

error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE & ~E_WARNING

Уберите комментарий с параметра session.save_path, чтобы настроить путь по умолчанию для сессий на /var/lib/php/sessions.

session.save_path = "/var/lib/php/sessions"

Теперь включите расширение OPCache и настройте некоторые параметры, как показано ниже:

opcache.enable=1  
  
; Размер хранилища общей памяти OPcache.  
opcache.memory_consumption=256  
  
; Максимальное количество ключей (скриптов) в хеш-таблице OPcache.  
; Разрешены только числа от 200 до 100000.  
opcache.max_accelerated_files=20000  
  
; При отключении вам нужно будет вручную сбросить OPcache или перезапустить  
; веб-сервер, чтобы изменения в файловой системе вступили в силу.  
opcache.validate_timestamps=0

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

Теперь выполните следующую команду systemctl, чтобы перезапустить службу apache2 и применить внесенные вами изменения.

sudo systemctl restart apache2

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

На этом этапе LAMP Stack теперь настроен для SuiteCRM. Теперь вы загрузите исходный код SuiteCRM и установите его через командную строку.

Создайте новый каталог /var/www/suitecrm, который будет использоваться в качестве целевой установки для SuiteCRM.

mkdir -p /var/www/suitecrm

Перейдите в каталог /var/www/suitecrm и загрузите исходный код SuiteCRM, используя команду wget ниже. Обязательно проверьте страницу загрузки SuiteCRM, чтобы получить последнюю версию исходного кода. В настоящее время SuiteCRM 8.4 является последней версией.

cd /var/www/suitecrm  
wget https://suitecrm.com/download/142/suite84/562972/suitecrm-8-4-0.zip

После загрузки извлеките файл suitecrm-8-4-0.zip с помощью команды unzip ниже.

unzip suitecrm-8-4-0.zip

Затем выполните следующую команду, чтобы настроить правильные разрешения и владельца исходного кода SuiteCRM.

find . -type d -not -perm 2755 -exec chmod 2755 {} \;  
find . -type f -not -perm 0644 -exec chmod 0644 {} \;  
find . ! -user www-data -exec chown www-data:www-data {} \;  
chmod +x bin/console

Наконец, выполните бинарный файл /var/www/suitecrm/bin/console, чтобы установить SuiteCRM через командную строку. Обязательно измените данные о названии базы данных, пользователе, хосте, целевом доменном имени, пользователе администратора и пароле, которые будут использоваться для вашей установки SuiteCRM.

sudo -u www-data ./bin/console suitecrm:app:install -u "alice" -p "password" -U "suitecrm" -P "password" -H "127.0.0.1" -N "suitecrmdb" -S "http://suitecrm.howtoforge.local/"

После завершения установки следующий вывод будет показан в вашем терминале:

установка suitcrm через cli

Настройка виртуального хоста Apache2 для Suite

На следующем шаге вы создадите новую конфигурацию виртуального хоста Apache2, которая будет использоваться для запуска SuiteCRM. Прежде чем продолжить, убедитесь, что у вас есть доменное имя, указывающее на IP-адрес вашего сервера.

Выполните команду a2enmod ниже, чтобы включить модули Apache2, необходимые для SuiteCRM.

sudo a2enmod rewrite ssl header

Затем создайте новую конфигурацию виртуального хоста Apache2 /etc/apache2/sites-available/suitecrm.conf с помощью следующей команды редактора nano.

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

Вставьте следующую конфигурацию и обязательно измените опцию ServerName на ваше доменное имя.

  
  
 DocumentRoot /var/www/suitecrm/public  
 ServerName suitecrm.howtoforge.local  
  
   
    Options FollowSymLinks  
    AllowOverride All  
   
  
 ErrorLog /var/log/apache2/suitecrm-error.log  
 CustomLog /var/log/apache2/suitecrm-access.log common  
  

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

Теперь выполните следующую команду, чтобы активировать файл виртуального хоста suitecrm.conf и проверить ваши конфигурации Apache2.

sudo a2ensite suitecrm.conf  
sudo apachectl configtest

Если у вас правильный синтаксис, вы должны получить вывод Syntax OK.

настройка vhosts

Далее выполните команду systemctl ниже, чтобы перезапустить службу apache2 и применить изменения.

sudo systemctl restart apache2

Наконец, откройте веб-браузер и посетите доменное имя вашей установки SuiteCRM, например http://suitecrm.howtoforge.local/. Если все пройдет хорошо, вы должны увидеть страницу входа в SuiteCRM.

Защита SuiteCRM с помощью SSL/TLS от Letsencrypt

С учетом всего настроенного, теперь вы защитите SuiteCRM с помощью сертификатов SSL/TLS от Letsencrypt.

Установите Certbot и плагин Certbot Apache, используя следующую команду apt install. Введите y, чтобы продолжить установку.

sudo apt install certbot python3-certbot-apache

Теперь выполните команду certbot ниже, чтобы сгенерировать сертификаты SSL/TLS. Обязательно измените доменное имя и адрес электронной почты в следующей команде.

sudo certbot --apache --agree-tos --no-eff-email  --redirect --hsts --staple-ocsp --email [email protected] -d suitecrm.howtoforge.local

После завершения процесса ваши SSL-сертификаты будут сгенерированы в каталоге /etc/letsencrypt/live/suitecrm.howtoforge.local. Также файл виртуального хоста SuiteCRM suitecrm.conf будет автоматически настроен с HTTPS.

Вернитесь в ваш веб-браузер и посетите ваше доменное имя SuiteCRM, вы должны быть перенаправлены на страницу входа SuiteCRM для безопасных HTTPS-соединений. Введите своего пользователя администратора и пароль, затем нажмите Войти.

страница входа suitecrm

Если все пройдет хорошо, вы должны увидеть панель управления администратора SuiteCRM, как показано ниже:

панель управления suitecrm

Заключение

В заключение, вы успешно установили SuiteCRM на сервер Debian 12 с LAMP Stack (Apache2, MariaDB и PHP). Вы также защитили SuiteCRM с помощью сертификатов SSL/TLS Letsencrypt, которые были сгенерированы через Certbot. Теперь вы можете использовать SuiteCRM в качестве основного приложения CRM (Управление взаимоотношениями с клиентами) для вашего бизнеса, и вы можете начать с добавления SMTP-сервера в вашу установку SuiteCRM.

Share: X/Twitter LinkedIn

Get new posts in your inbox

No spam. Unsubscribe anytime.