iiEsaywebUI/nginx-proxy-manager-config.md

Конфигурация Nginx Proxy Manager для odo.iieasy.ru

Настройка прокси для Open WebUI

Шаг 1: Создание Proxy Host в Nginx Proxy Manager

1. Войдите в Nginx Proxy Manager (обычно http://your-server-ip:81)
2. Перейдите в Proxy Hosts → Add Proxy Host

Шаг 2: Настройка Details

• Domain Names: odo.iieasy.ru
• Scheme: http
• Forward Hostname/IP: open-webui (имя контейнера Docker) или localhost
• Forward Port: 3001 (изменено с 3000)
• Cache Assets: Включено (опционально)
• Block Common Exploits: Включено
• Websockets Support: ВКЛЮЧЕНО (важно для Open WebUI!)

Шаг 3: Настройка SSL

ВАЖНО: SSL сертификат должен быть настроен ДО того, как вы сможете открыть сайт по HTTPS.

Вариант A: Использование Let's Encrypt (рекомендуется)

1. В Nginx Proxy Manager перейдите в SSL Certificates → Add SSL Certificate
2. Выберите Let's Encrypt
3. Заполните:
   • Domain Names: odo.iieasy.ru (можно добавить несколько через запятую)
   • Email Address: Ваш email (для уведомлений об истечении сертификата)
   • Agree to Let's Encrypt Terms: Включено
   • Use a DNS Challenge: Обычно НЕ нужно (используется HTTP challenge)
4. Нажмите Save
5. Дождитесь создания сертификата (может занять 1-2 минуты)

Требования для Let's Encrypt:

• Домен odo.iieasy.ru должен указывать на IP вашего сервера (A-запись в DNS)
• Порт 80 должен быть доступен из интернета (для HTTP challenge)
• Nginx Proxy Manager должен быть доступен на порту 80

Вариант B: Использование существующего сертификата

Если у вас уже есть SSL сертификат:

1. SSL Certificates → Add SSL Certificate → Custom
2. Вставьте содержимое файлов:
   • Certificate: содержимое .crt или .pem файла
   • Private Key: содержимое .key файла
3. Нажмите Save

Вариант C: Временное отключение SSL (только для тестирования)

Если нужно быстро проверить работу без SSL:

1. В Proxy Host настройках убедитесь, что SSL не включен
2. Используйте HTTP вместо HTTPS: http://odo.iieasy.ru

Шаг 4: Применение SSL к Proxy Host

После создания SSL сертификата:

1. Вернитесь к вашему Proxy Host для odo.iieasy.ru
2. Перейдите на вкладку SSL
3. Выберите созданный сертификат в поле SSL Certificate
4. Включите:
   • Force SSL: Включено (перенаправляет HTTP на HTTPS)
   • HTTP/2 Support: Включено
   • HSTS Enabled: Включено (опционально)
   • HSTS Subdomains: Включено (опционально, если используете поддомены)
5. Нажмите Save

Шаг 5: Настройка Advanced (Custom Nginx Configuration)

ВАЖНО: Nginx Proxy Manager автоматически управляет большинством настроек. Custom Configuration обычно НЕ нужна и может вызвать ошибки 500.

Оставьте поле Custom Nginx Configuration ПУСТЫМ, если все работает без него.

Если все же нужны дополнительные настройки (только при проблемах), добавьте минимальную конфигурацию:

# Увеличение размера тела запроса для загрузки файлов (если нужно)
client_max_body_size 100M;

# Увеличенные таймауты (только если есть проблемы с таймаутами)
proxy_read_timeout 300s;

Но лучше оставить пустым - Nginx Proxy Manager сам настроит WebSocket, заголовки и другие параметры через интерфейс.

Шаг 6: Если используется Docker сеть

Если Nginx Proxy Manager работает в той же Docker сети, что и Open WebUI:

1. В Forward Hostname/IP укажите: open-webui (имя контейнера)
2. В Forward Port укажите: 8080 (внутренний порт контейнера)

Если Nginx Proxy Manager работает на хосте:

1. В Forward Hostname/IP укажите: localhost или 127.0.0.1
2. В Forward Port укажите: 3001 (порт на хосте)

Проверка работы

После настройки проверьте:

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

Устранение проблем

ERR_SSL_UNRECOGNIZED_NAME_ALERT

Эта ошибка означает, что SSL сертификат не настроен или не соответствует домену.

Решение:

1. Проверьте, что SSL сертификат создан в Nginx Proxy Manager
2. Убедитесь, что сертификат применен к Proxy Host (вкладка SSL)
3. Проверьте, что домен odo.iieasy.ru указан в сертификате
4. Если используете Let's Encrypt, проверьте:
   • DNS A-запись для odo.iieasy.ru указывает на IP сервера
   • Порт 80 доступен из интернета
   • Домен не заблокирован файрволом

Временное решение для тестирования:

• Отключите SSL в Proxy Host
• Используйте HTTP: http://odo.iieasy.ru
• После настройки SSL включите обратно

Ошибка 502 Bad Gateway

• Убедитесь, что контейнер open-webui запущен: docker ps | grep open-webui
• Проверьте, что порт 3001 доступен: curl http://localhost:3001
• Проверьте логи: docker compose logs open-webui

WebSocket не работает

• Убедитесь, что Websockets Support включен в Nginx Proxy Manager
• НЕ добавляйте WebSocket настройки в Custom Configuration - они конфликтуют с автоматическими настройками NPM

Медленная загрузка

• Проверьте логи: docker compose logs open-webui
• Убедитесь, что контейнер Open WebUI работает нормально
• Если нужны большие файлы, добавьте только client_max_body_size 100M; в Custom Configuration (но лучше оставить пустым)