Раздел 3 из 8

Настройка Open WebUI: первый вход и подключение моделей

Автор курса — Тимофей Ермолаев

Создайте первого администратора Open WebUI, проверьте доступ и подключите Ollama или OpenAI-совместимый API для первого ответа модели.

10 уроков2 ч 7 минПрактический маршрут

Что должно работать к началу настройки

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

Перед началом выясните адрес Open WebUI и место запуска сервера модели. Если приложение работает в контейнере, адрес сервиса с точки зрения контейнера может отличаться от адреса, который вы вводите в браузере. Эта разница особенно важна при подключении Ollama на компьютере рядом с контейнером.

Как выбрать подключение модели

Сначала пройдите урок первого входа: он объясняет создание администратора и базовые настройки доступа. Затем выберите инструкцию под свой источник модели. Для Ollama предусмотрен отдельный урок; для сервиса с OpenAI-совместимым интерфейсом — урок подключения API.

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

  • Создайте администратора и проверьте настройки регистрации.
  • Укажите адрес сервиса модели и необходимые параметры подключения.
  • Убедитесь, что нужная модель появилась в списке.
  • Отправьте простой запрос без рабочих или личных сведений.

Когда подключение можно считать рабочим

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

Раздел будет расширяться уроками о нескольких провайдерах, фоновых моделях и настройках интерфейса. Управление группами, единый вход и командные права выделены в отдельную часть полного плана. После первого успешного подключения разберитесь с обновлениями и сохранением данных.

Уроки раздела

Это опубликованные уроки раздела. Для установки выберите одну подходящую ветку; другие темы можно читать по своей задаче.

Вся программа курса
  1. 1Первый вход и базовые настройки доступаСоздаём администратора, разбираемся с регистрацией пользователей и не открываем сервис раньше времени.Практика10 мин
  2. 2Где меняются настройки и что сохраняется после перезапускаРазберём личные настройки, Admin и параметры запуска Open WebUI. Проверим сохранение UI Scale и объясним, почему новое значение env может не примениться.Практика10 мин
  3. 3Подключаем локальную модель через OllamaПодключим Ollama к Open WebUI в Windows, macOS и Ubuntu Linux: загрузим проверочную модель, укажем адрес сервера и разберём ошибки соединения.Практика14 мин
  4. 4Подключаем OpenAI-совместимый APIПодключим OpenRouter к Open WebUI: разберём адрес API, ключ и ID модели, проверим ответ в чате и найдём причины ошибок соединения.Практика11 мин
  5. 5Облачные модели: OpenAI, Anthropic, Gemini и OpenRouterРазберём прямые подключения OpenAI, Anthropic и Gemini и работу через OpenRouter. Поможем выбрать маршрут, подобрать ключ и проверить обычный чат.Практика12 мин
  6. 6Локальные серверы: LM Studio, llama.cpp и vLLMПодключим один локальный сервер модели к Open WebUI. Разберём LM Studio, llama.cpp и vLLM, адрес для контейнера, авторизацию и проверку ответа.Практика15 мин
  7. 7Несколько подключений и управление списком моделейРазберём, как различать источники моделей в Open WebUI, управлять несколькими подключениями и сохранять понятный список для работы.Практика13 мин
  8. 8Фоновые модели, заголовки и дополнительные расходыРазберём, какие задачи Open WebUI выполняет помимо ответа, как выбрать для них модель и отключить ненужную генерацию. Проверим настройки и источники расходов.Практика12 мин
  9. 9Подключение внешнего агента вместо обычной моделиПоможем подключить готового агента Hermes к Open WebUI, проверить ответ и разобраться, где выполняются его действия, хранятся данные и задаются права.Практика15 мин
  10. 10Личные и прямые подключения из браузераПоможем настроить прямое подключение Open WebUI из браузера, проверить список моделей и ответ, разобраться с CORS и сохранением API-ключа в v0.12.3.Практика15 мин