Обзор развертывания MCSManager на сервере¶
Предварительные требования¶
Для успешного развертывания приложения необходимо обеспечить выполнение следующих условий:
-
Операционная система: Ubuntu.
-
Права доступа: Права суперпользователя (root) для выполнения установочных скриптов и управления Docker.
-
Доступ в интернет: Необходим для загрузки пакетов, установщика и образов Docker.
FDQN итоговой панели на домене hostkey.in¶
Для работы веб-интерфейса используется следующий шаблон доменного имени:
| Параметр | Значение |
|---|---|
| Префикс | minecraft |
| Домен | hostkey.in |
| Полный шаблон | minecraft{Server_ID}.hostkey.in |
Процесс установки приложения¶
Процесс развертывания включает в себя несколько этапов:
-
Подготовка системы: Обновление списков пакетов через
apt update. -
Установка основного ПО: Загрузка и запуск установочного скрипта по адресу
https://script.mcsmanager.com/setup_cn.shс помощью оболочки/bin/bash. Скрипт выполняет автоматическую установку компонентов MCSManager. -
Настройка проксирования:
-
Создание директории
/root/nginx. -
Генерация конфигурационного файла Nginx на основе параметров сервера.
-
Развертывание контейнера для управления SSL-сертификатами через Docker Compose.
Контейнеры Docker и их запуск¶
Для обеспечения работы веб-интерфейса по защищенному протоколу HTTPS используется следующий контейнер:
| Параметр | Значение |
|---|---|
| Имя образа | jonasal/nginx-certbot:latest |
| Режим сети | host |
| Политика перезапуска | unless-stopped |
| Переменная окружения | CERTBOT_EMAIL=hkadm@hostkey.com |
Тома (Volumes):
-
nginx_secrets:/etc/letsencrypt— для хранения SSL-сертификатов. -
/data/nginx/user_conf.d:/etc/nginx/user_conf.d— для пользовательских конфигураций Nginx.
Кастомные скрипты и дополнительные настройки¶
В процессе развертывания выполняются следующие действия:
-
Установка зависимостей: Использование внешнего установочного скрипта
setup_cn.shдля автоматизации установки MCSManager. -
Конфигурация Nginx: Создание файла
/data/nginx/user_conf.d/minecraft{Server_ID}.hostkey.in.conf, который настраивает проксирование трафика (включая WebSocket) с внешних портов на внутренние порты приложения.
Инструкция по обновлению приложения¶
Для обновления основного приложения необходимо выполнить перезапуск контейнера управления прокси-сервером:
Расположение конфигурационных файлов и данных¶
Основные файлы и директории системы:
-
/root/setup_cn.sh— установочный скрипт. -
/root/nginx/compose.yml— файл конфигурации Docker Compose для прокси-сервера. -
/data/nginx/user_conf.d/— директория с конфигурациями Nginx. -
/etc/letsencrypt/— (внутри контейнера) хранилище SSL-сертификатов.
Доступные порты для подключения¶
Приложение использует следующие порты:
| Назначение | Внешний порт | Внутренний порт | Протокол |
|---|---|---|---|
| Веб-панель (основной) | 12333 | 23333 | HTTPS/Websocket |
| Веб-панель (daemon) | 12444 | 24444 | HTTPS/Websocket |
Запуск, остановка приложения¶
Управление прокси-сервером осуществляется через Docker Compose в директории /root/nginx:
-
Запуск:
-
Остановка: