Початок роботи

Вимоги

• Docker та Docker Compose встановлені
• 4ГБ+ RAM доступно на сервер
• Порт 3000/TCP відкритий (панель)
• Порт 5520+/UDP відкритий (ігрові сервери)

Встановлення

1. Створіть папку проекту

mkdir hytale && cd hytale

2. Завантажте файли конфігурації

curl -O https://raw.githubusercontent.com/ketbome/hytalepanel/main/docker-compose.yml
curl -O https://raw.githubusercontent.com/ketbome/hytalepanel/main/.env.example

3. Налаштуйте середовище

cp .env.example .env

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

# Авторизація панелі (ЗМІНІТЬ ЦЕ!)
PANEL_USER=admin
PANEL_PASS=ваш_безпечний_пароль
JWT_SECRET=випадковий-рядок

# Часовий пояс
TZ=Europe/Kiev

WARNING

Завжди змінюйте PANEL_USER та PANEL_PASS перед розгортанням!

4. Запустіть панель

docker compose up -d

5. Відкрийте панель

Відкрийте http://localhost:3000 у браузері.

Стандартні облікові дані:

• Користувач: admin
• Пароль: admin

Створення першого сервера

1. Увійдіть у панель
2. Натисніть "Створити сервер"
3. Введіть назву (наприклад, "Мій Hytale Сервер")
4. Налаштуйте RAM (рекомендовано: 4G мін, 8G макс)
5. Натисніть "Створити"
6. Натисніть "Увійти" для доступу до сервера
7. Перейдіть на вкладку Setup та натисніть "Завантажити файли"
8. Зачекайте завантаження (~2ГБ)
9. Перейдіть на вкладку Control та натисніть "СТАРТ"

Ваш сервер працює!

Налаштування кількох серверів

Ви можете створити кілька серверів, кожен з:

• Різними портами (5520, 5521, 5522, ...)
• Різним розподілом RAM
• Окремими налаштуваннями модів
• Незалежними даними світу

Призначення портів

Кожен сервер потребує унікальний UDP порт. Панель автоматично призначає порти починаючи з 5520.

Сервер	Порт
Сервер 1	5520/UDP
Сервер 2	5521/UDP
Сервер 3	5522/UDP

Переконайтеся, що ці порти відкриті у вашому фаєрволі.

Типові команди

# Переглянути логи панелі
docker compose logs -f

# Зупинити панель
docker compose down

# Оновити до останньої версії
docker compose pull && docker compose up -d

# Резервне копіювання всіх серверів
tar -czvf backup-$(date +%Y%m%d).tar.gz data/

Налаштування фаєрволу

Linux (UFW)

# Панель
ufw allow 3000/tcp

# Ігрові сервери (налаштуйте діапазон за потреби)
ufw allow 5520:5530/udp

Windows

# Панель
New-NetFirewallRule -DisplayName "Hytale Panel" -Direction Inbound -Protocol TCP -LocalPort 3000 -Action Allow

# Ігрові сервери
New-NetFirewallRule -DisplayName "Hytale Game" -Direction Inbound -Protocol UDP -LocalPort 5520-5530 -Action Allow

Підсумок портів

Сервіс	Порт	Протокол
Веб панель	3000	TCP
Сервер 1	5520	UDP
Сервер 2	5521	UDP
...	...	UDP

Наступні кроки

• Налаштування серверів
• Веб панель
• Встановлення модів
• Вирішення проблем