toolkitbox

~/ / Статьи об ИИ / Локальные LLM на VPS / Open WebUI на VPS: запуск в Docker и подключение к Ollama

Open WebUI на VPS: запуск в Docker и подключение к Ollama

Окно чата в браузере — самый простой способ пользоваться моделью, которая работает на вашем собственном сервере. Open WebUI — один из таких интерфейсов, и в его документации показано, как запустить его в Docker и подключить к Ollama. Эта статья шаг за шагом следует официальному быстрому старту и руководствам по подключению и отмечает, где два руководства описывают подключение по-разному.

Опубликовано: · 4 мин чтения · Проверено по официальной документации Open WebUI: 2026-10-26. Команды, теги образов и настройки меняются от версии к версии, поэтому прежде чем что-либо запускать на сервере, сверьтесь с актуальными документами.

Сначала проверьте память

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

Попробовать: Local LLM Memory Estimator

Модель

Тег Ollama qwen3:8b, квантование Q4_K_M, размер загрузки 5.2 GB.

Оценка

Веса модели
4.84 GiB
Кэш KV
0.56 GiB
Запас
1.00 GiB
Итого
6.41 GiB (6.88 GB)
Наименьший распространённый объём памяти, в который помещается
8 GiB

Это оценка. Она не включает вычислительные буферы рантайма и предполагает, что у каждого слоя одинаковая форма KV. Измерьте реальный запуск, прежде чем выбирать тариф.

Данные о модели проверены 2026-10-26.

Источники: Ollama library · Конфигурация модели (config.json) · Ollama FAQ

Всё выполняется в вашем браузере. Ничего не загружается.

Запуск в Docker

Быстрый старт открывает Open WebUI по адресу http://localhost:3000 и запускает его одной командой docker run. Замените your-secret-key значением, которое вы сгенерируете сами, например командой, которую для этого приводит руководство.

ШагКоманда
Сгенерировать секретный ключopenssl rand -hex 32
Запустить Open WebUIdocker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main
Следить за логамиdocker logs -f open-webui
  • -p 3000:8080 сопоставляет порт 3000 хоста с портом 8080 контейнера.
  • Том open-webui хранит ваши чаты, пользователей и настройки. Согласно руководству, он сохраняется при обновлениях, и запускать контейнер без него не следует никогда.
  • WEBUI_SECRET_KEY: руководство советует задать его один раз и сохранить, потому что без фиксированного ключа при каждом пересоздании контейнера все пользователи выходят из системы, а новый ключ тоже завершает сеансы всех пользователей.
  • Теги образов: main — стандартный образ, cuda добавляет поддержку GPU от NVIDIA и требует --gpus all, а ollama включает Ollama в тот же контейнер.

Первая учётная запись — администратор

На первом экране предлагается создать учётную запись администратора. Согласно руководству, эта первая учётная запись и есть администратор: он управляет пользователями и всеми настройками экземпляра, а регистрация отключается сама, как только учётная запись администратора создана.

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

Подключение к Ollama: два способа в документации

Страницы Open WebUI, которые мы проверили, описывают подключение двумя разными способами. Пользуйтесь той страницей, которая соответствует вашей версии, и проверьте в разделе Настройки, Администрирование, Подключения, какой тип подключения предлагает ваша версия.

ПодключениеЧто сказано на странице
Протокол Ollama APIВ разделе Настройки > Администрирование > Подключения, Управление подключениями Ollama API. Страница указывает порт 11434 как типичный и говорит использовать http://host.docker.internal:11434, когда Open WebUI работает в Docker, а Ollama — на хосте.
Подключение типа OpenAIДобавьте подключение типа OpenAI с базовым URL http://localhost:11434/v1 и любым текстом в качестве ключа API. Страница сообщает, что Ollama не проверяет ключ, но поле не может быть пустым, и что подойдёт значение ollama.
  • Загруженные модели обнаруживаются автоматически и появляются в списке выбора моделей. Их можно ограничить списком через запятую.
  • Можно добавить несколько экземпляров Ollama. Страница сообщает, что запросы распределяются случайным выбором, идентификаторы моделей на всех экземплярах должны совпадать точно, а префикс вроде remote/ позволяет различать экземпляры с одинаковыми именами моделей.
  • Для медленной или недоступной конечной точки страница предлагает задать AIOHTTP_CLIENT_TIMEOUT_MODEL_LIST=3 (по умолчанию 10 секунд), чтобы переключение на другой экземпляр происходило быстрее.
  • Если подключение не удаётся, страница называет самой частой причиной неверную настройку сети и отсылает к своему руководству по устранению неполадок.

На страницах, которые мы проверили, не сказано, может ли контейнер обратиться к Ollama, который слушает только 127.0.0.1, и нет описания того, как расширить адрес Ollama. Согласно его FAQ, Ollama по умолчанию привязывается к 127.0.0.1. Наша рекомендация: не открывайте Ollama для всей сети без правила брандмауэра, которое ограничивает доступ адресами, которыми вы пользуетесь.

Обновление и удаление

ЗадачаКоманды из быстрого старта
Обновить вручнуюdocker rm -f open-webui, затем docker pull ghcr.io/open-webui/open-webui:main, затем та же команда docker run, что и раньше
Обновить с помощью Watchtowerdocker run --rm --volume /var/run/docker.sock:/var/run/docker.sock nickfedor/watchtower --run-once open-webui
Удалитьdocker rm -f open-webui, затем docker rmi ghcr.io/open-webui/open-webui:main, затем docker volume rm open-webui

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

Держите доступ закрытым

  • В быстром старте показан вариант с WEBUI_AUTH=False. Наша рекомендация, а не утверждение из документов: не используйте его на сервере, до которого может добраться кто угодно.
  • Перед тем как делиться адресом, поставьте перед портом 3000 HTTPS и правило брандмауэра и не включайте секретный ключ в то, что вы коммитите.
  • В быстром старте также показано, как направить Open WebUI на другой сервер с помощью OLLAMA_BASE_URL. Если вы так сделаете, считайте это соединение частью вашей закрытой сети.

Источники

Читайте дальше