Обзор развертывания OpenWebUI на сервере¶

Предварительные требования¶

Для корректной работы приложения требуются следующие параметры системы:

• Операционная система: Ubuntu (рекомендуется версия 22.04 с установленным HWE ядром).

• Драйверы: Наличие графического процессора NVIDIA и установленных драйверов (устанавливаются автоматически через ubuntu-drivers autoinstall).

• Доступ: Права суперпользователя (root) для установки системных пакетов, ядер и Docker.

• Сеть: Доступ к интернету для загрузки образов Docker, моделей LLM и сертификатов SSL.

FDQN итоговой панели на домене hostkey.in¶

Для доступа к интерфейсу используется автоматическая генерация поддомена по следующему шаблону:

Структура файлов и каталогов¶

Основные директории, используемые в системе:

• /root/nginx — рабочая директория для конфигурации Nginx и Docker Compose.

• /data/nginx/user_conf.d — директория с пользовательскими конфигурациями Nginx (включая настройки proxy_pass).

• /data/nginx/nginx-certbot.env — файл переменных окружения для Certbot.

Процесс установки приложения¶

Развертывание включает в себя следующие этапы:

1. Обновление системных пакетов и установка HWE ядра.

2. Установка драйверов NVIDIA (при наличии оборудования) и перезагрузка системы.

3. Установка и запуск сервиса Ollama.

4. Загрузка языковой модели gemma4:26b через команду ollama pull.

5. Развертывание контейнера OpenWebUI.

6. Настройка обратного прокси-сервера Nginx с автоматическим получением SSL-сертификатов через Certbot.

Контейнеры Docker и их запуск¶

В системе развернуты два основных компонента: один в режиме системного сервиса (Ollama) и один в контейнере (OpenWebUI), а также прокси-сервер в Docker Compose.

OpenWebUI¶

• Имя образа: ghcr.io/open-webui/open-webui:main

• Порты: Используется режим сети host.

• Тома (volumes): open-webui:/app/backend/data

• Переменные окружения:

  • OLLAMA_BASE_URL: http://127.0.0.1:11434

• Политика перезапуска: always

Nginx (через Docker Compose)¶

• Имя образа: jonasal/nginx-certbot:latest

• Порты: Используется режим сети host.

• Тома (volumes):

  • nginx_secrets:/etc/letsencrypt

  • /data/nginx/user_conf.d:/etc/nginx/user_conf.d

• Переменные окружения:

  • CERTBOT_EMAIL: hkadm@hostkey.com

• Политика перезапуска: unless-stopped

Базы данных¶

Приложение использует Ollama в качестве бэкенда для работы с моделями. Данные OpenWebUI хранятся во внутреннем Docker-томе open-webui.

Инструкция по обновлению приложения¶

Обновление выполняется через перезапуск контейнеров и обновление образов: docker compose pull && docker compose up -d (в директории /root/nginx).

Также возможен перезапуск конфигурации Nginx без остановки сервиса командой: docker exec nginx-nginx-1 nginx -s reload

Доступные порты для подключения¶