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

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

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

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

Симптом: ошибка вида Bind for 0.0.0.0:<порт> failed: port is already allocated или listen tcp 127.0.0.1:<порт>: bind: address already in use

Решение:

# Windows PowerShell
Get-NetTCPConnection -LocalPort 3000,8001,9000,9001,8080 | Select-Object LocalAddress, LocalPort, State, OwningProcess

# Linux/macOS
lsof -i :3000

Проверьте конфликтующие внешние порты системы. Обычно это 3000, 8001, 9000, 9001 и при необходимости 8080.


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

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

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

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

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

**Решение:**
```bash
# Проверьте версии 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.prod.yml pull
docker compose -f docker-compose.yml -f docker-compose.prod.yml up -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-артефакты
docker system prune -f

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

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

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

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