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

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

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

Операционная система: Ubuntu (рекомендуется версия 22.04 с установленным ядром HWE).
Драйверы: Наличие графического процессора NVIDIA и установленных драйверов NVIDIA.
Порты:
8080 — внутренний порт приложения.
443 — внешний HTTPS порт.

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

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

Параметр	Значение
Префикс	`gemma31b`
Домен	`hostkey.in`
Полный шаблон	`gemma31b{Server_ID_from_Invapi}.hostkey.in`

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

Установка выполняется путем развертывания контейнеров Docker и настройки системных служб:

Обновление пакетов системы и установка ядра HWE.
Установка драйверов NVIDIA (при наличии оборудования).
Установка и запуск службы Ollama.
Загрузка языковой модели gemma4:31b через ollama pull.
Развертывание контейнера OpenWebUI.
Настройка прокси-сервера Nginx с автоматическим получением SSL-сертификатов через Certbot.

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

В системе развернуты следующие контейнеры:

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 (Certbot)¶

Имя образа: 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

Базы данных¶

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

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

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

Расположение конфигурационных файлов и данных¶

Конфигурация Nginx: /data/nginx/user_conf.d/
Данные OpenWebUI: open-webui (Docker volume)
Файлы compose: /root/nginx/compose.yml
Секреты SSL: nginx_secrets (Docker volume)

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

Порт	Назначение	Протокол
`443`	Внешний доступ к интерфейсу	HTTPS
`11434`	API Ollama (локально)	HTTP
`8080`	Внутренний порт приложения	HTTP

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

Управление прокси-сервером Nginx:

Перезагрузка конфигурации: docker exec nginx-nginx-1 nginx -s reload

Управление контейнерами (в директории /root/nginx):

Запуск: docker compose up -d
Остановка: docker compose down