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

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

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

Операционная система: Ubuntu.
Доступ: Права суперпользователя (root) для управления Docker и системными директориями.
Сетевые настройки: Открытые порты 80 и 443 для работы веб-сервера и получения SSL-сертификатов.

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

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

Параметр	Значение
Префикс	`postiz`
Домен	`hostkey.in`
Полный шаблон	`postiz{Server_ID_from_Invapi}.hostkey.in`

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

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

/opt/postiz — рабочая директория приложения (содержит файлы из репозитория postiz-docker-compose).
/root/nginx — директория с конфигурационным файлом compose.yml для прокси-сервера.
/data/nginx/user_conf.d — директория с пользовательскими конфигурациями Nginx.
/data/nginx/nginx-certbot.env — файл с переменными окружения для Certbot.

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

Развертывание выполняется путем клонирования репозитория https://github.com/gitroomhq/postiz-docker-compose.git в директорию /opt/postiz. В процессе установки происходит автоматическая подстановка доменного имени во внутренние переменные конфигурации:

MAIN_URL
FRONTEND_URL
NEXT_PUBLIC_BACKEND_URL

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

Приложение развертывается с использованием двух основных компонентов в контейнерах.

Nginx Certbot (Прокси-сервер)¶

Контейнер отвечает за обработку HTTPS-трафика и автоматическое получение SSL-сертификатов.

Имя образа: jonasal/nginx-certbot:latest
Порты: Используется режим сети host.
Тома (volumes):
nginx_secrets:/etc/letsencrypt — хранение сертификатов.
/data/nginx/user_conf.d:/etc/nginx/user_conf.d — конфигурационные файлы проксирования.
Переменные окружения: CERTBOT_EMAIL=hkadm@hostkey.com.
Политика перезапуска: unless-stopped.

Postiz (Приложение)¶

Основной контейнер приложения, запускаемый через Docker Compose.

Имя контейнера: postiz{Server_ID_from_Invapi}.hostkey.in
Режим работы: Запускается в составе проекта из /opt/postiz.

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

Обновление выполняется путем подтягивания актуальных образов и перезапуска контейнеров:

cd /opt/postiz && docker compose pull && docker compose up -d

Также для обновления прокси-сервера используется команда:

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

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

Тип данных	Путь к файлу / директории
Конфигурация Docker Compose приложения	`/opt/postiz/docker-compose.yaml`
Конфигурация прокси-сервера	`/root/nginx/compose.yml`
Сертификаты SSL	`nginx_secrets` (внутри контейнера)

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

443 (HTTPS): Основной порт для доступа к интерфейсу приложения через доменное имя.
80 (HTTP): Используется для перенаправления на HTTPS и получения сертификатов.