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

Устранение неисправностей

Типичные проблемы при запуске​

Порты уже заняты​

Симптом: ошибка Bind for 0.0.0.0:8081 failed: port is already allocated

Решение:

# Проверьте, какой процесс занимает порт
lsof -i :8081

# Остановите конфликтующий процесс или измените порт в .env

Недостаточно памяти Docker​

Симптом: контейнеры завершаются с ошибкой OOM Killed

Решение:

  • Убедитесь, что Docker выделено не менее 16 ГБ RAM
  • На Windows/macOS: откройте настройки Docker Desktop → Resources → увеличьте лимит памяти

Контейнеры не запускаются​

Симптом: docker compose up завершается с ошибкой

Решение:

# Проверьте версии Docker
docker --version        # Требуется 20.10.0+
docker compose version  # Требуется 2.22.0+

# Просмотрите логи конкретного сервиса
docker compose logs <имя-сервиса>

# Пересоберите с нуля
docker compose down -v
docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build -d

WSL2 не настроен (Windows)​

Симптом: Docker Desktop не запускается на Windows

Решение:

  1. Откройте PowerShell от имени администратора
  2. Выполните: wsl --install
  3. Перезагрузите компьютер
  4. Запустите Docker Desktop

Проверка состояния системы​

Для проверки статуса всех контейнеров:

docker compose ps

Для просмотра логов в реальном времени:

docker compose logs -f

Полный сброс​

Если система работает некорректно, выполните полный сброс:

# Остановите все контейнеры
docker compose down -v

# Удалите кэш сборки
docker system prune -f

# Запустите заново
docker compose -f docker-compose.yml -f docker-compose.dev.yml up --build -d
предупреждение

Команда docker compose down -v удалит все данные, хранящиеся в томах Docker (базы данных, файлы MinIO). Используйте с осторожностью.

Обращение в поддержку​

Если проблему не удалось решить самостоятельно, обратитесь в техническую поддержку.