Open WebUI — свой ChatGPT для команды без VPN
Open WebUI — self-hosted веб-интерфейс для команды с RAG, голосом и картинками на моделях AITUNNEL
Open WebUI — self-hosted веб-интерфейс в стиле ChatGPT. Его разворачивают на своём сервере и раздают доступ сотрудникам: у каждого свой аккаунт и история, есть RAG по документам, голосовой ввод, озвучка, генерация картинок и веб-поиск. Подключив AITUNNEL, вы получаете Claude, GPT, Gemini, DeepSeek и другие модели для всей команды через один ключ.
API-ключ для Open WebUI
Open WebUI обращается к моделям через API-ключ. Ключ AITUNNEL вида sk-aitunnel-... один для всех моделей из каталога: чтобы перейти с Claude на GPT или DeepSeek, достаточно сменить id модели.
- Зарегистрируйтесь на aitunnel.ru и пополните баланс (от 500₽).
- Откройте Ключи, нажмите «Новый», задайте имя и нажмите «Создать ключ».
- Скопируйте ключ. Его можно показать повторно в любой момент.
Ключ вводит администратор, и он один на весь сервер. Сотрудники его не видят, а все запросы идут с общего баланса. Месячный бюджет с автосбросом на этом ключе работает как потолок расходов всей команды.
Тот же ключ нужен в настройках документов для эмбеддингов и реранкера (RAG_OPENAI_API_KEY, RAG_EXTERNAL_RERANKER_API_KEY), а также для голоса и картинок. Переменная OPENAI_API_KEY применяется только при первом запуске контейнера. Чтобы потом сменить ключ, откройте Admin Panel → Settings → Connections.
Бюджет, ограничения по моделям и IP, сброс ключа — в документации по ключам.
Что понадобится
- Сервер или компьютер с Docker (или Python 3.11–3.12 для установки через pip)
- Ключ AITUNNEL
sk-aitunnel-...из личного кабинета - Положительный баланс (от 500₽)
Установка через Docker
Ключ и адрес можно передать сразу при первом запуске:
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> Важно: переменные окружения Open WebUI применяет только при первом запуске. Дальше настройки хранятся в базе и меняются в интерфейсе. Если поменяли переменную и ничего не изменилось — правьте в админ-панели или запустите с ENABLE_PERSISTENT_CONFIG=False.
Подключение через интерфейс
Если не передавали переменные при запуске:
- Admin Panel → Settings → Connections.
- В блоке OpenAI API нажмите + (Add Connection).
- Заполните:
- URL: https://api.aitunnel.ru/v1 - Auth: Bearer, в поле Key — sk-aitunnel-xxx - Provider: Default - API Type: Chat Completions
- Нажмите Verify Connection — Open WebUI запросит список моделей. Простое сохранение подключение не проверяет.
- Сохраните.
Ограничьте список моделей
В каталоге AITUNNEL почти две сотни моделей, и все они появятся в выпадающем списке. Удобнее показать только нужные: в разделе 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.
Доступ пользователей к моделям
По умолчанию модели видит только администратор. Чтобы сотрудники увидели модели AITUNNEL:
- 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 - API Base URL:
https://api.aitunnel.ru/v1 - API Key:
sk-aitunnel-xxx - Embedding Model:
text-embedding-3-small(илиqwen3-embedding-8bдля русскоязычных документов)
Заполняйте адрес и ключ явно — в некоторых версиях они не наследуются из основного подключения, и запросы уходят на api.openai.com.
Реранкер
Реранкер переупорядочивает найденные фрагменты по смыслу и заметно повышает точность ответов:
- Включите Hybrid Search
- Reranking Engine:
External - URL:
https://api.aitunnel.ru/v1/rerank— здесь нужен полный адрес - API Key:
sk-aitunnel-xxx - Reranking Model:
rerank-5-fast(илиrerank-5-proдля максимальной точности)
После смены модели эмбеддингов переиндексируйте документы — кнопка Reindex на той же странице.
Через переменные окружения
-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"Голос: распознавание и озвучка
Admin Panel → Settings → Audio:
Распознавание речи (STT):
- Engine:
OpenAI - API Base URL:
https://api.aitunnel.ru/v1, ключ — ваш ключ AITUNNEL - Model:
gpt-4o-transcribeилиwhisper-1— поле обязательно, по умолчанию пустое
Синтез речи (TTS):
- Engine:
OpenAI - API Base URL:
https://api.aitunnel.ru/v1, ключ AITUNNEL - Model:
gpt-4o-mini-tts, Voice:alloy,novaили другой голос OpenAI
Генерация изображений
Admin Panel → Settings → Images:
- Image Generation Engine:
OpenAI - API Base URL:
https://api.aitunnel.ru/v1, ключ AITUNNEL - Model:
gpt-image-2 - Image Size:
1024x1024— значение по умолчанию 512x512 современные модели не поддерживают
В чате включите генерацию картинок кнопкой на панели ввода.
Какие модели подключить
| Задача | Модель |
|---|---|
| Основная модель для команды | 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 явно заданы адрес и ключ AITUNNEL. Включите реранкер.
Почему это выгодно
- Без VPN — сервер в России ходит на
api.aitunnel.ruнапрямую - Один ключ для всего — чат, эмбеддинги, реранкер, голос, картинки
- Для бизнеса — оплата по счёту, закрывающие документы через ЭДО
- Контроль расходов — отдельные ключи с лимитами для разных команд, расход по каждому запросу в кабинете
Ключевые возможности
- Один API-ключ AITUNNEL на все модели
- Self-hosted ChatGPT для всей команды
- Подключение одной строкой в Docker
- RAG на эмбеддингах и реранкере AITUNNEL
- Распознавание и синтез речи
- Генерация изображений
- Оплата по счёту для бизнеса
Подключите этот инструмент через AITUNNEL
Все инструменты и модели доступны через единый API. Работает из России, оплата в рублях.