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

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

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

• Операционная система: Ubuntu.

• Права доступа: Права суперпользователя (root) для установки Docker и создания директорий.

• Доменное имя: Настроенный DNS для управления через SSL.

• Порты:

• 80/TCP — для проверки сертификатов Let's Encrypt.

• 443/TCP — для доступа к веб-панели (HTTPS).

• 12444/TCP — для работы демона через WebSocket (WSS).

• 8211/UDP — игровой порт Palworld.

• 25575/TCP — RCON порт.

FDQN итоговой панели на домене hostkey.in¶

Структура файлов и каталогов¶

Система использует следующие пути для хранения данных и конфигураций:

• /opt/proxy — корневая директория прокси-сервера (Nginx, Certbot).

• /opt/proxy/nginx/conf.d — файлы конфигурации Nginx.

• /opt/proxy/letsencrypt — сертификаты SSL.

• /opt/proxy/www — данные для проверки Let's Encrypt.

• /opt/mcsmanager-web-data — данные веб-панели MCSManager.

• /opt/mcsm/daemon/data — конфигурация и данные демона MCSManager.

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

Развертывание включает автоматическую настройку следующих компонентов:

1. Установка Docker и зависимостей.

2. Создание необходимых директорий на хосте.

3. Запуск контейнеров веб-панели и демона.

4. Получение SSL-сертификатов через Certbot.

5. Автоматическая инициализация администратора в панели MCSManager.

6. Регистрация локального демона в веб-панели через API.

7. Создание игрового экземпляра Palworld с использованием Docker-контейнера.

Контейнеры Docker и их запуск¶

Веб-панель управления (MCSManager Web)¶

• Имя образа: githubyumao/mcsmanager-web

• Порты: 23333:23333

• Тома: /opt/mcsmanager-web-data:/opt/mcsm/web/data

• Политика перезапуска: unless-stopped

Демон управления (MCSManager Daemon)¶

• Имя образа: ngc7331/mcsmanager-daemon:latest

• Порты: 24444:24444

• Тома:

• /opt/mcsm/daemon/data:/opt/mcsm/daemon/data

• /var/run/docker.sock:/var/run/docker.sock

• Политика перезапуска: unless-stopped

Прокси-сервер (Nginx)¶

• Имя образа: nginx:alpine

• Контейнер: palworld-proxy

• Режим сети: host

• Тома:

• /opt/proxy/nginx/conf.d:/etc/nginx/conf.d:ro

• /opt/proxy/letsencrypt:/etc/letsencrypt

• /opt/proxy/www:/var/www/certbot

• Политика перезапуска: unless-stopped

Сертификат (Certbot)¶

• Имя образа: certbot/certbot

• Контейнер: palworld-certbot

• Тома:

• /opt/proxy/letsencrypt:/etc/letsencrypt

• /opt/proxy/www:/var/www/certbot

Игровой сервер (Palworld Instance)¶

• Имя образа: kagurazakanya/palworld:latest

• Контейнер: palworld-{{ server_id }}

• Порты:

• 8211/UDP

• 25575/TCP

• Переменные окружения: | Переменная | Значение | | --- | --- | | PORT | 8211 | | PLAYERS | 16 | | MULTITHREADING | true | | SERVER_NAME | Palworld-{Server_ID} | | ADMIN_PASSWORD | {Пароль администратора} | | SERVER_PASSWORD | {Пароль сервера} |

Обновление приложения¶

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

docker compose -f /opt/proxy/docker-compose.yml pull && docker compose -f /opt/proxy/docker-compose.yml up -d

Доступные порты для подключения¶

Запуск, остановка приложения¶

Управление контейнерами осуществляется через Docker:

• Запуск всех сервисов прокси:

  docker compose -f /opt/proxy/docker-compose.yml up -d
  

• Остановка веб-панели и демона:

  docker stop mcsm-web mcsm-daemon
  

• Просмотр логов игрового сервера:

  docker logs palworld-server
  

Прокси серверы¶

Для обеспечения безопасности и работы SSL используется Nginx, настроенный на работу в режиме host.

• HTTP (порт 80): Используется исключительно для прохождения проверки ACME (Let's Encrypt) и перенаправления трафика на HTTPS.

• HTTPS Панель (порт 443): Проксирует запросы на локальный порт веб-панели 23333. Поддерживает HTTP/2.

• HTTPS Daemon (порт 12444): Обеспечивает защищенное WebSocket соединение (wss://) для связи панели с демоном, проксируя трафик на локальный порт 24444.