Ошибка при запуске сервера Minecraft.

Что делать, если при запуске пишет:

[Pterodactyl Daemon]: Checking server disk space usage, this could take a few seconds...
[Pterodactyl Daemon]: Updating process configuration files...
[Pterodactyl Daemon]: Ensuring file permissions are set correctly, this could take a few seconds...
container@pterodactyl~ Server marked as starting...
[Pterodactyl Daemon]: Pulling Docker container image, this could take a few minutes to complete...
[Pterodactyl Daemon]: Finished pulling Docker container image
container@pterodactyl~ Server marked as offline...
container@pterodactyl~ Error Event [d4af1e72-5b5f-4d20-97f7-d47c85d83538]: an unexpected error was encountered while handling this request
[Pterodactyl Daemon]: ---------- Detected server process in a crashed state! ----------
[Pterodactyl Daemon]: Exit code: 128
[Pterodactyl Daemon]: Out of memory: false

Эта ошибка указывает на то, что ваш сервер Minecraft, управляемый через Pterodactyl, не может запуститься из-за проблем с Docker и, возможно, нехватки ресурсов. Давайте разберем, что происходит и как это исправить.

Что означает ошибка:

• [Pterodactyl Daemon]: Checking server disk space usage..., [Pterodactyl Daemon]: Updating process configuration files..., [Pterodactyl Daemon]: Ensuring file permissions are set correctly...: Эти сообщения показывают, что Pterodactyl выполняет стандартные проверки перед запуском сервера. Это нормальные этапы.
• container@pterodactyl~ Server marked as starting...: Pterodactyl пытается запустить ваш сервер.
• [Pterodactyl Daemon]: Pulling Docker container image..., [Pterodactyl Daemon]: Finished pulling Docker container image: Pterodactyl скачивает образ Docker, который используется для запуска вашего сервера Minecraft. Это тоже нормальный процесс.
• container@pterodactyl~ Server marked as offline...: Сервер был помечен как оффлайн, что означает, что он не смог успешно запуститься.
• container@pterodactyl~ Error Event [d4af1e72-5b5f-4d20-97f7-d47c85d83538]: an unexpected error was encountered while handling this request: Это общее сообщение об ошибке, которое указывает на то, что что-то пошло не так на стороне Pterodactyl при попытке обработки запроса на запуск сервера.
• [Pterodactyl Daemon]: ---------- Detected server process in a crashed state! ----------: Это ключевое сообщение. Оно означает, что процесс сервера Minecraft внутри Docker-контейнера завершился с ошибкой.
• [Pterodactyl Daemon]: Exit code: 128: Код выхода 128 часто указывает на проблемы с доступом к файлам, правами доступа или поврежденными файлами.
• [Pterodactyl Daemon]: Out of memory: false: Это означает, что система не обнаружила явной нехватки оперативной памяти как основной причины сбоя. Однако, это не исключает проблем с выделением памяти для самого сервера Minecraft.

Что делать, чтобы исправить ошибку:

Вот пошаговый план действий, который поможет вам диагностировать и устранить проблему:

1. Проверьте логи сервера Minecraft:

Это самый важный шаг. Pterodactyl запускает сервер Minecraft внутри Docker-контейнера. Если сам сервер Minecraft не может запуститься, он должен выдать более конкретную ошибку в своих собственных логах.

• Найдите логи сервера: В панели управления Pterodactyl перейдите к вашему серверу. Обычно есть раздел "Logs" или "Консоль". Ищите там сообщения, которые появились после того, как Pterodactyl попытался запустить сервер.
• Что искать в логах Minecraft:
  • Ошибки, связанные с загрузкой мира (world loading errors).
  • Ошибки, связанные с плагинами или модами (plugin/mod errors).
  • Ошибки, связанные с Java (Java errors).
  • Сообщения о нехватке памяти, даже если Pterodactyl говорит Out of memory: false. Иногда сам Java-процесс может испытывать проблемы с выделением памяти.

2. Проверьте конфигурацию сервера Minecraft:

Неправильные настройки в файлах конфигурации сервера Minecraft могут привести к сбою при запуске.

• server.properties: Убедитесь, что все параметры в этом файле корректны. Особое внимание уделите:
  • level-name: Название мира. Убедитесь, что папка с миром существует.
  • server-port: Порт сервера. Убедитесь, что он не занят другим процессом и правильно прописан в настройках Pterodactyl.
  • online-mode: Если вы используете пиратские клиенты, установите в false. Если лицензионные, то true.
  • max-players: Убедитесь, что значение не слишком высокое для доступных ресурсов.
• eula.txt: Убедитесь, что вы приняли лицензионное соглашение, установив eula=true.

3. Проверьте выделенную память для сервера:

Хотя Pterodactyl указывает Out of memory: false, это может быть не совсем точным. Сервер Minecraft, особенно с модами или большим количеством игроков, требует значительного объема оперативной памяти.

• Настройки Pterodactyl: В панели управления Pterodactyl для вашего сервера есть настройки, где вы можете указать максимальный объем оперативной памяти (RAM) и объем свопа (Swap).
  • Убедитесь, что выделенный объем RAM достаточен для вашей версии Minecraft и количества модов/плагинов. Для ванильного сервера обычно достаточно 2-4 ГБ. Для серверов с модами может потребоваться 6-8 ГБ и более.
  • Убедитесь, что на самом хосте (сервере, где запущен Pterodactyl) достаточно свободной оперативной памяти. Если хост перегружен, Docker может не иметь возможности выделить необходимый объем памяти для контейнера.
• Проверьте ресурсы хоста: Подключитесь к вашему серверу по SSH и выполните команду free -h для проверки использования оперативной памяти.

4. Проверьте права доступа к файлам:

Ошибка с кодом выхода 128 часто связана с проблемами прав доступа к файлам или папкам сервера.

• Права Docker: Docker-контейнеры работают от имени определенного пользователя. Убедитесь, что пользователь, от имени которого запускается Docker-контейнер, имеет права на чтение и запись в директории сервера.
• Права Pterodactyl: Pterodactyl Daemon также должен иметь соответствующие права для управления файлами сервера.
• Переустановка прав: В панели Pterodactyl для вашего сервера может быть опция "Fix Permissions" или "Repair Permissions". Попробуйте использовать ее. Если такой опции нет, вам, возможно, придется вручную настроить права через SSH, используя команду chown и chmod. Обычно файлы сервера должны принадлежать пользователю, от имени которого запускается Docker.

5. Проверьте целостность файлов сервера:

Поврежденные файлы сервера Minecraft или его компонентов могут вызывать сбои.

• Перезагрузка файлов сервера: Если вы недавно обновляли сервер, добавляли моды или плагины, попробуйте откатить изменения или перекачать файлы сервера заново.
• Проверка JAR-файла: Убедитесь, что JAR-файл сервера (например, server.jar или paper.jar) не поврежден. Попробуйте скачать его заново с официального источника.

6. Проверьте версию Java:

Сервер Minecraft требует определенной версии Java.

• Совместимость: Убедитесь, что версия Java, используемая Docker-образом, совместима с вашей версией Minecraft. Например, для Minecraft 1.17 и выше требуется Java 16 или новее. Для более старых версий может подойти Java 8.
• Docker-образ: Если вы используете собственный Docker-образ, убедитесь, что в нем установлена правильная версия Java.

7. Проверьте настройки сети и портов:

Хотя это менее вероятно, проблемы с сетью или портами могут иногда вызывать странные ошибки.

• Порт сервера: Убедитесь, что порт, указанный в server.properties и в настройках Pterodactyl, свободен и доступен извне.
• Брандмауэр: Проверьте, не блокирует ли брандмауэр на хосте или в сети доступ к порту сервера.

8. Перезапустите Pterodactyl Daemon и Docker:

Иногда простые перезапуски служб могут решить временные проблемы.

• Перезапуск Daemon: Через SSH на сервере, где установлен Pterodactyl Daemon, выполните команду:

  sudo systemctl restart wings

  (Название службы может отличаться, проверьте документацию Pterodactyl для вашей установки).

• Перезапуск Docker:

  sudo systemctl restart docker

9. Проверьте дисковое пространство на хосте:

Хотя Pterodactyl проверяет дисковое пространство, иногда могут быть нюансы.

• Свободное место: Убедитесь, что на диске, где хранятся файлы сервера и Docker-образы, достаточно свободного места. Выполните команду df -h через SSH.

10. Изучите логи Docker:

Если проблема связана с самим Docker, его логи могут дать подсказку.

• Логи Docker: Попробуйте посмотреть логи Docker-сервиса:

  sudo journalctl -u docker.service

11. Проверьте конфигурацию Docker-образа:

Если вы используете кастомный Docker-образ, убедитесь, что он правильно настроен.

• Dockerfile: Проверьте Dockerfile, который использовался для сборки образа. Убедитесь, что все команды выполняются корректно и нет ошибок при установке зависимостей.

12. Обратитесь за помощью к сообществу Pterodactyl:

Если вы испробовали все вышеперечисленное и проблема не решена, возможно, стоит обратиться за помощью к сообществу Pterodactyl.

• Discord-сервер Pterodactyl: У Pterodactyl есть активный Discord-сервер, где вы можете задать свой вопрос и получить помощь от опытных пользователей и разработчиков. Обязательно предоставьте им полные логи и описание вашей проблемы.

Ключевые моменты для диагностики:

• Логи сервера Minecraft: Это ваш главный источник информации. Всегда начинайте с них.
• Выделенные ресурсы: Убедитесь, что серверу выделено достаточно RAM и CPU.
• Права доступа: Ошибки с кодом 128 часто связаны с правами.

Начните с самого простого – проверки логов сервера Minecraft. Если там нет ничего полезного, переходите к другим шагам. Удачи в решении проблемы!

13. Проверьте переменные окружения (Environment Variables):

В Pterodactyl для каждого сервера можно настроить переменные окружения. Убедитесь, что все необходимые переменные установлены правильно и соответствуют требованиям вашего сервера Minecraft (например, SERVER_JARFILE, MINECRAFT_VERSION, MEMORY и т.д.). Неправильные или отсутствующие переменные могут привести к тому, что скрипт запуска сервера не сможет найти нужный JAR-файл или выделить память.

14. Отключите плагины/моды (для диагностики):

Если ваш сервер использует плагины (Spigot/Paper/Purpur) или моды (Forge/Fabric), попробуйте временно удалить их все или переместить в отдельную папку, чтобы запустить чистый ванильный сервер. Если чистый сервер запускается успешно, это указывает на проблему с одним из плагинов или модов. Затем вы можете добавлять их по одному, чтобы выявить виновника.

15. Проверьте скрипт запуска (Startup Command):

В Pterodactyl есть раздел "Startup" (Запуск), где вы можете настроить команду, которая используется для запуска вашего сервера Minecraft.

• Проверьте синтаксис: Убедитесь, что команда запуска корректна. Например, она должна указывать на правильный JAR-файл (java -Xms128M -Xmx{{SERVER_MEMORY}}M -jar {{SERVER_JARFILE}} nogui).
• Переменные Pterodactyl: Убедитесь, что все переменные Pterodactyl (например, {{SERVER_MEMORY}}, {{SERVER_JARFILE}}) правильно используются и разрешаются в корректные значения.
• Путь к Java: Убедитесь, что путь к исполняемому файлу Java (java) корректен в контексте Docker-образа.

16. Попробуйте другой Docker-образ:

Если вы используете стандартный Docker-образ Pterodactyl для Minecraft, попробуйте переключиться на другой, если доступно. Иногда проблемы могут быть связаны с конкретным образом. Если вы используете кастомный образ, попробуйте использовать официальный или хорошо зарекомендовавший себя образ для Minecraft, чтобы исключить проблемы с вашим образом.

17. Проверьте целостность файловой системы хоста:

Хотя это редкость, повреждения файловой системы на самом хосте, где запущен Pterodactyl и Docker, могут вызывать странные ошибки.

• Проверка диска: Если у вас есть доступ к хосту, вы можете выполнить проверку диска (например, fsck для Linux), но это требует остановки сервера и может быть рискованно, если вы не знаете, что делаете.

18. Обновите Pterodactyl Daemon (Wings):

Убедитесь, что ваш Pterodactyl Daemon (Wings) на хосте обновлен до последней стабильной версии. Иногда ошибки могут быть исправлены в новых версиях.

19. Проверьте настройки безопасности (SELinux/AppArmor):

На некоторых Linux-системах SELinux или AppArmor могут ограничивать действия Docker-контейнеров. Убедитесь, что они не блокируют необходимые операции. Обычно для Pterodactyl и Docker эти настройки уже учтены, но в случае кастомных конфигураций это может быть источником проблемы.

20. Временное отключение антивируса/брандмауэра (только для диагностики на хосте):

Если Pterodactyl установлен на вашей локальной машине или на сервере с активным антивирусом/брандмауэром, временно отключите их для диагностики. Это поможет исключить их как причину блокировки Docker или Java-процесса. Не делайте этого на продакшн-сервере без понимания рисков.

Резюме по подходу:

1. Начните с логов Minecraft. Это самый прямой путь к пониманию, почему сервер не запускается.
2. Проверьте ресурсы. Убедитесь, что серверу выделено достаточно RAM.
3. Проверьте конфигурацию. server.properties, eula.txt, скрипт запуска.
4. Изолируйте проблему. Если есть моды/плагины, попробуйте запустить без них.
5. Системные проблемы. Если ничего не помогает, углубитесь в логи Docker и системные ресурсы хоста.

Помните, что код выхода 128 часто указывает на проблемы с доступом к файлам или их повреждение. Поэтому уделяйте особое внимание проверке прав доступа и целостности файлов сервера.

Если вы предоставите более подробные логи из консоли сервера Minecraft (не только логи Pterodactyl Daemon), это может значительно ускорить диагностику.

21. Проверьте наличие и корректность файла server.jar (или другого исполняемого JAR-файла):

• Убедитесь, что в корневой директории вашего сервера Minecraft (той, которую Pterodactyl использует для запуска) присутствует файл server.jar (или paper.jar, forge.jar и т.д., в зависимости от типа вашего сервера).
• Проверьте, что имя этого файла точно совпадает с тем, что указано в команде запуска сервера в настройках Pterodactyl (раздел "Startup" -> "Server Jar File"). Регистр букв имеет значение!
• Если файл отсутствует или поврежден, скачайте его заново с официального источника (например, minecraft.net для ванильного сервера, papermc.io для Paper, files.minecraftforge.net для Forge).

22. Проверьте, не запущен ли уже процесс на том же порту:

Хотя Pterodactyl должен управлять этим, иногда на хосте может быть запущен другой процесс, который занимает порт, который вы пытаетесь использовать для сервера Minecraft.

• Через SSH на хосте: Выполните команду sudo netstat -tulnp | grep <ваш_порт_сервера> (замените <ваш_порт_сервера> на порт, указанный в server.properties). Если вы видите процесс, который уже слушает этот порт, это может быть причиной конфликта.
• Решение: Измените порт сервера в server.properties и в настройках Pterodactyl на другой свободный порт, или найдите и остановите процесс, который занимает текущий порт.

23. Проверьте наличие и доступность Java в Docker-образе:

Даже если Docker-образ "предназначен" для Minecraft, иногда могут быть проблемы с самой установкой Java внутри контейнера.

• Подключитесь к контейнеру (для продвинутых пользователей): Если у вас есть доступ к хосту и вы знаете ID контейнера, вы можете попробовать подключиться к нему и проверить наличие Java:

  sudo docker ps -a # Найдите ID вашего контейнера
  sudo docker exec -it <container_id> bash
  java -version # Проверьте версию Java
  which java # Проверьте путь к Java

  Если java -version не работает или показывает ошибку, значит, Java либо не установлена, либо не находится в PATH внутри контейнера. В этом случае вам нужно будет либо использовать другой Docker-образ, либо модифицировать текущий.

24. Проверьте логи Pterodactyl Daemon (Wings) на хосте:

Помимо логов сервера Minecraft и общих ошибок Pterodactyl, сам демон Wings, который запускает контейнеры, имеет свои собственные логи. Они могут содержать более низкоуровневую информацию о том, почему Docker-контейнер не смог запуститься.

• На хосте (через SSH):

  sudo journalctl -u wings -f

  Запустите эту команду, а затем попробуйте запустить сервер Minecraft через панель Pterodactyl. Следите за выводом journalctl – там могут быть более конкретные ошибки, связанные с Docker, правами доступа или ресурсами, которые Pterodactyl Daemon не смог обработать.

25. Попробуйте "Reinstall Server" (Переустановить сервер) в Pterodactyl:

ВНИМАНИЕ: Этот шаг удалит все файлы вашего сервера! Сделайте резервную копию мира и всех важных файлов перед этим!

Если вы испробовали все остальное и ничего не помогает, возможно, что-то сильно повреждено в файлах сервера или его конфигурации. Опция "Reinstall Server" в панели Pterodactyl (обычно в разделе "Settings" или "Advanced") полностью удалит все файлы сервера и пересоздаст его с нуля, используя выбранный Docker-образ.

• Сделайте резервную копию: Перед переустановкой обязательно скачайте все важные данные: мир (world папка), плагины, моды, файлы конфигурации (server.properties, banned-players.json и т.д.).
• Выполните переустановку: После резервного копирования, запустите процесс переустановки.
• Настройте заново: После переустановки вам придется заново настроить eula.txt, server.properties и загрузить ваши плагины/моды и мир.

Если сервер запускается после переустановки, это однозначно указывает на проблему с файлами или конфигурацией вашего предыдущего сервера. Затем вы можете постепенно добавлять свои старые файлы (плагины, моды, мир), чтобы определить, какой из них вызывает сбой.

Краткий чек-лист для быстрого решения:

1. Проверьте логи Minecraft: Самое первое и главное.
2. eula.txt: Убедитесь, что eula=true.
3. server.jar: Убедитесь, что файл существует и имя совпадает.
4. RAM: Достаточно ли памяти выделено?
5. Права доступа: Код 128 часто указывает на это. Попробуйте "Fix Permissions" или проверьте вручную.
6. Плагины/Моды: Попробуйте запустить без них.

Если вы предоставите конкретные сообщения об ошибках из логов Minecraft, это значительно сузит круг поиска проблемы.