Установка OTRS на Debian 11

Скриншот логотипа OTRS и интерфейса установки

OTRS — открытая система обработки обращений (ticket request system) для служб поддержки и ITSM. Приложение написано на Perl и поддерживает PostgreSQL и MySQL/MariaDB как бекенды. В этом руководстве показано, как установить OTRS Community Edition на сервер с Debian 11, настроить веб‑сервер и базу данных, пройти веб‑инсталлятор и устранить распространённые ошибки.

Что мы установим и зачем

OTRS Community Edition — веб‑базированная система трекинга тикетов. Коротко: помогает централизовать обращения пользователей и автоматизировать SLA.
Apache — веб‑сервер для доставки CGI/Perl‑скриптов OTRS.
MariaDB — реляционная СУБД для хранения данных OTRS.

Важно: это руководство предполагает базовые навыки работы в терминале и доступ к серверу под root или через sudo.

Требования перед началом

Сервер с Debian 11 (x86_64). Обновлённая система.
Доступ root или пользователь с sudo.
Открытые порты 80/443 (для веб‑интерфейса) и доступ по SSH.
Резервная копия данных при установке в продакшн окружении.

Важно: при развертывании в проде используйте HTTPS и отдельную БД с ограниченными правами.

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

Обновить систему.
Установить Perl и модули.
Установить Apache и MariaDB.
Защитить MariaDB и настроить параметры innodb/charset.
Скачать и распаковать OTRS в /opt/otrs.
Проверить модули Perl и установить права.
Подключить конфигурацию Apache и включить модули.
Пройти веб‑инсталлятор и запустить демон.

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

OTRS написан на Perl, поэтому сначала установите все необходимые Perl‑модули.

Обновите систему:

apt update -y  
apt upgrade -y

Установите пакеты и Perl‑модули:

apt install perl libapache2-mod-perl2 libdbd-mysql-perl libtimedate-perl libnet-dns-perl libnet-ldap-perl libio-socket-ssl-perl libpdf-api2-perl libdbd-mysql-perl libsoap-lite-perl libtext-csv-xs-perl libjson-xs-perl libapache-dbi-perl libxml-libxml-perl libxml-libxslt-perl libyaml-perl libarchive-zip-perl libcrypt-eksblowfish-perl libencode-hanextra-perl libmail-imapclient-perl libtemplate-perl libmoo-perl libauthen-ntlm-perl libjavascript-minifier-xs-perl libdbd-odbc-perl libcss-minifier-xs-perl libdbd-pg-perl libdatetime-perl -y

Примечание: список пакетов основан на типичных зависимостях OTRS. При необходимости дополните пакетами для вашей конфигурации (например, DBD::Oracle если нужна Oracle).

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

Установите веб‑сервер и СУБД:

apt install apache2 mariadb-server mariadb-client -y

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

systemctl start apache2 mariadb  
systemctl enable apache2 mariadb

Проверьте, что службы активны:

systemctl status apache2
systemctl status mariadb

Настройка MariaDB

Защитите установку MariaDB:

mysql_secure_installation

При запуске следуйте подсказкам. Для локальной установки можно отвечать, как в примере ниже (если уже установлена политика паролей, выбирайте безопасный вариант):

    Enter current password for root (enter for none):
    Set root password? [Y/n]: N
    Remove anonymous users? [Y/n]: Y
    Disallow root login remotely? [Y/n]: Y
    Remove test database and access to it? [Y/n]:  Y
    Reload privilege tables now? [Y/n]:  Y

Отредактируйте конфигурацию MariaDB для стабильной работы OTRS и InnoDB:

nano /etc/mysql/mariadb.conf.d/50-server.cnf

Добавьте в секцию [mysqld]:

max_allowed_packet=256M
character-set-server=utf8
collation-server=utf8_general_ci
innodb_buffer_pool_size=4G
innodb_log_file_size=1G

Сохраните файл и перезапустите MariaDB:

systemctl restart mariadb

Совет: подберите innodb_buffer_pool_size в зависимости от объёма ОЗУ на сервере (обычно 50–70% для выделенного СУБД). Здесь приведены безопасные примерные значения, не являющиеся универсальными рекомендациями.

Установка OTRS в /opt/otrs

Создайте системного пользователя для OTRS и добавьте его в группу веб‑сервера:

useradd -r -m -d /opt/otrs -c "OTRS User" otrs
usermod -aG www-data otrs

Скачайте архив OTRS (в примере — версия 6.0.38):

wget https://otrscommunityedition.com/download/otrs-community-edition-6.0.38.tar.gz

Распакуйте в целевую директорию и установите владельца:

tar xvfz otrs-community-edition-6.0.38.tar.gz -C /opt/otrs --strip-components=1
chown -R otrs:otrs /opt/otrs

Проверьте необходимые модули Perl (скрипт выдаст список «ok» или пометит отсутствующие опции):

perl /opt/otrs/bin/otrs.CheckModules.pl

Ожидаемый пример вывода (фрагмент):

  o Apache::DBI......................ok (v1.12)
  o Apache2::Reload..................ok (v0.13)
  o Archive::Tar.....................ok (v2.36)
  o Archive::Zip.....................ok (v1.68)
  o Crypt::Eksblowfish::Bcrypt.......ok (v0.009)
  o CSS::Minifier::XS................ok (v0.11)
  o Date::Format.....................ok (v2.24)
  o DateTime.........................ok (v1.54)
    o DateTime::TimeZone.............ok (v2.47)
  o DBI..............................ok (v1.643)
  o DBD::mysql.......................ok (v4.050)
  o DBD::ODBC........................ok (v1.61)
  o DBD::Oracle......................Not installed! (optional - Required to connect to a Oracle database.)
  o DBD::Pg..........................ok (v3.14.2)
  o Digest::SHA......................ok (v6.02)
  o Encode::HanExtra.................ok (v0.23)
  o IO::Socket::SSL..................ok (v2.069)
  o JSON::XS.........................ok (v4.03)
  o JavaScript::Minifier::XS.........ok (v0.13)
  o List::Util::XS...................ok (v1.55)
  o LWP::UserAgent...................ok (v6.64)
  o Mail::IMAPClient.................ok (v3.42)
    o IO::Socket::SSL................ok (v2.069)
    o Authen::SASL...................ok (v2.16)
    o Authen::NTLM...................ok (v1.09)
  o ModPerl::Util....................ok (v2.000011)
  o Moo..............................ok (v2.004004)
  o Net::DNS.........................ok (v1.29)
  o Net::LDAP........................ok (v0.68)
  o Net::SMTP........................ok (v3.11)
  o Template.........................ok (v2.27)
  o Template::Stash::XS..............ok (undef)
  o Text::CSV_XS.....................ok (v1.45)
  o Time::HiRes......................ok (v1.9764)
  o Unicode::Collate.................ok (v1.27)
  o XML::LibXML......................ok (v2.0134)
  o XML::LibXSLT.....................ok (v1.99)
  o XML::Parser......................ok (v2.46)
  o YAML::XS.........................ok (v0.82)

Создайте файл конфигурации на основе шаблона и проверьте CGI-скрипты:

cp /opt/otrs/Kernel/Config.pm{.dist,}
perl -cw /opt/otrs/bin/cgi-bin/index.pl  
perl -cw /opt/otrs/bin/cgi-bin/customer.pl  
perl -cw /opt/otrs/bin/otrs.Console.pl  
perl /opt/otrs/bin/otrs.SetPermissions.pl

Последняя команда установит рекомендуемые права для каталогов OTRS.

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

Свяжите конфигурацию OTRS с Apache и настройте модули:

ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/apache2/sites-enabled/

Отключите сайт по умолчанию и включите нужные модули:

a2dissite 000-default.conf
a2enmod perl version deflate filter headers

Установите права веб‑директории и группу:

/opt/otrs/bin/otrs.SetPermissions.pl --web-group=www-data

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

systemctl restart apache2

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

systemctl status apache2

Пример статуса показывает, что служба активна и работает.

Прохождение веб‑установщика OTRS

Откройте в браузере:

http://your-server-ip/otrs/installer.pl

Вы увидите приветственный экран инсталлятора:

Экран приветствия OTRS в веб‑инсталляторе

Нажмите Next и примите лицензию:

Экран лицензии OTRS

Выберите тип базы данных (MySQL/MariaDB или PostgreSQL):

Выбор базы данных в инсталляторе OTRS

Введите параметры доступа к БД (корень или созданный ранее пользователь), затем проверьте настройки:

Проверка настроек MySQL в инсталляторе

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

Создание учётной записи в OTRS

Настройте системные параметры и почту (SMTP) или пропустите шага для настройки позже:

Настройка системных параметров OTRS

Настройка SMTP в инсталляторе OTRS

После завершения инсталляции откроется URL с учётными данными для входа:

Информация о завершении установки и URL для входа

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

Экран логина OTRS

После входа вы увидите дашборд OTRS:

Главная панель OTRS после входа

Если вы увидите сообщение о том, что демон OTRS не запущен, выполните следующие команды для запуска демона и cron:

sudo -Hiu otrs /opt/otrs/bin/otrs.Daemon.pl start  
cp /opt/otrs/var/cron/otrs_daemon{.dist,}  
sudo -Hiu otrs /opt/otrs/bin/Cron.sh start

После запуска демона обновите страницу дашборда — сообщение должно исчезнуть.

Панель OTRS без ошибок демона

Частые проблемы и их устранение

Демон OTRS не запущен — запустите otrs.Daemon.pl под пользователем otrs (см. команды выше). Убедитесь, что переменная PERL5LIB корректна при запуске из systemd/cron.
Ошибки прав — выполните otrs.SetPermissions.pl и убедитесь, что веб‑группа (www‑data) установлена.
Ошибки подключения к БД — проверьте пользователя БД, хост, пароль и привилегии. Создавайте отдельную БД и пользователя с набором привилегий CREATE/INSERT/UPDATE/DELETE/SELECT/INDEX.
Отсутствующие Perl‑модули — проверьте вывод otrs.CheckModules.pl, установите недостающие пакеты через apt или CPAN.
SSL/HTTPS — для продакшн окружения обязательно настроьте HTTPS (Let’s Encrypt/Certbot) и перенаправление 80 → 443.

Совет: для диагностики просматривайте логи Apache (/var/log/apache2/) и OTRS (/opt/otrs/var/log/).

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

Настройте HTTPS с помощью certbot и автоматического обновления сертификатов.
Не используйте root для ежедневной работы с OTRS; создайте ограниченного пользователя БД.
Применяйте firewall (ufw/iptables) и ограничьте доступ к SSH.
Включите регулярные бэкапы каталогов /opt/otrs и дампов БД.
Настройте fail2ban для защиты от перебора паролей.
Минимизируйте доступ к административным URL по IP или VPN.

Производительность и параметры MariaDB

innodb_buffer_pool_size — адаптируйте под ОЗУ. Для выделенного СУБД ставьте ~50–70% памяти.
innodb_log_file_size — увеличьте при интенсивной записи, чтобы уменьшить частоту checkpoint.
max_allowed_packet — увеличьте при необходимости для больших вложений.

Мониторьте потребление ресурсов и настройте параметры постепенно.

Альтернативные подходы и миграция

Docker/Kubernetes: есть образы и Helm‑чарты для контейнеризации OTRS. Контейнеры упрощают обновление, но потребуют настройки постоянного хранилища и сетевых правил.
Znuny: поддерживаемый форк OTRS Community, совместим с большинством настроек, стоит рассмотреть для долгосрочной поддержки и обновлений.
Пакеты Debian vs ручная установка: пакеты облегчают управление зависимостями и автозапуском, ручная установка даёт больше контроля за путями и версиями.

Чек‑листы по ролям

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

Обновить систему и установить пакеты.
Настроить MariaDB и оптимизировать innodb.
Настроить HTTPS и firewall.
Настроить резервное копирование и мониторинг.

OTRS‑администратор (бизнес/операции):

Пройти веб‑инсталлятор и настроить почтовые ящики.
Создать очереди, роли и SLA.
Настроить шаблоны уведомлений и права доступа.

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

Пройти обучение интерфейсу OTRS.
Настроить фильтры и подписки на очереди.
Тестировать сценарии обработки тикетов.

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

Веб‑инсталлятор OTRS завершён без ошибок.
Демон OTRS и Cron запущены, сообщения об ошибках отсутствуют.
Агент может создать тикет и получить уведомление по почте (если SMTP настроен).
Бэкап и восстановление отработаны на тестовых данных.

Короткая методология установки (SOP)

Подготовка: обновление, резервные копии.
Инсталляция зависимостей и сервера БД.
Настройка параметров MariaDB.
Установка OTRS в /opt/otrs и проверка модулей.
Настройка Apache и прав файлов.
Веб‑инсталлятор и тестирование функциональности.
Включение HTTPS и настройка мониторинга.

Факты и числа

Поддерживаемые СУБД: MariaDB/MySQL и PostgreSQL.
Рекомендуемый веб‑сервер: Apache с mod_perl для оптимальной работы CGI.
Размещение OTRS: обычно в /opt/otrs (системный пользователь otrs).

Однострочный словарь

OTRS — система трекинга обращений для службы поддержки.
CGI — интерфейс запуска скриптов через веб‑сервер.
InnoDB — движок хранения для MySQL/MariaDB с транзакциями.

Когда этот подход не подходит

Если нужна лёгкая облачная SaaS‑альтернатива, рассмотрите коммерческие облачные сервисы для helpdesk.
Для критически важного бизнеса с SLA 24/7 рекомендована коммерческая поддержка или форк с долгосрочной поддержкой (например, Znuny/OTRS Business).

Резервные варианты настроек

Контейнеризация: Docker образ может ускорить развертывание, но требует настройки персистентного хранения и сетей.
Использование PostgreSQL вместо MariaDB: PostgreSQL полностью поддерживается OTRS и имеет свои преимущества при масштабировании.

Заключение

Вы успешно установили OTRS на Debian 11 и прошли базовую настройку веб‑интерфейса и базы данных. Дальше рекомендую:

Настроить HTTPS и резервное копирование.
Подготовить сценарии приёма и тесты (создание тикета → уведомление → закрытие).
Планировать регулярное обновление зависимостей и проверку безопасности.

Если нужны дополнительные инструкции по миграции данных, контейнеризации или настройке высокодоступного кластера БД — напишите, укажу пошагово.

Важно: не забывайте тестировать изменения в тестовой среде перед продакшн‑апдейтом.