Установка UVdesk на Debian 11 с Apache

Кратко: в этой пошаговой инструкции показано, как установить UVdesk (open-source helpdesk на Symfony/PHP) на сервер Debian 11 с Apache, MariaDB и PHP-FPM. Мы покрываем установку пакетов, создание базы данных, загрузку через Composer, настройку виртуального хоста Apache и базовую проверку работоспособности. В блоках дополнительно приведены рекомендации по безопасности, альтернативные подходы и контрольные списки для ролей.

Введение

UVdesk логотип и интерфейс

UVdesk — бесплатное, open-source и SaaS-совместимое решение для службы поддержки, написанное на PHP и основанное на Symfony. Его можно интегрировать с маркетплейсами (Amazon, eBay, Etsy, Flipkart) и использовать как гибкую альтернативу другим платформам поддержки.

В этой статье показано, как установить UVdesk на Debian 11 с веб-сервером Apache. Инструкции подразумевают, что у вас есть root-доступ к серверу и домен, указывающий на IP сервера.

Требования

Сервер с Debian 11.
Действующий домен, указывающий на IP сервера.
Установленный root-пароль или доступ через sudo.

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

Установка Apache, MariaDB и PHP

Установите Apache, MariaDB, PHP и необходимые расширения. Выполните под root или через sudo:

apt-get update
apt-get install apache2 libapache2-mod-fcgid mariadb-server php php-cli php-fpm php-json php-common php-mysql php-zip php-gd php-mbstring php-curl php-xml php-bcmath php-imap php-intl php-mailparse php-pear curl -y

После установки откройте конфигурационный файл PHP-FPM (версия PHP в Debian 11 может отличаться; в примере используется 7.4). Если у вас другая версия — замените путь соответствующе.

nano /etc/php/7.4/fpm/php.ini

Измените и/или добавьте строки:

memory_limit = 512M
; Установите часовой пояс, подходящий для вашей организации
date.timezone = Europe/Moscow

Сохраните и перезапустите сервис PHP-FPM:

systemctl restart php7.4-fpm

Включите необходимые модули Apache:

a2enmod actions fcgid alias proxy_fcgi rewrite

Перезапустите Apache:

systemctl restart apache2

Проверка статуса:

systemctl status apache2

Если сервис в состоянии active (running), можно продолжать.

Создание базы данных для UVdesk

Войдите в MariaDB:

mysql

Создайте базу данных и пользователя (замените пароль на надёжный):

MariaDB [(none)]> CREATE DATABASE uvdesk;
MariaDB [(none)]> CREATE USER 'uvdesk'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> GRANT ALL PRIVILEGES ON uvdesk.* TO 'uvdesk'@'localhost';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;

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

Установка Composer и UVdesk

Установите Composer глобально и проверьте версию:

curl -sS https://getcomposer.org/installer -o composer-setup.php
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
composer -V

Скачайте UVdesk в веб-корень Apache:

cd /var/www/html
composer create-project uvdesk/community-skeleton uvdesk

В процессе установки могут выводиться подсказки о конфигурации (ReCaptcha, тестах и т.п.). По завершении задайте права:

chown -R www-data:www-data /var/www/html/uvdesk
chmod -R 775 /var/www/html/uvdesk

Эти команды позволяют Apache (www-data) читать и записывать необходимые файлы.

Создание виртуального хоста Apache для UVdesk

Создайте файл конфигурации:

nano /etc/apache2/sites-available/uvdesk.conf

Вставьте конфигурацию, заменив ServerName на ваш домен:


    ServerName uvdesk.example.com
    DocumentRoot /var/www/html/uvdesk/public

    
        Options -Indexes +FollowSymLinks +MultiViews
        AllowOverride All
        Require all granted
    

    
        # 2.4.10+ can proxy to unix socket
        SetHandler "proxy:unix:/var/run/php/php7.4-fpm.sock|fcgi://localhost"
    

    ErrorLog /var/log/apache2/uvdesk-error.log
    CustomLog /var/log/apache2/uvdesk-access.log combined

Сохраните файл, активируйте сайт и модули:

a2ensite uvdesk
a2enmod rewrite
systemctl restart apache2

Проверьте доступность: откройте в браузере http://uvdesk.example.com (замените домен).

Дальнейшая установка через веб-инсталлятор

Перейдите по адресу вашего хоста. Вы увидите шаги установщика UVdesk: проверка требований, ввод данных базы данных, создание администратора, конфигурация сайта и установка компонентов.

UVdesk установщик

Последовательность основных экранов инсталлятора:

Нажмите «Let’s Begin» и дождитесь проверки системных требований.

Требования системы

Введите параметры подключения к базе данных и подтвердите.

Конфигурация базы данных

Создайте учётную запись администратора для панели управления.

Учётная запись администратора

Настройте параметры сайта (панели для клиентов и агентов).

Конфигурация сайта

Нажмите «INSTALL NOW» и дождитесь завершения установки.

Установка завершена

После установки войдите в административную панель через ссылку «Admin Panel».

Вход администратора

В панели введите адрес электронной почты и пароль администратора, затем нажмите «SIGN IN». После входа вы увидите панель управления UVdesk.

Панель UVdesk

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

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

Когда рассматривать альтернативы: если планируется масштабирование, высокая нагрузка или частые деплои, Docker/Kubernetes даст больше контроля.

Когда установка может не сработать

Неправильный путь к сокету php-fpm (проверьте /var/run/php/*.sock).
Несовместимые версии PHP или отсутствующие расширения. UVdesk требует определённые расширения — проверяйте их наличие.
Проблемы с правами файловой системы (ошибки записи). Проверьте owner/group и режимы доступа.
Ошибки в конфигурации виртуального хоста или конфликтующие правила .htaccess.

Контрольные списки по ролям

Системный администратор

Установить и обновить пакеты ОС.
Настроить брандмауэр (ufw/iptables) и открыть порты 80/443.
Настроить SSL и автоматическую выдачу сертификатов.
Настроить резервное копирование и мониторинг.

Разработчик / DevOps

Настроить окружения (dev/staging/prod).
Настроить CI/CD для обновлений и миграций базы данных.
Обеспечить тестирование обновлений Composer на стейджинге.

Администратор службы поддержки

Создать учётные записи агентов.
Настроить категории, шаблоны писем и интеграции с почтой.
Проверить перенаправление почты (inbound) в тикетную систему.

Краткий глоссарий (1 строка)

PHP-FPM: процессный менеджер для PHP, рекомендуемый для производительных конфигураций с Apache/Nginx.
Composer: менеджер зависимостей PHP.
VirtualHost: конфигурация Apache для отдельного домена/сайта.

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

Веб-интерфейс UVdesk доступен по HTTPS и открывается страница логина.
Вход администратора успешен и панель загружается без ошибок.
Создание и вход в тестовый тикет проходят успешно.
Автоматические задания (cron, если применимо) выполняются или настроены.

Быстрые тесты и приёмочные проверки

curl -I https://uvdesk.example.com — проверка сертификата и кода ответа.
tail -f /var/log/apache2/uvdesk-error.log — проверка ошибок сервера.
php -v и composer -V — проверка версий.

Итог

Поздравляю — если вы прошли все шаги, UVdesk установлен и доступен на Debian 11 под управлением Apache и PHP-FPM. Дальше рекомендуется:

Перевести сайт на HTTPS и настроить резервное копирование.
Тестировать сценарии входа и отправки писем.
При необходимости рассмотреть контейнеризацию для упрощения деплоя и масштабирования.

Важно

Замените примеры паролей реальными надёжными значениями.
Протестируйте обновления в тестовой среде, прежде чем применять в продакшне.

Если нужны команды для настройки Let’s Encrypt, Docker-конфигурация или шаблон задач резервного копирования — напишите, и я подготовлю соответствующие инструкции.