Змінні середовища

Повна довідка всіх змінних середовища.

Змінні сервера

Змінна	За замовчуванням	Опис
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
CURSEFORGE_API_KEY	-	API ключ для CurseForge
HOST_DATA_PATH	-	Шлях хоста для прямого доступу
DISABLE_AUTH	false	Вимкнути автентифікацію панелі
BASE_PATH	-	Префікс шляху URL (напр., /panel)

Змінні Docker

Змінна	За замовчуванням	Опис
CONTAINER_NAME	hytale-server	Назва контейнера сервера

Детальні описи

JAVA_XMS / JAVA_XMX

Контролює виділення пам'яті JVM.

# Мінімум 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 при першому запуску.

# Вимкнути для ARM64 або ручного налаштування
AUTO_DOWNLOAD=false

ARM64

Автозавантаження недоступне на ARM64. Встановіть false та надайте файли вручну.

SERVER_EXTRA_ARGS

Передає додаткові аргументи виконуваному файлу сервера.

# Увімкнути моди
SERVER_EXTRA_ARGS=--mods mods

# Кілька аргументів
SERVER_EXTRA_ARGS=--mods mods --debug

TZ (Часовий пояс)

Встановлює часовий пояс контейнера для timestamps логів.

TZ=Europe/Kyiv
TZ=Europe/Warsaw
TZ=Europe/Berlin

Повний список часових поясів

JWT_SECRET

Секретний ключ для підпису JWT токенів. Якщо не вказано, генерується випадковий ключ при запуску.

# Опціонально, але рекомендовано для постійних сесій
JWT_SECRET=ваш-дуже-довгий-випадковий-рядок

INFO

Якщо не налаштовано, новий секрет генерується при кожному перезапуску панелі, що інвалідує всі існуючі сесії.

MODTALE_API_KEY

API ключ для інтеграції з репозиторієм модів Modtale.

MODTALE_API_KEY=ваш-modtale-api-ключ

Коли налаштовано, вмикає:

• Перегляд модів у панелі
• Встановлення модів одним кліком
• Перевірку оновлень

CURSEFORGE_API_KEY

API ключ для інтеграції з репозиторієм модів CurseForge.

Важливо

API ключі CurseForge містять символи $, які інтерпретуються як змінні в shell/Docker. Оберніть ключ в одинарні лапки щоб уникнути проблем:

CURSEFORGE_API_KEY='$2a$10$ваш-ключ-тут'

Отримайте API ключ на console.curseforge.com.

Коли налаштовано, вмикає:

• Перегляд модів CurseForge у панелі
• Встановлення модів одним кліком з CurseForge
• Доступ до понад 2,600 модів Hytale

Обмеження поширення

Деякі моди CurseForge не дозволяють поширення через API. Ці моди показуватимуть попередження і повинні бути завантажені вручну з веб-сайту CurseForge.

HOST_DATA_PATH

Шлях у файловій системі хоста, де зберігатимуться дані панелі. Коли налаштовано, сервери використовують абсолютні bind mounts замість томів Docker.

HOST_DATA_PATH=/home/user/hytale-data

Коли налаштовано:

• Дані панелі зберігаються за вказаним шляхом хоста
• Нові сервери використовують абсолютні шляхи: /home/user/hytale-data/servers/{id}/server:/opt/hytale
• Файли доступні безпосередньо з хоста без використання панелі

Прямий доступ до файлів

Корисно, коли ви хочете редагувати файли сервера, завантажувати моди або керувати світами безпосередньо з файлової системи хоста замість веб-панелі.

DISABLE_AUTH

Повністю вимикає автентифікацію панелі. Використовуйте це, коли автентифікація здійснюється reverse proxy з SSO (Authentik, Authelia тощо).

DISABLE_AUTH=true

Безпека

Вмикайте це лише за правильно налаштованим reverse proxy з автентифікацією. Панель буде повністю доступна без входу.

Панель також підтримує заголовки HTTP Basic Auth. Якщо ваш SSO/reverse proxy додає заголовки Authorization: Basic ... з дійсними обліковими даними, панель прийме їх без окремого входу.

BASE_PATH

Префікс шляху URL для монтування панелі у власному розташуванні. Корисно при запуску кількох сервісів на одному домені.

BASE_PATH=/panel

Коли налаштовано:

• Панель доступна за адресою https://domain.com/panel/ замість кореня
• Всі маршрути API з префіксом: /panel/api/, /panel/auth/
• Шлях Socket.IO: /panel/socket.io

Reverse Proxy

Налаштуйте ваш reverse proxy (Nginx, Caddy, Traefik) для переадресації запитів з /panel/ до контейнера панелі.

Приклад файлу .env

# ===================
# Налаштування сервера
# ===================
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=ваш-modtale-api-ключ
CURSEFORGE_API_KEY='$2a$10$ваш-curseforge-ключ'

# ===================
# Зберігання даних
# ===================
# Розкоментуйте для зберігання даних на хості замість тому Docker
# HOST_DATA_PATH=/home/user/hytale-data