Open WebUI

Обзор

Браузерный интерфейс для своих языковых моделей

Open WebUI даёт локальным моделям интерфейс чата с историей, файлами и базами знаний. Подходит для домашних заметок, черновиков и обычных AI-переписок на своём сервере. Заменяет сценарий облачного чата ChatGPT или Claude, но не включает их закрытые модели и не обещает такое же качество ответов.

Рецепт запускает официальный образ Open WebUI и отдельный внутренний Ollama на CPU. Облачный API-ключ не нужен. Модель скачивается отдельно: небольшой пример qwen3:0.6b подходит для проверки установки, а не для оценки сложных задач. Планируйте два ядра CPU, 4 ГБ RAM (рекомендуется 8 ГБ) и 10 ГБ диска до больших моделей, роста данных и резервных копий. Это ориентиры для планирования. Оба образа поддерживают amd64/arm64, но проверена только amd64.

Данные и безопасность

При первом запуске администратор создаётся из закрытой .env; общего начального пароля нет. Регистрация и внешние OpenAI-совместимые провайдеры изначально отключены. У Ollama нет порта на хосте, облачный режим выключен. Оба сервера работают от UID/GID 1000 с корневыми ФС только для чтения, записываемыми томами данных и временным хранилищем. Сохраняйте OPEN_WEBUI_SECRET при обновлении и восстановлении: он защищает сессии и зашифрованные настройки.

Обычные чаты с моделью, файлы и настройки хранятся на сервере; рецепт не делает их сквозно зашифрованными. Администраторские Functions и Tools могут выполнять код на сервере: давайте эту роль только доверенным людям. OIDC, MFA и вход по доверенным заголовкам есть upstream, но здесь не настроены. Не включайте вход по заголовкам за прокси, принимающим идентификационные заголовки от клиента. CVE образов не сканировались и остаются unknown.

Работающая страница ещё не доказывает работоспособность модели. Smoke amd64 выполняет настоящую локальную генерацию, сохраняет чат и файл, удаляет оба тома, восстанавливает их, сверяет байты файла и digest модели, затем генерирует ответ снова. Он не измеряет точность, GPU, большие модели, голос и RAG-поиск. Ответы модели могут быть неверными: проверяйте их перед использованием.

Лицензия и эксплуатация

Лицензия Open WebUI сочетает BSD-подобные условия с требованиями к брендингу, поэтому в каталоге указано source available. Порог 50 пользователей относится к разрешению менять брендинг; обычное использование с исходным брендингом не ограничено 50 пользователями. Рецепт сохраняет брендинг приложения. Ollama использует MIT, пример Qwen3 0.6B — Apache-2.0. У других моделей могут быть иные ограничения.

Одна резервная копия сохраняет оба тома и рабочую конфигурацию при остановленных процессах записи. Внутри SQLite, загрузки, локальные векторы/кеши, веса моделей и секреты. Сохранённые настройки UI могут перекрывать начальные переменные окружения; после восстановления проверяйте регистрацию, провайдеров и общий доступ. Читайте примечания к каждому обновлению; для отката возвращайте данные до обновления с соответствующими версиями.

Источники: документация Open WebUI, v0.12.4, лицензия, Ollama, Qwen3 0.6B. SVG-знак каталога взят из LobeHub Icons; брендинг работающего приложения не изменён.

Пошаговая инструкция

Требования и подготовка

Используйте 64-битную Ubuntu 22.04+ или Debian 12+ с Docker Engine и Compose v2.24+. Планируйте 2 ядра CPU, 4 ГБ RAM (рекомендуется 8 ГБ) и 10 ГБ диска плюс большие модели, данные пользователей и копии. Рецепт работает на CPU; GPU-устройства и Docker socket не монтируются.

mkdir -p ~/services/open-webui
cd ~/services/open-webui
# Скопируйте весь рецепт, скрипты и proxy/.
cp .env.example .env
chmod 600 .env
# Выполните дважды: секрет сервиса и независимый начальный пароль.
openssl rand -hex 32
openssl rand -hex 32

До запуска замените оба плейсхолдера. Все параметры .env.example:

Скрипты выполняют .env как доверенную shell-конфигурацию. Держите файл закрытым. Правка переменных первичного email/пароля не меняет существующий аккаунт. Часть настроек UI сохраняется в SQLite и может перекрывать начальные переменные окружения.

Запуск и вход

docker compose config --quiet
docker compose pull
docker compose up -d --wait --wait-timeout 600
curl --fail http://127.0.0.1:3080/health/db

Контейнер permissions завершится после назначения обоим томам UID/GID 1000; дальше оба сервера работают без root. Откройте OPEN_WEBUI_URL и войдите с заданными email и паролем администратора. С другого компьютера сначала используйте ssh -L 3080:127.0.0.1:3080 user@server и соответствующий локальный URL. Проверьте администратора и закрытую регистрацию до открытия прокси. Выберите язык и тему в личных настройках. Общего начального пароля нет.

Скачивание и проверка модели

У запущенного Ollama сначала нет модели для чата. Скачайте её осознанно: нужны интернет и место на диске.

docker compose exec ollama ollama pull qwen3:0.6b
docker compose exec ollama ollama list

Обновите список моделей в Open WebUI, выберите qwen3:0.6b и отправьте короткое сообщение. Пример скачивает около 522 МБ и дополнительно занимает RAM при работе; модель мала и может отвечать плохо. У неё Apache-2.0; перед загрузкой другой модели проверьте её лицензию. Тег может меняться upstream, но копия сохраняет скачанные веса. Большие контексты и модели требуют больше RAM и диска. Держите Ollama внутри сети стека. OFFLINE_MODE=true предотвращает загрузки моделей/обновлений самим Open WebUI; образ содержит начальный кеш embeddings, а явное скачивание моделей Ollama остаётся доступным. Внешние провайдеры, GPU, плагины, голос и веб-поиск не настроены.

VPS

Укажите внешний HTTPS OPEN_WEBUI_URL, настройте прокси и оставьте в firewall только SSH/HTTP/HTTPS. Порт 3080 держите на loopback, Ollama — без порта на хосте. Используйте сложный пароль администратора и зашифрованные внешние копии. Недорогой CPU VPS может отвечать медленно; подбирайте сервер под модель, а не под веб-страницу.

Доверенная локальная сеть

Для личного доступа используйте SSH-туннель, для LAN — HTTPS-прокси. Если намеренно меняете привязку на приватный IP, ограничьте порт firewall и оставьте аутентификацию включённой. OPEN_WEBUI_URL должен совпадать с origin браузера: несовпадение может сломать websocket/CORS. Не выставляйте Ollama в LAN как API без аутентификации.

Домен и HTTPS

Используйте один пример из proxy/: Caddy получает сертификат, Nginx требует путей сертификатов, Traefik — websecure и resolver letsencrypt. Примеры работают на хосте и направляют запросы в 127.0.0.1:3080. Контейнерному прокси нужны общая сеть и внутренний порт приложения 8080.

Задайте OPEN_WEBUI_URL=https://chat.example.com и реальный IP/CIDR прокси в OPEN_WEBUI_TRUSTED_PROXIES, затем выполните docker compose up -d --wait --wait-timeout 600. Прокси должен поддерживать websocket upgrades и долгие ответы генерации. Пример Nginx допускает запросы 100 МБ. Доверие forwarded-заголовкам отличается от входа по идентификационным заголовкам, который рецепт не включает. После изменений проверяйте сохранённые настройки UI.

Резервное копирование

./backup.sh

Скрипт останавливает оба процесса записи и сохраняет оба тома, .env и Compose в закрытый backups/open-webui-<timestamp>.tar с правами 600. Исходное состояние запуска/остановки каждого сервера сохраняется. Веса могут занимать много места, а копирование — прерывать текущие чаты. Шифруйте архив и переносите вне сервера: внутри переписки, файлы, модели, начальные реквизиты и секреты сервиса. Копия живого SQLite-файла и экспорт одного чата не заменяют полный архив.

Восстановление

Восстановление заменяет оба тома. Используйте доверенные архивы, соответствующие версии приложения/Ollama и исходный OPEN_WEBUI_SECRET. До восстановления сравните архивную configuration.env с рабочей .env: автоматически она не включается.

# На новом сервере сначала инициализируйте соответствующий рецепт.
docker compose up -d --wait --wait-timeout 600
./restore.sh ./backups/open-webui-TIMESTAMP.tar
curl --fail http://127.0.0.1:3080/health/db

Содержимое проверяется до замены, создаётся страховочная копия. Ошибка при замене файлов оставляет оба сервера остановленными. После восстановления войдите, откройте чат, скачайте файл и создайте новый ответ восстановленной моделью. Проверьте регистрацию, провайдеров и общий доступ. Smoke amd64 удаляет оба исходных тома и проверяет эти действия, включая digest модели и точные байты файла.

Обновление

Прочитайте примечания upstream и совместимость моделей. Сделайте копию, перенесите вне сервера и измените проверенный точный тег в .env:

docker compose pull
docker compose up -d --wait --wait-timeout 600
docker compose logs --tail=100 open-webui ollama

Миграции приложения выполняются при запуске. У Ollama отдельная версия: читайте её примечания перед изменением. Не меняйте секрет сервиса без необходимости. Не используйте latest, не предполагайте совместимость API 0.x и не убирайте брендинг вне исключений лицензии.

Откат

Не запускайте старое приложение на БД, мигрированной новой версией. Остановите оба сервера, укажите прежние точные теги и исходный секрет в .env, затем пересоздайте контейнеры без запуска:

docker compose stop open-webui ollama
# Измените обе проверенные версии и сохраните OPEN_WEBUI_SECRET.
docker compose pull open-webui ollama
docker compose create open-webui ollama
./restore.sh ./backups/open-webui-BEFORE-UPDATE.tar

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

Остановка и удаление

docker compose down сохраняет оба тома. После проверки внешней копии docker compose down --volumes безвозвратно удаляет аккаунты, чаты, файлы, веса и состояние Ollama. Удаление каталога рецепта удаляет также локальные копии и .env.

Источники: документация, переменные окружения, v0.12.4, Ollama, модель Qwen, лицензия.

Сообщить о проблеме с рецептом

Рассказать, как прошло на вашем сервере

Откроется предзаполненный issue на GitHub. Нужен аккаунт GitHub; после отправки сообщение будет публичным.

Диагностика

Ошибка запуска, прав или healthcheck

Выполните docker compose ps, docker compose logs --tail=100 open-webui ollama и docker compose config --quiet. Проверьте место, RAM, точные теги и завершение permissions. Healthcheck приложения использует /health/db, Ollama — ollama list. Оба тома должны быть доступны UID/GID 1000 для записи. Не отключайте вход и не включайте privileged ради обхода ошибки прав.

Нет моделей или ответа

Healthy-сервер Ollama ещё не означает скачанную модель. Выполните docker compose exec ollama ollama list, скачайте проверенный пример и обновите список Open WebUI. Проверьте локальный URL провайдера http://ollama:11434: это внутренний адрес, а не адрес браузера. OLLAMA_NO_CLOUD=true намеренно отключает облако. Большие модели, контексты и несколько запросов могут исчерпать RAM. Смотрите docker stats и логи; уменьшите модель/контекст либо увеличьте сервер.

Неверный пароль или политика регистрации

Начальные пароль/email применяются только к пустой БД пользователей. Существующий пароль меняйте в UI, а не в переменных первичного создания. Регистрация изначально закрыта, но сохранённые настройки UI могут перекрыть значения. Проверяйте настройки безопасности и провайдеров после обновления и восстановления. Рецепт не поставляет общих реквизитов входа.

CORS, websocket и ошибки прокси

OPEN_WEBUI_URL должен совпадать с точным origin браузера. Проверьте websocket upgrades и тайм-ауты. В OPEN_WEBUI_TRUSTED_PROXIES укажите реальный прокси, не *. Контейнерный прокси не достигнет loopback хоста через собственный 127.0.0.1. Не открывайте API Ollama ради исправления браузерного прокси.

После восстановления нет файлов, чатов или моделей

Восстанавливайте обе соответствующие части архива с исходным секретом и совпадающими версиями приложения/Ollama. Экспорт чата не включает загрузки, веса и настройки. Войдите снова, откройте чат, скачайте файл и проверьте генерацию. Сравните архивную конфигурацию вручную. На время разбирательства сохраните текущие тома и страховочную копию.

Источники: переменные окружения, документация, Ollama.