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

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

Для корректной работы приложения требуются следующие параметры и компоненты:

• Операционная система: Ubuntu или Debian.

• Права доступа: Права суперпользователя (root) для установки системных пакетов и управления Docker.

• Порты:

• 443 (HTTPS) — внешний доступ к приложению.

• 80 (HTTP) — для настройки перенаправления на HTTPS.

• 8080 — внутренний порт приложения.

FDQN итоговой панели на домене hostkey.in¶

Для доступа к интерфейсу Zammad используется следующий шаблон доменного имени:

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

Развертывание Zammad выполняется в несколько этапов:

1. Подготовка системы:

2. Обновление списков пакетов.

3. Установка необходимых системных зависимостей (ca-certificates, curl, git).

4. Установка среды выполнения:

5. Добавление официального репозитория Docker и его GPG-ключа.

6. Установка компонентов docker-ce и docker-compose-plugin.

7. Настройка и запуск службы Docker.

8. Развертывание приложения:

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

10. Запуск контейнеров с помощью команды docker compose up -d.

11. Настройка веб-сервера и SSL:

12. Установка Nginx и Certbot.

13. Создание конфигурационного файла Nginx для проксирования трафика на внутренний порт приложения (8080).

14. Получение SSL-сертификатов через Certbot с автоматическим перенаправлением с HTTP на HTTPS.

Контейнеры Docker и их запуск¶

Приложение работает в среде Docker Compose. Все сервисы запускаются из директории /root/zammad-docker-compose.

Приложение настроено на работу через прокси с поддержкой WebSocket (Upgrade: $http_upgrade).

Кастомные скрипты и дополнительные настройки¶

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

• Настройка переменных среды: В файл .env в директории /root/zammad-docker-compose добавляются параметры для обеспечения работы через HTTPS:

• NGINX_SERVER_SCHEME=https

• ZAMMAD_HTTP_TYPE=https

• RAILS_TRUSTED_PROXIES=127.0.0.1/32

• Перезапуск сервисов: После внесения изменений в конфигурацию окружения выполняется перезапуск контейнеров командой docker compose down && docker compose up -d.

Инструкция по обновлению приложения¶

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

1. Перейти в рабочую директорию проекта: cd /root/zammad-docker-compose

2. Подтянуть актуальные образы и перезапустить контейнеры:

   docker compose pull && docker compose up -d
   

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

• Рабочая директория приложения: /root/zammad-docker-compose

• Конфигурация Nginx: /etc/nginx/sites-available/zammad (активна через симлинк в sites-enabled)

• SSL сертификаты: /etc/letsencrypt/live/{ваш_домен}/

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