Начать

Типовые проблемы

Начинайте с логов:

cd /opt/game-panel
docker compose ps
docker compose logs --tail 100 master

На ноде: journalctl -u game-agent -n 100.

Установка

«port 80 (443, 4222) is already in use» — на сервере работает другой веб-сервер или NATS. Остановите его или, если понимаете последствия, передайте --skip-checks.

«домен не резолвится / указывает на другой адрес» — A/AAAA-запись ещё не указывает на этот сервер. За NAT или с 1:1 IP предупреждение ожидаемо — ответьте «да» или передайте --skip-checks.

«the archive's SHA-256 is …, expected …» — архив повреждён или команда от другого релиза. Скопируйте команду из раздела Загрузки заново.

Скачивание падает с 403/404 — ссылку перевыпустили или у аккаунта нет действующей лицензии. Проверьте Лицензии и скопируйте свежую команду.

«Master didn't become healthy» — смотрите docker compose logs master; чаще всего виноват сломанный docker-compose.override.yml или ручная правка .env.

Сертификат

Браузер предупреждает о сертификате — Let's Encrypt ещё не выпустил его. Смотрите docker compose logs certbot: обычно домен не указывает на сервер или закрыт порт 80. Попытки повторяются каждые 15 минут.

Вход

Потеряли ссылку мастера — sudo grep SETUP_TOKEN /opt/game-panel/.env, см. Первый вход.

«Слишком много попыток» — после неудачных входов e-mail и IP-адрес временно блокируются. Подождите и попробуйте снова.

Лицензия

На странице панели Система → Лицензия видна последняя ошибка продления:

  • Неизвестный ключ — ключ заменили; введите актуальный из раздела Лицензии.
  • Лицензия неактивна — подписка закончилась или лицензию отозвали; продлите её.
  • Нет свободных слотов установок — лицензия уже обслуживает столько панелей, сколько разрешено; освободите слот в разделе Установки или купите ещё один.
  • Домен уже занят другой установкой — удалите или отвяжите старую установку в разделе Установки.
  • Портал недоступен — панели нужен исходящий HTTPS до этого портала. По последнему файлу панель работает ещё до 7 дней.
  • Пробный период уже использован — он один на аккаунт; выберите тариф.

Ноды

Нода не появляется — нода должна открывать https://<домен панели> и порт 4222 панели. Токен одноразовый — выпустите новый. Проверьте лимит нод по лицензии.

Нода офлайн — systemctl status game-agent на ноде; проверьте время на ноде (с неверными часами сертификаты не проходят) и файрвол до порта 4222.

«Обновите агент» — агент ноды старее панели, см. Обновления.

Игровые серверы

«Создание серверов временно недоступно» — так клиенты видят исчерпанный лимит лицензии или заблокированную панель; администраторы видят причину в баннере.

Сервер не запускается — откройте консоль сервера и список задач в панели; проверьте, что на ноде хватает ресурсов и свободных портов.

Не помогло

Напишите в поддержку и приложите:

  • версию панели (видна в разделе Установки);
  • вывод docker compose ps и последние 200 строк docker compose logs master;
  • для ноды — journalctl -u game-agent -n 200.

Перед отправкой уберите из логов пароли и ключи.