Open WebUI: установка с Ollama в Docker и на Windows, настройки, документы и API

Open WebUI — бесплатный веб-интерфейс для локальных нейросетей: выглядит и работает как привычный чат с ИИ, только модели крутятся на вашем компьютере или сервере через Ollama. Мы установили Open WebUI 0.11.4 в Docker, подключили его к Ollama, задали вопросы и загрузили документ, чтобы нейросеть отвечала по нему. Ниже — установка на Linux и Windows, связка с Ollama, настройки, которые стоит поменять сразу, работа с документами и API.

Open WebUI: чат с локальной нейросетью через Ollama
Open WebUI поверх Ollama — наш тестовый запуск

Что такое Open WebUI

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

Установка Open WebUI в Docker

Официальная документация рекомендует Docker. Если Ollama уже работает на этом же компьютере, команда такая:

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  -e WEBUI_SECRET_KEY=придумайте-длинный-ключ \
  --name open-webui --restart always \
  ghcr.io/open-webui/open-webui:main

Что здесь важно:

  • -p 3000:8080 — интерфейс откроется на http://localhost:3000;
  • --add-host=host.docker.internal:host-gateway — позволяет контейнеру достучаться до Ollama, запущенной на самом компьютере;
  • -v open-webui:/app/backend/data — чаты, пользователи и документы хранятся в томе Docker и переживают обновление;
  • WEBUI_SECRET_KEY — задайте один раз и не меняйте: по документации, без постоянного ключа все пользователи будут разлогинены при каждом пересоздании контейнера.

У нас контейнер стартовал примерно за 35 секунд. Проверка, что всё поднялось:

curl http://localhost:3000/api/version
{"version":"0.11.4","deployment_id":""}

Первый зарегистрированный пользователь становится администратором — зарегистрируйтесь сразу после запуска, пока адрес не увидел кто-то ещё. Если Docker для вас в новинку, начните со статьи Docker Compose для начинающих: у Open WebUI в документации есть и готовый docker-compose.yml.

Open WebUI на Windows

Есть два пути:

  • Docker Desktop — та же команда, что выше, в PowerShell (перенос строк \ замените на ` или запишите в одну строку);
  • Python без Docker: документация поддерживает Python 3.11 и 3.12, на 3.13 установка пока ломается. Установка и запуск:
pip install open-webui
open-webui serve

В этом варианте интерфейс откроется на http://localhost:8080. Ключ сессий Open WebUI запишет в файл .webui_secret_key в папке, откуда вы запускаете команду, — поэтому запускайте всегда из одной и той же папки, иначе придётся заново входить.

Open WebUI и Ollama

При установке командой выше Open WebUI сам находит Ollama и показывает все её модели в списке над строкой ввода. Если Ollama на другом компьютере или сервере, укажите её адрес переменной -e OLLAMA_BASE_URL=http://адрес:11434. На машине с Ollama для этого её нужно запустить с OLLAMA_HOST=0.0.0.0:11434 — и тогда обязательно закройте порт 11434 от интернета, у API Ollama нет пароля.

Наш тест — на сервере без видеокарты (4 ядра процессора), модель qwen3:1.7b. Вопрос «Объясни простыми словами, что такое DNS, в двух предложениях»:

Чат в Open WebUI с моделью qwen3 через Ollama
Ответ qwen3:1.7b в Open WebUI; рассуждение модели свёрнуто

Ответ правильный, а сверху свёрнут блок «Рассуждение заняло 22 секунд(ы)» — Open WebUI аккуратно прячет «мысли» моделей с режимом рассуждений.

Настройки Open WebUI, которые стоит поменять сразу

На слабом железе мы заметили странное: тот же вопрос через API Open WebUI занял 37 секунд, а в интерфейсе ответ появился почти через две минуты. Причина — фоновые задачи. После каждого сообщения Open WebUI просит ту же модель придумать название чата, теги и варианты продолжения. В журнале Ollama было видно, как модель обрабатывает промпт на 2 049 токенов уже после ответа. Пока идут эти задачи, следующий вопрос ждёт в очереди.

Отключить их можно в Настройки → Админ → Интерфейс, раздел «Генерация»: генерация заголовка, генерация продолжения, а ниже — теги. Там же можно выбрать отдельную маленькую «модель задачи», чтобы фоновую работу делала она, а не основная.

Настройки Open WebUI: модель задачи и генерация заголовков
Раздел «Интерфейс» в админке: модель для фоновых задач и переключатели генерации

Нейросеть по своим документам

Open WebUI умеет отвечать по загруженным файлам: документ разбивается на фрагменты, и к вопросу подмешиваются самые подходящие из них. Мы загрузили текст нашей политики конфиденциальности и спросили: «Сколько хранятся сообщения из формы и куда писать, чтобы удалить свои данные?» Ответ той же маленькой модели:

Сообщения из формы хранятся не более трёх лет [1], и для удаления данных нужно написать на support@letweb.ru [1].

Оба факта верные, и есть ссылка на источник [1] — по ней видно, из какого фрагмента взят ответ. В интерфейсе файл прикрепляется кнопкой «+» у строки ввода, а постоянные наборы документов создаются в разделе «Рабочее пространство». На процессоре такой ответ занял около полутора минут.

Open WebUI API

У Open WebUI есть API, совместимый с форматом OpenAI. Ключ создаётся в настройках аккаунта (если администратор разрешил API-ключи). Запрос, который мы выполняли:

curl http://localhost:3000/api/chat/completions \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{"model": "qwen3:1.7b", "stream": false,
       "messages": [{"role": "user", "content": "Объясни простыми словами, что такое DNS, в двух предложениях."}]}'

Ответ пришёл за 37 секунд, и в нём нашлась характерная ошибка маленькой модели — китайский иероглиф посреди русского текста: «Она как телефонный簿». Чем меньше модель, тем чаще такое бывает; для работы берите модель побольше, если позволяет память.

Open WebUI на сервере

Open WebUI удобно поставить на домашний сервер или VPS, чтобы открывать с телефона. Но наружу его выставляйте только через HTTPS и прокси — например, Nginx Proxy Manager с бесплатным сертификатом, — и не отключайте вход по паролю (переменная WEBUI_AUTH=False годится только для компьютера, к которому больше никто не имеет доступа). Для обновления скачайте свежий образ и пересоздайте контейнер той же командой с тем же WEBUI_SECRET_KEY — данные останутся в томе.

Если локальной модели не хватает, есть облачные API. Российский вариант с бесплатными токенами для физлиц — GigaChat.

Источники: быстрый старт Open WebUI, документация Open WebUI. Тест: Open WebUI 0.11.4, Ollama 0.34.4, qwen3:1.7b, процессор 4 ядра без видеокарты. Проверено 29 сентября 2026 года.

5 / 1
Оцените статью
Да будет Интернет!