Обзор развертывания Web-LGSM на сервере¶
Предварительные требования¶
Для успешного развертывания приложения требуются следующие параметры системы:
-
Операционная система: Debian или Ubuntu.
-
Права доступа: Пользователь с правами
sudo(создается автоматически). -
Порты:
-
Внутренний порт приложения:
12357. -
Внешний порт (HTTPS):
443.
FQDN итоговой панели на домене hostkey.in¶
| Параметр | Значение | | Префикс | web-lgsm | | Домен | hostkey.in | | Полный шаблон | web-lgsm{Server_ID_from_Invapi}.hostkey.in |
Структура файлов и каталогов¶
Основные пути к файлам и директориям в системе:
-
/home/mcbserver/web-lgsm— рабочая директория приложения Web-LGSM. -
/etc/systemd/system/web-lgsm.service— конфигурационный файл системного сервиса. -
/root/nginx— директория управления контейнером Nginx и SSL. -
/data/nginx/user_conf.d— директория для пользовательских конфигураций Nginx.
Процесс установки приложения¶
Развертывание приложения выполняется в несколько этапов:
-
Подготовка системы: Обновление кэша пакетов
apt, установка базовых зависимостей (git,python3,unzip,jqи др.) и создание пользователяmcbserver. -
Установка LinuxGSM: Загрузка скрипта
linuxgsm.shиз официального репозитория и запуск процесса создания сервера под пользователемmcbserver. -
Развертывание Web-LGSM:
-
Клонирование репозитория
https://github.com/BlueSquare23/web-lgsm.git. -
Запуск установочного скрипта
./install.shвнутри директории приложения. -
Настройка сервиса: Создание и запуск системного юнита
systemdдля обеспечения работы бэкенда в фоновом режиме.
Права доступа и безопасность¶
-
Для выполнения операций создается пользователь
mcbserver, которому предоставлены права на выполнение команд черезsudoбез запроса пароля (NOPASSWD). -
Директория
/tmp/.ansible_tmpв домашней папке пользователя имеет ограниченный доступ (0700). -
Системные директории и файлы конфигурации имеют строгие права доступа для обеспечения безопасности.
Базы данных¶
В данной конфигурации внешняя база данных не используется; приложение использует локальные механизмы хранения данных, характерные для LinuxGSM.
Контейнеры Docker и их запуск¶
Для работы веб-интерфейса через защищенное соединение (SSL) используется контейнер:
| Имя образа | Порты | Тома (volumes) | Переменные окружения | Политика перезапуска |
|---|---|---|---|---|
jonasal/nginx-certbot:latest | host mode | nginx_secrets:/etc/letsencrypt, /data/nginx/user_conf.d:/etc/nginx/user_conf.d, /home:/home | CERTBOT_EMAIL=hkadm@hostkey.com | unless-stopped |
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняются следующие действия:
-
Установочный скрипт:
./install.shв директории приложения для завершения конфигурации Web-LGSM. -
Бэкенд-сервис: Запуск основного процесса через
python3 web-lgsm.py.
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо выполнить следующие действия:
-
Перейти в рабочую директорию пользователя:
cd /home/mcbserver/web-lgsm -
Обновить репозиторий:
git pull origin master -
Перезапустить сервис приложения:
sudo systemctl restart web-lgsm.service
Расположение конфигурационных файлов и данных¶
-
Конфигурация бэкенда:
/home/mcbserver/web-lgsm/web-lgsm.py. -
Конфигурация Nginx (прокси):
/data/nginx/user_conf.d. -
Данные пользователя:
/home/mcbserver/.
Доступные порты для подключения¶
-
443(HTTPS) — основной доступ к веб-панели через прокси-сервер. -
12357(HTTP) — локальный порт бэкенда приложения (доступен только внутри сервера).
Запуск, остановка приложения¶
Управление работой веб-интерфейса осуществляется через системный менеджер сервисов:
-
Запуск:
sudo systemctl start web-lgsm.service -
Остановка:
sudo systemctl stop web-lgsm.service -
Статус:
sudo systemctl status web-lgsm.service
Прокси серверы¶
Для обеспечения доступа к приложению по протоколу HTTPS используется контейнер nginx-certbot. Он выполняет обратного прокси (Reverse Proxy) и автоматически управляет SSL-сертификатами через Certbot. Конфигурация Nginx подтягивает настройки из директории /data/nginx/user_conf.d и направляет трафик на локальный порт приложения 12357.