Перейти к основному содержимому

Установка YouGile Docker

В данном разделе описана установка и эксплуатация YouGile с использованием Docker и Docker Compose.

В процессе установки разворачивается следующая инфраструктура:

  • контейнер YouGile
  • контейнер Nginx
  • контейнер Certbot (для HTTPS)
  • volumes для хранения данных и конфигурации

Системные требования​

Обязательные компоненты:

  • Docker (версия 20.10+) + Docker Compose (версия 2.0+)

Ресурсы сервера:

  • Минимум 2GB RAM (рекомендуется 4GB)
  • Минимум 5GB свободного места на диске
  • Порты 8080 и 8443 должны быть свободны

Для SSL (опционально):

  • Доменное имя, указывающее на ваш сервер
  • Доступ к DNS записям домена

Поддерживаемые операционные системы:

  • Linux (Ubuntu, Debian, CentOS, RHEL, Fedora, NixOS и др.)
  • macOS (x86_64)
  • Windows (с WSL2)

Установка​

Шаг 1: Скачайте установщик​

Скачайте исполняемый файл для вашей операционной системы:

Linux:

wget https://dist.yougile.com/docker/yougile-docker.zip
chmod +x yougile-docker

macOS:

curl -L https://dist.yougile.com/docker/yougile-docker.zip
chmod +x yougile-docker

Windows (в WSL2):

curl -L https://dist.yougile.com/docker/yougile-docker.zip
chmod +x yougile-docker

Шаг 2: Запустите установку​

./yougile-docker

Инструмент автоматически:

  • Определит доступный container runtime (Docker или Podman)
  • Создаст структуру каталогов
  • Сгенерирует конфигурационные файлы
  • Создаст Docker файлы
  • Запустит контейнеры

Шаг 3: Доступ к YouGile​

После успешной установки откройте браузер:

http://localhost:8080

Для HTTPS (после настройки SSL):

https://localhost:8443

Шаг 4: Первоначальная настройка​

  1. Отредактируйте ./yougile/conf.json - укажите ваш домен и SMTP настройки

  2. Перезапустите контейнеры:

    docker compose restart

  3. При необходимости настройте SSL сертификат

Важно: Если вы повторно запустите ./yougile-docker, произойдет следующее:

Будут сохранены (НЕ перезапишутся):

  • Все данные в Docker volumes (база данных, пользовательские файлы)
  • Конфигурационные файлы: ./yougile/conf.json, ./nginx/nginx.conf, ./yougile/license.key
  • SSL сертификаты в ./certbot/conf/
  • Логи в ./yougile/logs/ и ./nginx/logs/

Будут пересозданы:

  • Docker файлы: Dockerfile, docker-compose.yml, .dockerignore
  • Структура каталогов (если была удалена)

Это означает, что вы можете безопасно перезапустить установщик для обновления Docker конфигурации без потери ваших данных и настроек.

Принудительный выбор runtime​

Если нужно явно указать runtime:

CONTAINER_RUNTIME=docker ./yougile-docker

Структура проекта​

После выполнения установщика будет создана следующая структура:

yougile-docker/
├── yougile-docker         # Исполняемый файл установщика
├── Dockerfile             # Docker образ для YouGile
├── docker-compose.yml     # Оркестрация контейнеров
├── .dockerignore          # Исключения для Docker
├── yougile/               # Данные YouGile
│   ├── conf.json          # Конфигурация YouGile
│   ├── license.key        # Лицензионный ключ
│   └── logs/              # Логи приложения (bind mount)
│       ├── error.log      # Логи ошибок
│       └── info.log       # Информационные логи
├── nginx/                 # Конфигурация Nginx
│   ├── nginx.conf         # Основная конфигурация
│   ├── conf.d/            # Дополнительные конфигурации
│   └── logs/              # Логи Nginx
└── certbot/               # SSL сертификаты
    ├── www/               # ACME challenge
    ├── conf/              # Конфигурация и сертификаты
    └── README.md          # Инструкции по SSL

Docker volumes:

  • yougile_database - база данных
  • yougile_userdata - пользовательские файлы
  • yougile_extensions - расширения

Дополнительные ресурсы​