Open WebUI — собственный интерфейс для любых языковых моделей

Open WebUI — платформа, которую можно развернуть на своём сервере и использовать как единый интерфейс для локальных и облачных языковых моделей. Она объединяет чаты, базы знаний, инструменты, заметки и командные пространства и позволяет контролировать инфраструктуру и доступ.

Что такое Open WebUI

Open WebUI — самостоятельный веб-интерфейс для больших языковых моделей. Вы разворачиваете его на своём оборудовании или в облаке, подключаете нужные модели и управляете пользователями, знаниями и инструментами из одного приложения.

Платформа не привязана к одному провайдеру. В одном интерфейсе можно работать с моделями через Ollama, OpenAI, Anthropic и другие подключения, совместимые с OpenAI API, а также сравнивать ответы нескольких моделей.

При использовании только локальных моделей и заранее отключённых внешних интеграций экземпляр можно настроить для изолированного контура. Веб-поиск, облачные модели, внешние инструменты и другие сетевые функции требуют соответствующих подключений.

Как развивался проект

• Автор проекта. В текущем тексте лицензии Open WebUI автором указан Timothy Jaeryang Baek.
• Популярность репозитория. На 8 сентября 2026 года страница официального репозитория показывает около 151 тысячи звёзд GitHub. Это показатель репозитория, а не число пользователей.
• Платформенный набор функций. Официальный каталог возможностей включает чаты, базы знаний, заметки, каналы, Open Terminal, расширения, управление доступом, аналитику, автоматизации и работу с задачами.
• v0.11.0 от 27 июля 2026 года. Релиз принёс переработанный интерфейс, субагентов, страницы папок, таймеры чатов, настройки целей уведомлений, полноценные ответы в каналах, открытый доступ к общим чатам и совместную работу с папками.
• v0.11.1–v0.11.3. В этой серии появились подтверждение вызова инструментов человеком, встроенный инструмент вопросов пользователю, показ файлов из терминала прямо в ответе и новый стриминг. В v0.11.3 дополнительно улучшены функции доступности и обработка ошибок миграции базы данных.

Основные возможности

Официально поддерживаемыми векторными базами документация называет ChromaDB и PGVector. Остальные варианты относятся к дополнительным интеграциям.

Развёртывание с Ollama

Один из локальных сценариев — Ollama на основной машине и Open WebUI в Docker.

# Скачиваем локальную модель
ollama pull llama3

# Запускаем Open WebUI и указываем адрес Ollama на основной машине
docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Если Ollama находится в другом месте, замените значение OLLAMA_BASE_URL на адрес, доступный из контейнера.

После запуска интерфейс открывается по адресу http://localhost:3000. При первом входе создаётся учётная запись администратора.

Проверьте результат:

docker logs -f open-webui

Успешный запуск означает, что контейнер работает без критических ошибок, страница открывается, а модель llama3 доступна в списке моделей.

Установка без Docker:

pip install open-webui
open-webui serve

Для крупных установок документация описывает Kubernetes и Helm, общие базы данных и хранилища, Redis для координации экземпляров, S3, GCS или Azure Blob, а также OpenTelemetry. Такая схема позволяет добавлять реплики приложения за балансировщиком нагрузки.

Подключение моделей и работа через API

Облачные и совместимые с OpenAI API модели добавляются через административные настройки подключений. Обычно требуется базовый URL провайдера и его API-ключ.

Open WebUI предоставляет собственный API. Официальная документация помечает его как экспериментальный, поэтому при обновлении версии нужно проверять совместимость интеграций.

Для аутентификации используются API-ключ или JWT в заголовке Bearer:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  http://localhost:3000/api/models

Запрос к чату через совместимую с OpenAI API конечную точку:

curl -X POST http://localhost:3000/api/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_MODEL_ID",
    "messages": [
      {"role": "user", "content": "Кратко объясни назначение Open WebUI"}
    ]
  }'

При передаче поля tool_ids эта конечная точка может запускать настроенные на сервере Python-, OpenAPI- и MCP-инструменты, если у пользователя есть к ним доступ.

Также доступны совместимые с Anthropic Messages конечные точки POST /api/message и POST /api/v1/messages. Для Anthropic SDK базовый адрес должен оканчиваться на /api, поскольку SDK самостоятельно добавляет /v1/messages.

Документы и поиск по ним с Docling

Для документов с таблицами можно подключить Docling. Open WebUI указывает его среди поддерживаемых движков извлечения вместе с Tika, Azure, Mistral OCR, Datalab Marker, MinerU, PaddleOCR и пользовательскими загрузчиками.

Схема подключения:

1. Разверните Docling Serve.
2. Откройте Admin Panel → Settings → Documents.
3. Выберите Docling как движок извлечения и укажите адрес сервера.
4. Загрузите тестовый документ с таблицей.
5. Проверьте извлечённый текст и задайте вопрос, ответ на который находится внутри таблицы.

При загрузке через API обработка файла по умолчанию выполняется в фоне. Перед добавлением файла в базу знаний проверяйте GET /api/v1/files/{id}/process/status: рабочий статус должен измениться с pending на completed. Попытка добавить ещё не обработанный файл может завершиться ошибкой 400 из-за пустого содержимого.

Лицензия и расходы

• Лицензия разрешает использовать, изменять и распространять код при соблюдении её условий. Отдельное ограничение касается брендинга.
• Использование локальных моделей ограничивается ресурсами вашего оборудования.
• Облачные модели оплачиваются их провайдерам по отдельным тарифам.
• Изменение брендинга в установках более чем для 50 конечных пользователей за скользящие 30 дней требует письменного разрешения или соответствующей enterprise-лицензии.

В предоставленном тексте лицензии публичная стоимость не указана. Актуальные коммерческие условия и состав корпоративного предложения нужно уточнять у Open WebUI.

Безопасность и обновления

Open WebUI развивается быстро, а официальный список Security Advisories регулярно пополняется. На странице advisories, полученной 8 сентября 2026 года, указаны, среди прочих, следующие проблемы:

• доступ любого авторизованного пользователя к Azure platform channel через серверную веб-загрузку — GHSA-34r3-9m95-vq73, опубликована 30 августа 2026 года, уровень High;
• раскрытие недоступных пользователю баз знаний через встроенный инструмент — GHSA-pcvc-8vrv-8q6w, опубликована 31 августа 2026 года, уровень Moderate;
• перезапись сообщения другого участника канала через chat completions — GHSA-fmqh-xp37-5hr8, опубликована 31 августа 2026 года, уровень Moderate;
• вход под другим пользователем из-за wildcard-символов в OAuth subject claim при SQLite — GHSA-wpmr-8h3q-fwj7, опубликована 4 сентября 2026 года, уровень High;
• XSS с риском захвата учётной записи через iframe предварительного просмотра терминального порта — GHSA-jmc6-2wr8-h3wj, опубликована 31 августа 2026 года, уровень High;
• SSRF во внутренние сервисы через DNS rebinding в Playwright web loader — GHSA-4v28-j6q3-5m4r, опубликована 31 августа 2026 года, уровень High.

Индекс advisories не показывает на общей странице исправленные версии для каждого пункта. Перед обновлением откройте карточку конкретной уязвимости и проверьте диапазон затронутых и исправленных релизов. Последний опубликованный релиз v0.11.3 от 31 августа не означает автоматически, что он закрывает advisories, опубликованные позднее.

Ограничения и когда инструмент не подходит

• Ресурсы для локальных моделей. Сам интерфейс сравнительно лёгкий, но требования LLM зависят от размера модели, длины контекста и числа одновременных пользователей.
• Операционная нагрузка. Self-hosted-развёртывание требует резервного копирования, мониторинга, обновлений и управления секретами.
• Лицензия и брендинг. Условия изменения брендинга нужно учитывать до запуска сценария с заменой фирменного оформления.
• Быстрый цикл релизов. Обновления могут менять интерфейс, API и поведение функций. В продакшене нужен зафиксированный релиз и предварительная проверка миграций.
• RAG требует настройки. Качество зависит от извлечения текста, разбиения документов, векторных представлений, поисковой конфигурации и прав доступа.
• Инструменты расширяют поверхность атаки. Open Terminal, MCP, OpenAPI-серверы и веб-загрузчики нужно выдавать только тем пользователям и моделям, которым они действительно необходимы.

Полезные сценарии

Личный ассистент на локальной модели

Исходное условие: есть компьютер или сервер с ресурсами для выбранной модели. Установите Ollama, загрузите модель и подключите Open WebUI. Проверка: локальный чат отвечает при отключённом облачном подключении. Сценарий не подходит, если оборудование не обеспечивает приемлемую скорость или нужна модель, доступная только в облаке.

Единый ИИ-портал для команды

Подключите несколько провайдеров, настройте роли, группы и доступ к моделям. При необходимости добавьте OIDC, LDAP или SCIM. Проверяемый результат: сотрудник видит только разрешённые ему модели и ресурсы. Такой портал требует регулярных обновлений и администрирования.

Поиск по внутренним документам

Создайте базу знаний, загрузите документы и настройте извлечение. Для сложных PDF используйте Docling или другой подходящий движок. Проверка: модель отвечает на контрольные вопросы и указывает релевантные фрагменты. Сценарий не стоит считать готовым без тестового набора вопросов и проверки разграничения доступа.

Хаб для нескольких провайдеров

Добавьте локальные и облачные модели, затем сравните их ответы в одном разговоре. Наблюдаемый результат — возможность выбирать модель под качество, скорость и стоимость конкретной задачи. Нужно учитывать отдельные тарифы и правила обработки данных каждого провайдера.

Специализированные агенты

Объедините базовую модель, системный промпт, знания и инструменты в пресете. Например, можно собрать помощника поддержки или ревьюера кода. Проверяйте его на повторяемом наборе задач и ограничьте доступ к опасным инструментам. В v0.11.1 появился режим подтверждения вызовов инструментов человеком; его должен включить администратор.

Автоматизация через API

Используйте /api/chat/completions для внутренних приложений и скриптов, а tool_ids — для разрешённых серверных инструментов. Проверяемый результат — авторизованный запрос возвращает ответ выбранной модели. API остаётся экспериментальным, поэтому интеграцию нужно повторно тестировать при обновлении Open WebUI.

Официальные ссылки

• Сайт: openwebui.com
• Документация и возможности: docs.openwebui.com
• Справочник API: API Endpoints
• Исходный код и релизы: github.com/open-webui/open-webui
• Лицензия: Open WebUI License
• Уведомления о безопасности: Security Advisories

Следующий шаг

Как поднять свою LLM и подключить к Codex

Связанные материалы

• Статья: Перестаньте искать самую умную нейросеть. Стройте среду
• Блог: LM Studio Bionic: агент для открытых моделей
• База знаний: Ollama или LM Studio: что выбрать для старта с локальными моделями

Если вы выбираете собственную ИИ-среду для себя или команды, полезно заранее сопоставить требования к данным, моделям, доступу и обслуживанию инфраструктуры.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov