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

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

Решение проблем с Podman​

Проверьте, что пользовательский сокет Podman запущен:

systemctl --user status podman.socket

Настройте переменную окружения DOCKER_HOST для rootless Podman:

export DOCKER_HOST=unix:///run/user/$(id -u)/podman/podman.sock

Проверьте текущее значение DOCKER_HOST:

echo $DOCKER_HOST

Проверьте работу Podman напрямую, без compose:

podman ps
podman logs yougile

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

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

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

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

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

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

podman logs yougile

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

podman exec yougile cat /opt/yougile/logs/error.log

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

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

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

podman exec nginx nginx -t

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

podman exec nginx nginx -s reload

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

podman exec nginx curl -v http://yougile:8001

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

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

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

Повторная инициализация YouGile:

./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 "=== Podman ===" > debug.txt
podman --version >> debug.txt
podman-compose --version >> debug.txt
echo "=== Контейнеры ===" >> debug.txt
podman ps -a >> debug.txt
echo "=== Логи ===" >> debug.txt
podman logs --tail 200 yougile >> debug.txt
podman logs --tail 200 nginx >> 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 с прикреплённым архивом