📋 FAQ
💡 Почему Docker?
Мы понимаем, что Docker может быть не для всех предпочтительным выбором, однако этот подход является центральным для дизайна и операционно й эффективности нашего проекта. Мы рассматриваем приверженность проекта к Docker как фундаментальный аспект и призываем тех, кто ищет иные методы развертывания, изучать альтернативы, предложенные сообществом.
Вопрос: Как настроить логотип и брендинг?
Ответ: Вы можете настроить тему, логотип и брендинг с помощью нашего Enterprise License, который предоставляет эксклюзивные функции для корпоративных клиентов.
Для получения дополнительной информации о корпоративных решениях и настройке брендинга, пожалуйста, свяжитесь с нашей командой продаж: 📧 [email protected]
Вопрос: Почему меня просят зарегистрироваться? Куда от правляются мои данные?
Ответ: Мы требуем, чтобы вы зарегистрировались в качестве администратора для повышения безопасности. Это гарантирует, что даже если Open WebUI будет открыт для внешнего доступа, ваши данные останутся защищенными. Важно отметить, что все хранится локально. Мы не собираем ваши данные. При регистрации вся информация остается на вашем сервере и никогда не покидает ваше устройство. Конфиденциальность и безопасность являются нашими главными приоритетами, обеспечивая, чтобы ваши данные всегда оставались под вашим контролем.
Вопрос: Почему мой контейнер Docker не может подключиться к сервисам на хосте, используя localhost
?
Ответ: Внутри контейнера Docker localhost
относится к самому контейнеру, а не к хосту. Это важное различие для сетевого взаимодействия. Чтобы установить соединение от вашего контейнера с сервисами, работающими на хосте, следует использовать DNS-имя host.docker.internal
, а не localhost
. Это имя DNS специально распознается Docker для упрощения таких подключений, позволяя рассматривать хост как доступный объект из контейнера, обходя ограничение области действия localhost
.
Вопрос: Как сделать сервисы хоста доступными для контейнеров Docker?
Ответ: Чтобы сделать сервисы, работающие на хосте, доступными для контейнеров Docker, настройте эти сервисы на прослушивание всех сетевых интерфейсов, используя IP-адрес 0.0.0.0
вместо 127.0.0.1
, который ограничен только localhost
. Эта конфигурация позволяет сервисам принимать подключения с любого IP-адреса, включая контейнеры Docker. Важно учитывать последствия безопасности такой настройки, особенно при работе в средах с потенциальным внешним доступом. Применение соответствующих мер безопасности, таких как брандмауэры и аутентификация, поможет снизить риски.
Вопрос: Почему мой Open WebUI не обновляется? Я перезагрузил/перезапустил контейнер, и ничего не изменилось.
Ответ: Обновление Open WebUI требует не только загрузки нового образа Docker. Вот причины, почему ваши обновления могут не отображаться, и как убедиться, что они применены:
- Обновление образа Docker: Команда
docker pull ghcr.io/open-webui/open-webui:main
обновляет образ Docker, но не сам работающий контейнер или его данные. - Постоянные данные в томах Docker: Томы Docker хранят данные независимо от жизненного цикла контейнеров, сохраняя ваши данные (например, историю чатов) при обновлениях.
- Применение обновления: Убедитесь, что ваше обновление вступает в силу, удалив существующий контейнер (это не удаляет том) и создав новый с обновленным образом и подключенным существующим томом.
Этот процесс обновляет приложение, сохраняя ваши данные.
Вопрос: Подождите, почему я должен удалять контейнер? Я не потеряю свои данные?
Ответ: Это распространенная обеспокоенность, однако удаление контейнера не приводит к потере данных, если вы правильно используете тома Docker. Вот почему:
- Томы сохраняют данные: Томы Docker предназначены для сохранения данных вне жизненного цикла контейнеров. Пока ваши данные хранятся в томе, они остаются невредимыми, вне зависимости от того, что происходит с контейнером.
- Безопасный процесс обновления: При обновлении Open WebUI удаление старого контейнера и создание нового с обновленным образом не влияет на данные, хранящиеся в томах. Главное — не удалять том явно командами вроде
docker volume rm
.
Следуя правильным шагам обновления — загрузке нового образа, удалению старого контейнера без удаления тома и созданию нового контейнера с обновленным образом и существующим томом — вы обновляете код приложения, сохраняя данные неизменными и защищенными.
Вопрос: Следует ли использовать Docker из пакета дистрибутива или официальный пакет Docker?
A: Мы рекомендуем использовать официальную версию Docker вместо дистрибутивных пакетов для запуска Open WebUI. Официальный пакет Docker регулярно обновляется, добавляя новейшие функции, исправления ошибок и патчи безопасности, что обеспечивает оптимальную производительность и безопасность. Кроме того, он поддерживает важные функции, такие как host.docker.internal
, которые могут отсутствовать в дистрибутивных версиях. Эта функция необходима для правильной настройк и сети и подключения внутри контейнеров Docker.
Выбирая официальный пакет Docker, вы получаете преимущества в виде стабильного поведения на разных платформах, более надежной поддержки при устранении неполадок и доступа к последним достижениям Docker. Также сообщество Docker и ресурсы больше ориентированы на официальный пакет, предоставляя вам множество информации и поддержки в случае возникновения проблем.
Все, что вам нужно для работы с Open WebUI, включая ваши данные, остается под вашим контролем и в вашей серверной среде, что подчеркивает нашу приверженность вашей конфиденциальности и безопасности. Для установки официального пакета Docker ознакомьтесь с руководством Установка Docker Engine на официальном сайте документации Docker.
Вопрос: Поддерживается ли GPU в Docker?
A: Поддержка GPU в Docker доступна, но варьируется в зависимости от платформы. Официальная поддержка GPU предоставляется в Docker для Windows и Docker Engine для Linux. Другие платформы, такие как Docker Desktop для Linux и MacOS, в настоящее время не поддерживают GPU. Эта ограниченность важна для приложений, требующих ускорения на GPU. Для лучшего опыта и использования возможностей GPU мы рекомендуем использовать Docker на платформах с официальной поддержкой интеграции GPU.
Вопрос: Почему Open WebUI делает акцент на использовании Docker?
A: Решение использовать Docker обусловлено его способностью обеспечивать стабильность, изоляцию зависимостей и упрощение развертывания в различных средах. Docker минимизирует проблемы совместимости и упрощает процесс запуска WebUI, независимо от базовой системы. Это стратегический выбор разработчиков проекта, который учитывает преимущества, связанные с развертыванием и сопровождением. Мы понимаем, что Docker может быть не предпочтением каждого; однако этот подход является ключевым в дизайне и эффективности нашего проекта. Мы рассматриваем приверженность Docker как фундаментальный аспект проекта и призываем тех, кто ищет альтернативы для развертывания, исследовать решения, предложенные сообществом.
Вопрос: Почему в моем развертывании не работают преобразование речи в текст (STT) и текст в речь (TTS)?
A: Работоспособность сервисов STT и TTS в вашем развертывании может требовать HTTPS для корректного функционирования. Современные браузеры вводят меры безопасности, которые ограничивают использование определенных функций, включая STT и TTS, только при подключении через защищенные HTTPS-соединения. Если ваше развертывание не настроено на использование HTTPS, эти сервисы могут не работать в ожидаемом режиме. Настройка доступности вашего развертывания через HTTPS может решить эти проблемы, обеспечивая полноценную работу функций STT/TTS.
Вопрос: Почему Open WebUI не поддерживает встроенный HTTPS?
A: Хотя мы понимаем желание пользователей иметь универсальное решение, включающее поддержку HTTPS, мы считаем, что такой подход не сможет должным образом удовлетворить разнообразные потребности нашей пользовательской базы. Реализация HTTPS непосредственно в проекте может ограничить гибкость и не соответствовать конкретным требованиям или предпочтениям всех пользователей. Чтобы каждый мог адаптировать свою настройку для своей уникальной среды, мы оставляем реализацию HTTPS на усмотрение пользователей для их производственных развертываний. Это решение позволяет достигать большей адаптивности и настройки. Хотя мы не предлагаем официальной документации по настройке HTTPS, члены сообщества могут предоставить помощь по запросу, делясь своим опытом и рекомендациями.
Вопрос: Я обновил/перезапустил/установил новое ПО, и теперь Open WebUI не работает!
A: Если после обновления или установки нового ПО Open WebUI перестал запускаться, это, вероятно, связано с прямой установкой, особенно если вы не использовали виртуальную среду для управления зависимостями на стороне сервера. Прямые установки могут быть уязвимы к изменениям системной среды, таким как обновления или установки, изменяющие существующие зависимости. Чтобы избежать конфликтов и обеспечить стабильность, мы рекомендуем использовать виртуальную среду для управления зависимостями из файла requirements.txt
вашей серверной части. Это изолирует зависимости Open WebUI от других системных пакетов, сводя к минимуму риск таких проблем.
Вопрос: Я обновил/перезапустил систему, и теперь мой вход в систему не работает, мне пришлось создать новый аккаунт, и все мои чаты пропали.
A: Эта проблема обычно возникает, когда контейнер Docker создается без подключения тома для /app/backend/data
или если назначенный том Open WebUI (обычно называемый open-webui
в наших примерах) был случайно удален. Том Docker необходим для сохранения данных в течение жизненного цикла контейнера. Если вам нуж но создать новую учетную запись после перезагрузки, это вероятно означает, что вы создали новый контейнер без подключения существующего тома, где хранятся ваши данные. Убедитесь, что ваша команда запуска Docker включает подключение тома с правильным местоположением данных, чтобы избежать их потери.
Q: Я попытался войти, но не смог, создал новую учетную запись, и теперь сообщается, что моя учетная запись должна быть подтверждена администратором.
A: Эта ситуация возникает, если вы забыли пароль от первоначальной учетной записи администратора, созданной на этапе начальной настройки. Первая учетная запись автоматически назначается учетной записью администратора. Создание новой учетной записи без доступа к учетной записи администратора приведет к необходимости активации администратора. Избегайте потери учетных данных первоначальной учетной записи администратора для беспроблемного доступа и управления Open WebUI. Ознакомьтесь с руководством Сброс пароля администратора для восстановления учетной записи администратора.
Q: Почему Open WebUI не запускается из-за ошибки SSL?
A: Ошибка SSL, которую вы видите при запуске Open WebUI, вероятно, связана с отсутствием SSL сертификатов или неправильной конфигурацией huggingface.co. Для решения этой проблемы вы можете настроить зеркало HuggingFace, например, hf-mirror.com, и указать его в качестве конечной точки при запуске контейнера Docker. Используйте параметр -e HF_ENDPOINT=https://hf-mirror.com/
для определения адреса зеркала HuggingFace в команде Docker. Например, модифицируйте команду Docker таким образом:
docker run -d -p 3000:8080 -e HF_ENDPOINT=https://hf-mirror.com/ --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Q: RAG с Open WebUI работает плохо или не работает вообще. Почему?
A: Если вы используетесь Ollama, помните, что Ollama устанавливает длину контекста 2048 токенов по умолчанию. Это означает, что ни одни из извлеченных данных могут не использоваться, поскольку они не помещаются в доступное окно контекста.
Для улучшения производительности Генерации с использованием извлечения (RAG) с Open WebUI, вам следует увеличить длину контекста до гораздо большего значения (8192+ токенов), чтобы извлеченные документы могли эффективно способствовать ответам модели.
Для этого сконфигурируйте параметры модели Ollama, чтобы разрешить большее окно контекста. Вы можете проверить и изменить эту настройку непосредственно в чате или на странице редактора модели, чтобы значительно улучшить опыт использования RAG.
Q: Поддерживается ли MCP (протокол контекста модели) в Open WebUI?
A: Да, Open WebUI официально поддерживает MCP Tool Servers — но исключительно через прокси, совместимый с OpenAPI (openapi-servers) для оптимальной совместимости, безопасности и поддержки.
Для интеграции MCP (и других протоколов бэкенда) мы предоставляем специализированную имплементацию прокси, доступную здесь: 👉 https://github.com/open-webui/mcpo
Этот выбор дизайна мотивирован несколькими ключевыми принципами:
- 📘 Принцип стандартизации: OpenAPI является стандартом де-факто для описания RESTful сервисов и их совместимости. Совмещение интеграции через OpenAPI позволяет обеспечить воспро изводимое поведение, основанное на схеме, в рамках обновлений и развертываний.
- 🔒 Модель безопасности и изоляция: Интеграция MCP через прокси позволяет содержать протокол бэкенда в песочнице, сокращая поверхность атак и предоставляя возможности аудита, аутентификации и наблюдения.
- ⚙️ Абстракция протоколов: Поддержка гетерогенных бэкендов (таких как MCP) через единый OpenAPI обеспечивает сохранение нейтральности бэкенда для Open WebUI при предсказуемом поведении в рантайме.
- ⛓️ Разделенная топология развертывания: Архитектура, основанная на прокси, позволяет Tool Servers (например, MCP) развиваться независимо от представления фронтенда, что способствует модульным производственным средам или распределенным нагрузкам.
В итоге: MCP поддерживается — при условии, что MCP Tool Server работает через прокси, совместимый с OpenAPI. Это архитектурное решение принято сознательно, чтобы обеспечить масштабируемость, безопасность и удобство поддержки Open WebUI.
Нужна дополнительная помощь?
Если у вас есть дополнительные вопросы или проблемы, пожалуйста, обратитесь на нашу страницу GitHub Issues или в наш канал Discord для получения помощи и информации.