Files
iiEsaywebUI/TROUBLESHOOTING.md
2026-02-19 18:12:09 +00:00

3.6 KiB
Raw Blame History

Устранение проблем: 502 Bad Gateway

Диагностика проблемы 502 Bad Gateway

Шаг 1: Проверка контейнера Open WebUI

# Проверьте статус контейнера
sudo docker ps | grep open-webui

# Если контейнер не запущен, запустите его
cd /home/its/iiEasyWeb
sudo docker compose up -d open-webui

# Проверьте логи
sudo docker compose logs open-webui --tail 50

Шаг 2: Проверка доступности порта

# Проверьте, что порт 3001 слушается
sudo netstat -tlnp | grep 3001
# или
sudo ss -tlnp | grep 3001

# Проверьте доступность локально
curl -I http://localhost:3001
curl -I http://127.0.0.1:3001

Шаг 3: Проверка настроек Nginx Proxy Manager

В Nginx Proxy Manager для odo.iieasy.ru проверьте:

  1. Details:

    • Forward Hostname/IP:
      • Если NPM на той же машине: localhost или 127.0.0.1
      • Если NPM на другой машине: IP адрес машины с Open WebUI
    • Forward Port: 3001 (порт на хосте, не в контейнере)
  2. Advanced:

    • Custom Nginx Configuration: Оставьте ПУСТЫМ (может вызывать ошибки 500/502)

Шаг 4: Если используете другую машину

Если Open WebUI на другой машине:

  1. Убедитесь, что порт 3001 доступен с машины Nginx Proxy Manager:

    # С машины NPM проверьте доступность
    curl http://IP_ДРУГОЙ_МАШИНЫ:3001
    
  2. Проверьте firewall:

    # На машине с Open WebUI разрешите порт 3001
    sudo ufw allow 3001/tcp
    # или
    sudo firewall-cmd --add-port=3001/tcp --permanent
    
  3. В Nginx Proxy Manager укажите:

    • Forward Hostname/IP: IP адрес другой машины
    • Forward Port: 3001

Быстрое решение

Если контейнер не запущен или не отвечает:

cd /home/its/iiEasyWeb

# Перезапустите все сервисы
sudo docker compose down
sudo docker compose up -d

# Подождите 30 секунд
sleep 30

# Проверьте статус
sudo docker compose ps

# Проверьте доступность
curl http://localhost:3001

Частые причины 502 Bad Gateway

  1. Контейнер не запущен → Запустите: sudo docker compose up -d open-webui
  2. Контейнер постоянно перезапускается → Проверьте логи: sudo docker compose logs open-webui
  3. Неправильный Forward Hostname/IP → Используйте localhost если NPM на той же машине
  4. Неправильный Forward Port → Используйте 3001 (порт на хосте), не 8080 (порт в контейнере)
  5. Custom Configuration конфликтует → Оставьте поле пустым
  6. Firewall блокирует → Разрешите порт 3001
  7. Контейнер на другой машине недоступен → Проверьте сетевую доступность

Проверка после исправления

  1. Откройте https://odo.iieasy.ru в браузере
  2. Если все еще 502, проверьте логи Nginx Proxy Manager
  3. Проверьте логи Open WebUI: sudo docker compose logs open-webui