Перейти к содержанию

Обзор развертывания 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.

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

Развертывание приложения выполняется в несколько этапов:

  1. Подготовка системы: Обновление кэша пакетов apt, установка базовых зависимостей (git, python3, unzip, jq и др.) и создание пользователя mcbserver.

  2. Установка LinuxGSM: Загрузка скрипта linuxgsm.sh из официального репозитория и запуск процесса создания сервера под пользователем mcbserver.

  3. Развертывание Web-LGSM:

  4. Клонирование репозитория https://github.com/BlueSquare23/web-lgsm.git.

  5. Запуск установочного скрипта ./install.sh внутри директории приложения.

  6. Настройка сервиса: Создание и запуск системного юнита 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.

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

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

  1. Перейти в рабочую директорию пользователя: cd /home/mcbserver/web-lgsm

  2. Обновить репозиторий: git pull origin master

  3. Перезапустить сервис приложения: 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.

question_mark
Я могу вам чем-то помочь?
question_mark
ИИ Помощник ×