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

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

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

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

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

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

Основные файлы конфигурации и данные расположены по следующим путям:

/root/nginx/compose.yml — файл конфигурации Docker Compose для прокси-сервера.
/data/nginx/user_conf.d/ — директория с конфигурационными файлами Nginx.
/data/nginx/nginx-certbot.env — файл переменных окружения для Certbot.

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

Конфигурационные файлы в /root/nginx/ имеют владельца root и права доступа 0644.
Директория /root/nginx имеет права 0755.
Приложение работает в изолированном контейнере Docker.

В данной конфигурации база данных не используется; данные приложения хранятся в именованном томе Docker.

Имя образа: jonasal/nginx-certbot:latest
Порты: Используется режим сети host.
Тома (volumes):
- nginx_secrets:/etc/letsencrypt
- /data/nginx/user_conf.d:/etc/nginx/user_conf.d
Политика перезапуска: unless-stopped

Обновление выполняется через pull и перезапуск контейнеров. Для обновления прокси-сервера используется команда:

docker compose up -d

Для применения изменений в конфигурации Nginx без остановки сервиса:

docker exec nginx-nginx-1 nginx -s reload

Директория /root/nginx принадлежит пользователю root и группе root.

Данные OpenWebUI: Хранятся в Docker volume open-webui.
Конфигурация Nginx: Файлы управления находятся в /data/nginx/user_conf.d/.