Веб панель

Веб панель надає повний інтерфейс для керування кількома серверами Hytale з єдиної панелі.

Мульти-серверна панель

Головна панель відображає всі ваші сервери з їх поточним статусом.

Картки серверів

Кожен сервер показує:

• Назва - Власна назва сервера
• Статус - Онлайн (зелений) або Офлайн (червоний)
• Дії:
  • Увійти - Доступ до керування сервером
  • Видалити - Видалити сервер та дані

Створення сервера

1. Натисніть кнопку "Створити сервер"
2. Заповніть конфігурацію:
   • Назва сервера - Зрозуміла назва
   • Порт - UDP порт (призначається автоматично)
   • Мін RAM / Макс RAM - Розмір Java heap (наприклад, 4G, 8G)
   • Linux Native - Увімкнути для Linux, вимкнути для CasaOS/Windows
3. Натисніть "Створити"

Сервер створюється з власним:

• Docker контейнером
• Директорією даних
• Файлами конфігурації

Керування сервером

Після входу до сервера доступні кілька вкладок:

Консоль

• Логи сервера в реальному часі через WebSocket
• Кольорове виведення для різних рівнів логів
• Авто-прокрутка з можливістю паузи
• Введення команд для відправки на сервер

TIP

Команди вимкнені коли сервер офлайн.

Вкладка Setup

Керування завантаженням файлів гри та автентифікацією:

• Статус завантаження - Показує наявність файлів гри
• Кнопка завантаження - Завантажує HytaleServer.jar та Assets.zip (~2ГБ)
• Автентифікація - OAuth потік для автентифікації Hytale

Вкладка Files

Повний файловий менеджер для директорії даних сервера:

• Перегляд - Навігація папками
• Завантаження - Drag & drop або клік для завантаження файлів (макс 500МБ)
• Редагування - Вбудований текстовий редактор для конфігів
• Видалення - Видалення файлів та папок
• Скачування - Завантаження файлів як .tar

WARNING

Операції з файлами вимагають працюючого сервера.

Вкладка Mods

Керування модами сервера з інтеграцією Modtale:

• Огляд - Пошук у каталозі Modtale
• Встановлення - Встановлення модів одним кліком
• Локальні - Перегляд встановлених модів
• Увімкнути/Вимкнути - Перемикання модів без видалення
• Оновлення - Перевірка оновлень модів

Вимагає змінну середовища MODTALE_API_KEY.

Вкладка Commands

Довідка та кнопки для типових команд:

/help              - Показати всі команди
/list              - Список підключених гравців
/auth login device - Почати OAuth автентифікацію
/auth status       - Перевірити статус auth
/stop              - Зупинити сервер

Вкладка Control

Керування життєвим циклом сервера:

Кнопка	Дія
СТАРТ	Запустити контейнер сервера
РЕСТАРТ	Перезапустити сервер
СТОП	Коректно зупинити сервер
ОЧИСТИТИ ДАНІ	Видалити всі дані сервера (потребує підтвердження)

Вкладка Config

Редагування конфігурації сервера без YAML файлів:

Налаштування	Опис
Порт	UDP порт гри (1024-65535)
Мін RAM	Мінімальний Java heap (наприклад, 2G, 4G)
Макс RAM	Максимальний Java heap (наприклад, 4G, 8G)
Адреса прив'язки	Мережевий інтерфейс (за замовчуванням: 0.0.0.0)
Додаткові аргументи	Додаткові аргументи (наприклад, --world-seed 123)
Авто-завантаження	Увімкнути автоматичне завантаження файлів
G1GC	Використовувати збирач сміття G1 (рекомендовано)
Linux Native	Монтувати machine-id томи (тільки Linux)

WARNING

Конфігурацію можна редагувати тільки коли сервер зупинений. Перезапустіть сервер для застосування змін.

Автентифікація

Панель використовує JWT (JSON Web Tokens) для автентифікації.

• Токени закінчуються через 24 години
• Зберігаються в localStorage браузера

Зміна облікових даних

Відредагуйте файл .env:

PANEL_USER=ваш_користувач
PANEL_PASS=ваш_безпечний_пароль

Потім перезапустіть панель:

docker compose restart

Підтримка мов

Панель підтримує кілька мов:

• 🇺🇸 Англійська
• 🇪🇸 Іспанська
• 🇺🇦 Українська

Мова визначається автоматично з налаштувань браузера.

Структура даних

Дані кожного сервера зберігаються незалежно:

data/panel/
├── servers.json          # Реєстр та конфігурації серверів
└── servers/
    └── {server-id}/
        ├── docker-compose.yml  # Авто-генерований
        └── server/
            ├── HytaleServer.jar
            ├── Assets.zip
            ├── universe/       # Дані світу
            ├── mods/           # Моди сервера
            └── logs/           # Логи сервера

Гарячі клавіші

Клавіша	Дія
Enter	Відправити команду
↑ / ↓	Навігація історією команд

Безпека

DANGER

Ніколи не відкривайте панель в інтернет без заходів безпеки:

1. Використовуйте reverse proxy (nginx, Traefik) з HTTPS
2. Налаштуйте правила фаєрволу
3. Використовуйте сильні паролі
4. Розгляньте VPN для віддаленого доступу

Приклад: Nginx Reverse Proxy

server {
    listen 443 ssl;
    server_name hytale.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
    }
}

Вирішення проблем

"No space left on device" на Windows/Docker Desktop

Це відома помилка Docker Desktop. Рішення:

1. Виконайте wsl --shutdown в PowerShell
2. Перезапустіть Docker Desktop
3. Спробуйте знову

Сервер не запускається

Перевірте логи сервера на помилки. Типові проблеми:

• Порт вже використовується - змініть порт у вкладці Config
• Відсутні файли гри - використайте вкладку Setup для завантаження
• Недостатньо RAM - збільште Макс RAM у вкладці Config

Вкладка Files порожня

Вкладка Files вимагає працюючого сервера. Спочатку запустіть сервер.