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

Диагностика и поддержка YouGile Docker

Запуск контейнеров​

Проверьте, не заняты ли используемые порты:

ss -tlnp | grep ':80\|:443'

Проверьте и исправьте права доступа к директориям проекта:

sudo chown -R $USER:$USER ./yougile ./nginx ./certbot
chmod -R 755 ./yougile ./nginx ./certbot

Если YouGile не запускается, проверьте логи контейнера:

docker compose logs --tail 100 yougile

Проверьте лог ошибок приложения (внутри контейнера):

docker compose exec yougile cat /opt/yougile/logs/error.log

Запуск контейнера с выводом в консоль и статус health check:

docker compose up yougile
docker compose ps

Примечание: nginx запускается только после того, как yougile пройдёт health check (condition: service_healthy). Если nginx не стартует — сначала убедитесь, что статус yougile healthy в выводе docker compose ps.

Диагностические команды​

Проверьте конфигурацию Nginx внутри контейнера:

docker compose exec nginx nginx -t

Перезагрузка Nginx без перезапуска:

docker compose exec nginx nginx -s reload

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

docker compose exec nginx curl -v http://yougile:8001

Восстановление после сбоя​

Выполните полную пересборку контейнеров без использования кэша:

docker compose down
docker compose build --no-cache
docker compose up -d

Повторно выполните инициализацию:

./yougile-container install

Изменение портов​

По умолчанию используются порты 80 (HTTP) и 443 (HTTPS).

Для изменения портов создайте или отредактируйте файл .env:

NGINX_HTTP_PORT=8080
NGINX_HTTPS_PORT=8443

Затем пересоздайте конфигурацию и перезапустите:

./yougile-container install --regen

Если nginx отключён (NGINX_ENABLED=false), YouGile работает напрямую на порту 8001.

Резервное копирование​

Смотрите раздел Управление проектом.

Сбор диагностики​

echo "=== Docker ===" > debug.txt
docker --version >> debug.txt
docker compose version >> debug.txt
echo "=== Контейнеры ===" >> debug.txt
docker compose ps >> debug.txt
echo "=== Логи ===" >> debug.txt
docker compose logs --tail 200 >> debug.txt

tar -czf support-$(date +%Y%m%d-%H%M%S).tar.gz debug.txt \
  ./nginx/logs ./yougile/conf.json ./nginx/nginx.conf docker-compose.yml

Поддержка​

  1. Проверьте логи: ./yougile/logs/ и ./nginx/logs/
  2. Соберите диагностику командой выше
  3. Напишите на inf@yougile.com с прикреплённым архивом