Змінні середовища
Повна довідка всіх змінних середовища.
Змінні сервера
| Змінна | За замовчуванням | Опис |
|---|---|---|
JAVA_XMS | 4G | Мінімальний розмір heap Java |
JAVA_XMX | 8G | Максимальний розмір heap Java |
BIND_PORT | 5520 | UDP порт сервера |
AUTO_DOWNLOAD | true | Автозавантаження при запуску |
SERVER_EXTRA_ARGS | - | Додаткові аргументи |
TZ | UTC | Часовий пояс контейнера |
Змінні панелі
| Змінна | За замовчуванням | Опис |
|---|---|---|
PANEL_USER | admin | Ім'я користувача |
PANEL_PASS | admin | Пароль |
PANEL_PORT | 3000 | HTTP порт сервера |
JWT_SECRET | (випадковий) | Секретний ключ для JWT |
MODTALE_API_KEY | - | API ключ для Modtale |
Змінні Docker
| Змінна | За замовчуванням | Опис |
|---|---|---|
CONTAINER_NAME | hytale-server | Назва контейнера сервера |
Детальні описи
JAVA_XMS / JAVA_XMX
Контролює виділення пам'яті JVM.
bash
# Мінімум 4GB, максимум 8GB
JAVA_XMS=4G
JAVA_XMX=8GРекомендації щодо RAM
| Гравці | Рекомендовано |
|---|---|
| 1-10 | 4G |
| 10-20 | 6G |
| 20-50 | 8G |
| 50+ | 12G+ |
AUTO_DOWNLOAD
Коли true, сервер автоматично завантажить HytaleServer.jar та Assets.zip при першому запуску.
bash
# Вимкнути для ARM64 або ручного налаштування
AUTO_DOWNLOAD=falseARM64
Автозавантаження недоступне на ARM64. Встановіть false та надайте файли вручну.
SERVER_EXTRA_ARGS
Передає додаткові аргументи виконуваному файлу сервера.
bash
# Увімкнути моди
SERVER_EXTRA_ARGS=--mods mods
# Кілька аргументів
SERVER_EXTRA_ARGS=--mods mods --debugTZ (Часовий пояс)
Встановлює часовий пояс контейнера для timestamps логів.
bash
TZ=Europe/Kyiv
TZ=Europe/Warsaw
TZ=Europe/BerlinJWT_SECRET
Секретний ключ для підпису JWT токенів. Якщо не вказано, генерується випадковий ключ при запуску.
bash
# Опціонально, але рекомендовано для постійних сесій
JWT_SECRET=ваш-дуже-довгий-випадковий-рядокINFO
Якщо не налаштовано, новий секрет генерується при кожному перезапуску панелі, що інвалідує всі існуючі сесії.
MODTALE_API_KEY
API ключ для інтеграції з репозиторієм модів Modtale.
bash
MODTALE_API_KEY=ваш-modtale-api-ключКоли налаштовано, вмикає:
- Перегляд модів у панелі
- Встановлення модів одним кліком
- Перевірку оновлень
Приклад файлу .env
bash
# ===================
# Налаштування сервера
# ===================
JAVA_XMS=4G
JAVA_XMX=8G
BIND_PORT=5520
AUTO_DOWNLOAD=true
SERVER_EXTRA_ARGS=--mods mods
TZ=Europe/Kyiv
# ===================
# Налаштування панелі
# ===================
PANEL_USER=myadmin
PANEL_PASS=супербезпечнийпароль123
PANEL_PORT=3000
JWT_SECRET=змініть-це-на-випадковий-рядок
# ===================
# Опціональні інтеграції
# ===================
MODTALE_API_KEY=ваш-api-ключ