Open WebUI: установка через Docker и подключение моделей по API

Open WebUI ставится одной командой и даёт свой чат ко всем моделям в браузере. Разбираем, куда вписать адрес и ключ и почему после этого список моделей бывает пуст.

Получить ключ Что делать

/ Короткий ответ

Что это значит

Open WebUI — это открытый веб-интерфейс для чата с нейросетями, который вы ставите у себя: на ноутбуке, на сервере команды или в облаке. Внешне похож на ChatGPT: история диалогов, несколько пользователей, загрузка файлов, выбор модели в выпадающем списке. Своих моделей у него нет: он работает с локальной Ollama и с любым OpenAI-совместимым API по адресу и ключу.

Ставится через Docker одной командой, после чего открывается на localhost:3000. Первый зарегистрированный пользователь становится администратором. Подключение внешнего API лежит в Settings → Connections (у администратора — Admin → Settings → Connections): поле OpenAI API base URL и поле ключа. После сохранения Open WebUI сам запрашивает список моделей у сервера и показывает их в чате.

Если список моделей после этого пуст, причин две: base URL без /v1 или с лишним хвостом, либо неверный ключ. Кнопка Verify connection рядом с полями проверяет оба сразу и пишет, что не так.

/ Почему

Откуда берётся ошибка

Base URL без /v1. Open WebUI запрашивает /models относительно адреса; без /v1 сервер отвечает 404, и список пуст.
Ключ не от этого сервера. Ответ 401, Verify connection не проходит, моделей нет.
Адрес с /chat/completions на конце. Лишний хвост ломает и список моделей, и сами запросы.
Контейнер не видит сеть. Docker без доступа наружу или прокси, который режет запросы к API: Verify connection висит и падает по таймауту.
Подключение выключено. У каждого соединения есть переключатель; после обновления он иногда оказывается в положении «выкл».

/ Что делать

Порядок действий

Установите Docker и запустите контейнер

Одной командой. Порт 3000 можно заменить на любой свободный, данные сохраняются в томе open-webui между перезапусками.

docker run -d -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Создайте администратора

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

Добавьте подключение

Admin → Settings → Connections → OpenAI API. Впишите адрес с /v1 и ключ, нажмите Verify connection, затем Save.

OpenAI API base URL:  https://api.kosareva.cloud/v1
API Key:              ваш-ключ

Проверьте, что сервер отдаёт модели

Если Verify connection не проходит, тот же адрес и ключ проверьте curl с машины, где стоит Docker. Ответ должен быть JSON со списком моделей.

curl https://api.kosareva.cloud/v1/models \
  -H "Authorization: Bearer ваш-ключ"

Ограничьте список моделей

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

/ По инструментам

Где это чинится в разных инструментах

Open WebUI и Ollama вместе. Локальные модели через Ollama и облачные через API живут в одном списке; пользователь выбирает модель на каждый диалог.
Docker Compose. Те же параметры в compose-файле; переменные OPENAI_API_BASE_URL и OPENAI_API_KEY задают подключение без входа в настройки.
Сервер команды. Open WebUI за nginx с HTTPS, пользователи регистрируются сами, администратор включает им доступ и назначает модели.
Несколько API. Подключений может быть несколько, у каждого свой адрес и ключ; модели с одинаковыми именами лучше развести префиксами.

/ FAQ

Частые вопросы

Open WebUI работает без Ollama?

Да. Ollama нужна только для локальных моделей. С внешним API достаточно контейнера Open WebUI и подключения в Connections.

Verify connection проходит, а моделей в чате нет

Проверьте, что подключение включено переключателем и что для пользователя не ограничен список моделей в Admin → Users. Иногда помогает обновить страницу после Save.

Как обновить Open WebUI?

Остановить и удалить контейнер, скачать свежий образ и запустить той же командой. Данные в томе open-webui сохраняются.

/ На kosareva.cloud

Как это выглядит у нас

С нашим шлюзом Open WebUI подключается одним соединением: base URL https://api.kosareva.cloud/v1 и ключ из кабинета, после Verify connection в списке появляются все модели каталога — gpt-5-6, claude-sonnet-5, gemini-3-8-flash, deepseek-v4-flash и остальные. Для команды удобно выпустить отдельный ключ под Open WebUI с лимитом и смотреть расход по нему в кабинете. Gemini 3.8 Flash стоит 81 ₽ за миллион входных токенов и 405 ₽ за миллион выходных, Qwen3.8 Flash — 15,12 и 45,36 ₽.

/ Дальше

Рядом в справочнике

Ключ, который работает из России

OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации. Пополнение картой от 50 ₽.

Получить ключ