Open WebUI

Self-hosted веб-интерфейс в стиле ChatGPT для команды: аккаунты, RAG по документам, голос и картинки на моделях AITUNNEL.

Open WebUI разворачивают на своём сервере и раздают доступ сотрудникам: у каждого свой аккаунт и история, есть RAG по документам, голосовой ввод, озвучка и генерация картинок. AITUNNEL подключается как OpenAI-совместимое API, ключ вводит администратор, и он один на весь сервер.

Понадобятся Docker (или Python 3.11–3.12 для установки через pip) и ключ из панели.

Здесь только настройка. Полное описание программы, все параметры и разбор ошибок — на странице Open WebUI в каталоге инструментов.

Быстрый старт

  1. Запуск в Docker

    Адрес и ключ можно передать сразу при первом запуске:

    bash
    docker 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).

  2. Подключение через интерфейс

    Если переменные при запуске не передавали: 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, затем сохраните. Простое сохранение подключение не проверяет.

  3. Список моделей

    В каталоге почти две сотни моделей, и все попадут в выпадающий список. Чтобы показать только нужные, в разделе 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.

  4. Доступ для пользователей

    По умолчанию модели видит только администратор. Откройте доступ в 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. То же через переменные:

bash
-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 явно.

Смотрите также