Оригинал: https://timofei-ermolaev.ru/courses/open-webui/configure/
Раздел 3 из 7
# Настройка 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 мин]()