Обзор развертывания Zammad на сервере¶

Предварительные условия и базовые требования¶

Для обеспечения успешного развертывания и работы Zammad должны быть соблюдены следующие системные требования:

• Операционная система: Ubuntu (в связи с использованием пакетного менеджера apt).

• Привилегии: Требуется доступ root или sudo для установки пакетов и управления сервисами Docker.

• Конфигурация домена: Необходим действующий доменное имя в зоне hostkey.in.

• Необходимые пакеты:

  • ca-certificates

  • curl

  • git

FQDN финальной панели в домене hostkey.in¶

Приложение доступно по полному доменному имени (FQDN) по следующему шаблону: <prefix><Server ID>.hostkey.in

Где <prefix> установлен как zammad.

Структура файлов и директорий¶

Для конфигурации, исходного кода и SSL-сертификатов используются несколько ключевых директорий:

Процесс установки приложения¶

Приложение развертывается с использованием контейнеризированного подхода через Docker Compose v2. Развертывание включает следующие этапы:

1. Установка Docker Engine и плагина Docker Compose.

2. Клонирование репозитория zammad-docker-compose в директорию /root/zammad-docker-compose.

3. Настройка переменных окружения в файле .env для поддержки HTTPS и доверенных прокси (trusted proxies).

4. Оркестрация сервисов с помощью команды docker compose up -d.

Права доступа и безопасность¶

Безопасность обеспечивается за счет сочетания обратного проксирования (reverse proxying) через Nginx и SSL-шифрования:

• Межсетевой экран/Прокси: Nginx выступает в роли reverse proxy, перенаправляя трафик с внешнего порта на внутренний контейнер приложения.

• SSL/TLS: Certbot используется для получения и управления SSL-сертификатами Let's Encrypt. Включено автоматическое перенаправление (redirection) с HTTP на HTTPS.

• Доверенные прокси (Trusted Proxies): Приложение настроено на доверие 127.0.0.1/32 для заголовков проксирования.

Docker-контейнеры и их развертывание¶

Развертывание опирается на Docker Compose для управления стеком Zammad. Для инициализации контейнеров используется следующая команда:

cd /root/zammad-docker-compose && docker compose up -d

Прокси-серверы¶

Nginx настроен как reverse proxy для обработки входящего веб-трафика и терминации (termination) SSL-соединений.

Расположение конфигурационных файлов и данных¶

Следующие файлы определяют поведение прокси и окружения приложения:

• Конфигурация Nginx: /etc/nginx/sites-available/zammad

• Переменные окружения Docker: /root/zammad-docker-compose/.env

Доступные порты для подключения¶

Запуск, остановка и обновление¶

Управление сервисами осуществляется через Docker Compose в директории приложения.

• Запуск/Перезапуск сервисов:

  cd /root/zammad-docker-compose && docker compose up -d
  

• Остановка/Пересоздание контейнеров:

  cd /root/zammad-docker-compose && docker compose down && docker compose up -d