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

Введение

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

В этом руководстве показано, как установить UVdesk на Debian 11 с веб-сервером Apache. Шаги ориентированы на минимальную рабочую установку, подходящую для тестовой и небольшой продакшен-среды. Для крупного продакшена дополнительно рассмотрите кластеризацию, резервное копирование и мониторинг.

Требования

Сервер под управлением Debian 11.
Доменное имя, указывающее на IP сервера (например uvdesk.example.com).
Настроенный root или пользователь с sudo.
Рекомендуется тестировать сначала в отдельной среде.

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

Установите Apache, MariaDB, PHP и необходимые расширения одной командой:

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 7.4. Задайте свой часовой пояс (пример: Europe/Moscow).

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

Примечание: при других версиях PHP путь к php.ini может отличаться (/etc/php/<версия>/fpm/php.ini).

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

Войдите в консоль MariaDB:

mysql

Внутри MariaDB создайте базу и пользователя. Замените “strong_password” на надёжный пароль.

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

Важно: используйте отдельного пользователя БД для приложения. Храните пароль в защищённом менеджере секретов.

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

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

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

Проверьте версию Composer:

composer -V

Перейдите в корень веб-сервера и создайте проект UVdesk:

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 для 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

Активируйте сайт и модули, затем перезапустите Apache:

a2ensite uvdesk
a2enmod rewrite
systemctl restart apache2

Проверить статус службы Apache:

systemctl status apache2

Доступ к веб-интерфейсу UVdesk

Откройте в браузере URL вашего домена, например http://uvdesk.example.com. Должна отобразиться страница инсталлятора.

Стартовый экран установщика UVdesk

Нажмите кнопку Let’s Begin. Следуйте шагам: проверка системных требований, ввод данных БД, создание администратора и конфигурация сайта. Примеры экранов ниже.

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

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

Создание администратора UVdesk

Настройка сайта UVdesk

Установка приложения UVdesk

По завершении вы попадёте в админ-панель и увидите страницу входа.

Экран завершения установки UVdesk

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

Панель управления UVdesk

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

Убедитесь, что все требования на странице инсталлятора отмечены зелёным.
Проверьте логи Apache: /var/log/apache2/uvdesk-error.log
Проверьте права доступа на папки (storage, var, public/uploads) — веб-сервер должен иметь запись.

Безопасность и жёсткая настройка

Настройте HTTPS: установите Certbot и получите сертификат для домена, затем настроьте перенаправление 80 → 443.
Отключите root-login по SSH и используйте ключи SSH.
Регулярно обновляйте систему и PHP-пакеты.
Ограничьте доступ к административной панели по IP, если возможно.
Настройте регулярное резервное копирование базы данных и файлов (cron + offsite хранение).

Пример быстрой установки Certbot (Debian):

apt-get install certbot python3-certbot-apache -y
certbot --apache -d uvdesk.example.com

(Команды зависят от конфигурации системы; проверьте документацию Certbot.)

Отладка: распространённые проблемы и решения

Недостаточно прав на файлы — проверьте chown и chmod.
Неправильный сокет PHP-FPM — убедитесь, что путь в SetHandler совпадает с реальным сокетом (/var/run/php/php7.4-fpm.sock).
Ошибка подключения к БД — проверьте имя пользователя, пароль и хост в конфиге инсталлятора.
Проблемы с ReCaptcha — временно отключите проверку при установке или настройте ключи Google ReCaptcha.

Когда UVdesk может не подойти

Очень крупные колл-центры с тысячами одновременных сессий могут требовать более масштабируемых коммерческих решений.
Если нужен встроенный специализированный CRM с глубокой ERP-интеграцией, возможна доработка или набор дополнительных модулей.

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

Запуск UVdesk под Nginx + PHP-FPM вместо Apache для более лёгкой конфигурации проксирования сокета.
Использование Docker-контейнеров для изоляции окружения и упрощённого деплоя.
Переход на облачные managed БД для отказоустойчивости.

Мини-методология развёртывания (быстрый чек-лист)

Подготовка инстанса: обновление и базовые пакеты.
Установка LAMP/LEMP стека и зависимостей.
Создание БД и пользователя.
Установка Composer и загрузка проекта.
Настройка веб-сервера и прав файлов.
Настройка HTTPS и бекапов.
Тестирование и приемка.

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

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

Установка пакетов и обновлений.
Настройка системных резервных копий.

DevOps-инженер:

Настройка виртуального хоста, SSL, мониторинга.
Настройка CI/CD для обновлений (если нужно).

Администратор UVdesk / Суперпользователь:

Настройка шаблонов писем, категорий и агентов.
Проверка интеграций с маркетплейсами.

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

Вход в админ-панель доступен по HTTPS.
Создание тикета от клиента проходит без ошибок.
Уведомления (email) отправляются корректно.
Резервное копирование базы данных выполняется по расписанию.

Тестовые сценарии

Создать новый тикет как анонимный пользователь и проверить, что он виден в админке.
Создать пользователя-агента, назначить тикет и проверить получение уведомления.
Импортировать тестовый файл вложения и проверить доступность файла.

Откат и план действий при инциденте

Если обновление сломало сайт — переключите DNS или прокси на предыдущий инстанс/резервную копию.
Восстановите базу данных из последней работающей резервной копии на тестовом окружении.
Проанализируйте логи и исправьте ошибку в тестовой среде перед повторной публикацией.

Краткое объявление (для рассылки, 100–200 слов)

Мы завершили руководство по быстрой установке UVdesk на Debian 11 с Apache. UVdesk — гибкая система поддержки на PHP/Symfony, подходящая для интернет-магазинов и сервисов. В инструкции описаны все шаги: установка Apache/MariaDB/PHP, создание базы данных, установка через Composer, настройка виртуального хоста и рекомендации по безопасности (HTTPS, резервное копирование). Руководство сопровождается чек-листами для ролей (администратор, DevOps, админ UVdesk), критериями приёмки и тестовыми сценариями. Следуя этому гайду, вы быстро развернёте рабочую систему поддержки и получите основу для масштабирования и интеграции с маркетплейсами.

Глоссарий

UVdesk — open-source helpdesk на PHP.
Symfony — PHP-фреймворк, на котором основан UVdesk.
Composer — менеджер зависимостей PHP.

Заключение

Поздравляем — вы установили UVdesk на Debian 11. Для продакшена обязательно настройте HTTPS, бекапы, мониторинг и план обновлений. Если нужны настройки интеграции с маркетплейсами или помощь с миграцией — задавайте вопросы.

Важно: используйте защищённые пароли и храните конфигурацию в контролируемом доступе.