Обзор развертывания Qwen на сервере¶
Предварительные требования¶
Для корректной работы приложения требуются следующие параметры системы:
-
Операционная система: Ubuntu (рекомендуется версия 22.04 LTS).
-
Права доступа: Права суперпользователя (
root) для установки драйверов и системных пакетов. -
Порты:
-
8080— внутренний порт приложения. -
443— внешний порт (HTTPS) через прокси-сервер.
FDQN итоговой панели на домене hostkey.in¶
Для доступа к интерфейсу используется следующий шаблон доменного имени:
| Параметр | Значение |
|---|---|
| Префикс | qwen |
| Домен | hostkey.in |
| Полный шаблон | qwen{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные директории, используемые в системе:
-
/root/nginx— конфигурационные файлы Docker Compose для прокси-сервера Nginx. -
/data/nginx/user_conf.d— пользовательские конфигурации Nginx. -
/etc/letsencrypt— сертификаты SSL (хранятся в томеnginx_secrets). -
/app/backend/data— данные приложения OpenWebUI (хранятся в томеopen-webui).
Процесс установки приложения¶
Развертывание включает следующие этапы:
-
Обновление системных пакетов и установка ядра HWE.
-
Установка драйверов NVIDIA (при наличии GPU) и утилиты
ubuntu-drivers. -
Установка и запуск сервиса Ollama через официальный скрипт установки.
-
Загрузка модели
qwen3.6-35bв Ollama. -
Развертывание контейнера 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
Базы данных¶
Приложение использует Ollama в качестве бэкенда для работы с моделями. Данные модели и конфигурации OpenWebUI хранятся в Docker-томах:
open-webui— данные приложения.
Инструкция по обновлению приложения¶
Обновление выполняется через перезапуск контейнеров или обновление пакетов. Для обновления прокси-сервера используется команда:
Для применения изменений в конфигурации Nginx без остановки сервиса:Доступные порты для подключения¶
| Порт | Назначение | Протокол |
|---|---|---|
443 | Внешний доступ к интерфейсу (HTTPS) | TCP |
8080 | Внутренний трафик приложения | TCP |
11434 | API Ollama | TCP |