Open WebUI
Self-hosted веб-интерфейс в стиле ChatGPT для команды: аккаунты, RAG по документам, голос и картинки на моделях AITUNNEL.
Open WebUI разворачивают на своём сервере и раздают доступ сотрудникам: у каждого свой аккаунт и история, есть RAG по документам, голосовой ввод, озвучка и генерация картинок. AITUNNEL подключается как OpenAI-совместимое API, ключ вводит администратор, и он один на весь сервер.
Понадобятся Docker (или Python 3.11–3.12 для установки через pip) и ключ из панели.
Здесь только настройка. Полное описание программы, все параметры и разбор ошибок — на странице Open WebUI в каталоге инструментов.
Быстрый старт
Запуск в Docker
Адрес и ключ можно передать сразу при первом запуске:
bashdocker run -d -p 3000:8080 \ -v open-webui:/app/backend/data \ -e WEBUI_SECRET_KEY="придумайте-длинную-строку" \ -e OPENAI_API_BASE_URL="https://api.aitunnel.ru/v1" \ -e OPENAI_API_KEY="sk-aitunnel-xxx" \ -e ENABLE_OLLAMA_API=False \ --name open-webui --restart always \ ghcr.io/open-webui/open-webui:mainОткройте
http://localhost:3000и зарегистрируйтесь: первый аккаунт становится администратором. Без Docker:pip install open-webui, затемopen-webui serve(интерфейс наhttp://localhost:8080).Подключение через интерфейс
Если переменные при запуске не передавали: Admin Panel → Settings → Connections, в блоке OpenAI API нажмите + и заполните:
- URL:
https://api.aitunnel.ru/v1 - Auth:
Bearer, Key:sk-aitunnel-xxx - Provider:
Default, API Type:Chat Completions
Нажмите Verify Connection, затем сохраните. Простое сохранение подключение не проверяет.
- URL:
Список моделей
В каталоге почти две сотни моделей, и все попадут в выпадающий список. Чтобы показать только нужные, в разделе Advanced подключения заполните Model IDs, например:
claude-sonnet-5.5,claude-opus-5.5,gpt-6.1-terra,gemini-3.8-flash,deepseek-v4.1-flash,gpt-6-luna.С заданным списком Open WebUI не запрашивает
/models. Prefix ID (например,aitunnel) добавит к названиям префикс, если у нескольких провайдеров совпадают id.Доступ для пользователей
По умолчанию модели видит только администратор. Откройте доступ в Admin Panel → Settings → Models → модель → Access:
Publicили конкретной группе. Либо запустите сBYPASS_MODEL_ACCESS_CONTROL=true, и все модели станут видны всем.
Служебная модель
Названия чатов, теги и поисковые запросы Open WebUI генерирует отдельными вызовами той же модели, что ведёт диалог. На флагмане это лишние расходы. В Admin Panel → Settings → Interface → Tasks выберите External Task Model: gpt-6-luna или claude-haiku-5.5.
RAG по документам
В Admin Panel → Settings → Documents поставьте Embedding Model Engine = OpenAI, явно укажите адрес https://api.aitunnel.ru/v1 и ключ, модель text-embedding-3-small (или qwen3-embedding-8b для русских текстов). Для реранкера включите Hybrid Search, Reranking Engine = External, URL https://api.aitunnel.ru/v1/rerank (полный адрес), модель rerank-5-fast. То же через переменные:
-e RAG_EMBEDDING_ENGINE=openai \
-e RAG_OPENAI_API_BASE_URL="https://api.aitunnel.ru/v1" \
-e RAG_OPENAI_API_KEY="sk-aitunnel-xxx" \
-e RAG_EMBEDDING_MODEL="text-embedding-3-small" \
-e ENABLE_RAG_HYBRID_SEARCH=true \
-e RAG_RERANKING_ENGINE=external \
-e RAG_EXTERNAL_RERANKER_URL="https://api.aitunnel.ru/v1/rerank" \
-e RAG_EXTERNAL_RERANKER_API_KEY="sk-aitunnel-xxx" \
-e RAG_RERANKING_MODEL="rerank-5-fast"После смены модели эмбеддингов нажмите Reindex на той же странице.
Модели
| Задача | Модель |
|---|---|
| Основная модель для команды | claude-sonnet-5.5, gpt-6.1-terra |
| Сложный анализ | claude-opus-5.5, gpt-6.1-sol |
| Быстрые ответы, длинные документы | gemini-3.8-flash |
| Массовое использование | deepseek-v4.1-flash, gpt-6-luna |
| Служебные задачи | gpt-6-luna, claude-haiku-5.5 |
Устранение неполадок
Verify Connection падает по таймауту
Список моделей большой. Увеличьте AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=30 или заполните Model IDs, тогда список не запрашивается вовсе.
Пользователи не видят модели
Модели приватны по умолчанию. Откройте доступ в Admin Panel → Settings → Models или включите BYPASS_MODEL_ACCESS_CONTROL=true.
RAG-запросы уходят в OpenAI
В некоторых версиях адрес и ключ не наследуются из основного подключения. Заполните их в Documents явно.