Сервери Project Zomboid можуть аварійно завершувати роботу або не запускатися з кількох добре відомих причин. Цей посібник охоплює найпоширеніші причини, що зустрічаються в тикетах підтримки Legion Hosting — від помилки пам'яті Build 42, яка потребує додаткової оперативної пам'яті під час запуску, до переповнення резервних копій, яке заповнює /tmp, та пошкоджених файлів конфігурації. Працюйте над розділами нижче по порядку.
Перш ніж почати — знайдіть свої журнали збоїв
Майже кожне аварійне завершення Project Zomboid залишає сліди в одному з двох місць. Перевірте обидва, перш ніж намагатися застосувати будь-яке виправлення, щоб знати, який розділ цього посібника стосується вас.
Вивід консолі GPanel
- Увійдіть до GPanel.
- Виберіть свій сервер Project Zomboid зі списку серверів.
- Натисніть вкладку Console.
- Прокрутіть до низу виводу. Шукайте рядки, позначені
ERROR,FATAL,OutOfMemoryErrorабоException. Останні 20–30 рядків перед зупинкою сервера зазвичай є найбільш релевантними. - Якщо консоль порожня, процес сервера завершився, перш ніж зміг щось записати — це саме по собі є підказкою (дивіться розділ про пам'ять B42 нижче).
Файл сервера debug.log
Project Zomboid записує детальний журнал у debug.log у каталозі даних сервера. Цей файл часто містить повну трасування стеку Java, яке безпосередньо вказує на причину збою.
- У GPanel перейдіть на вкладку File Manager.
- Перейдіть до
/.cache/Logs/. Ви побачите файли з іменами на кшталтdebug.log,DebugLog-server.txtабо датовані файли журналів. - Відкрийте найновіший файл журналу. Використовуйте Ctrl+End або прокрутіть у самий низ та читайте звідти вгору.
- Шукайте ключові слова
OutOfMemoryError,IOException,NullPointerExceptionабоSandboxVars. Скопіюйте відповідні рядки — вони знадобляться вам, якщо ви відкриєте тикет підтримки.
Виправлення 1 — Високе використання пам'яті під час запуску Build 42 (відома помилка гри)
Якщо ваш сервер негайно завершує роботу під час запуску без помилки в консолі, або консоль показує OutOfMemoryError чи помилку купи Java, серверу не вистачає пам'яті до того, як світ завершить завантаження.
Симптоми
- Сервер запускається, консоль прокручується кілька секунд, потім зупиняється без помилки, видимої гравцеві.
- Консоль показує
java.lang.OutOfMemoryError: Java heap spaceабоGC overhead limit exceeded. - Сервер працює при деяких перезапусках, але не при інших (доступність пам'яті варіюється).
- Сервер чудово працював на B41, але постійно аварійно завершує роботу після оновлення до B42.
Кроки
- У GPanel натисніть на свій сервер та перейдіть на вкладку Console. Зверніть увагу на поточне виділення оперативної пам'яті вашого сервера, показане в панелі ресурсів або панелі інформації про сервер.
- Якщо ваш тарифний план включає менше ніж 10 ГБ оперативної пам'яті, сервер може аварійно завершити роботу під час запуску, оскільки B42 потребує приблизно 9 ГБ для ініціалізації. Вам потрібно буде оновити свій тарифний план або зачекати, поки Indie Stone випустить виправлення.
- Якщо ваш тарифний план уже має 10 ГБ або більше, а сервер усе одно аварійно завершує роботу під час запуску, перейдіть на вкладку Startup у GPanel.
- Знайдіть поле з міткою Java Memory, Max RAM або Xmx. Переконайтеся, що воно встановлено не більше ніж на 80–85% від загального доступного обсягу оперативної пам'яті. Наприклад, на тарифному плані 12 ГБ встановіть це значення на
10240(10 ГБ у мегабайтах). Не встановлюйте його рівним або вищим за загальний обсяг оперативної пам'яті — операційна система та інші процеси також потребують пам'яті. - Натисніть Save на вкладці Startup, потім перезапустіть свій сервер.
- Спостерігайте за консоллю під час запуску. Якщо сервер досягає рядка
SERVER STARTEDабоLuaManager: Loading lua files...завершується без збою, виділення пам'яті тепер достатнє.
Виправлення 2 — BackupsOnStart переповнює /tmp (аварійне завершення під час запуску)
Project Zomboid можна налаштувати на створення повної резервної копії світу кожного разу під час запуску сервера. Коли ця резервна копія записується в /tmp — який обмежений за розміром на більшості хостів Linux — сервер аварійно завершує роботу посеред запуску з помилкою запису на диск, як тільки /tmp заповнюється.
Симптоми
- Сервер надійно аварійно завершує роботу при кожному перезапуску, але раніше працював.
- Консоль або
debug.logмістить помилки на кшталтIOException: No space left on deviceабо згадки про запис у/tmp/. - Збої мають тенденцію погіршуватися з часом, оскільки збереження світу збільшується.
- Сервер іноді запускається, якщо спробувати незабаром після чистого перезавантаження хост-вузла (перш ніж
/tmpзнову заповниться).
Кроки — вимкнення BackupsOnStart
- У GPanel перейдіть на вкладку File Manager.
- Перейдіть до
/.cache/server/. Шукайте файл конфігурації вашого сервера — він зазвичай називаєтьсяservertest.iniабо як завгодно називається ваш сервер, після чого йде.ini(наприклад,MyServer.ini). - Відкрийте файл
.iniдля редагування. - Використовуйте функцію пошуку вашого браузера (Ctrl+F), щоб знайти
BackupsOnStart. - Змініть значення з
trueнаfalse:BackupsOnStart=false - Перебуваючи у файлі, також перевірте налаштування
BackupsOnVersionChangeта встановіть його наfalse, якщо вас турбує дисковий простір:BackupsOnVersionChange=false - Збережіть файл та перезапустіть свій сервер. Спостерігайте за консоллю, щоб підтвердити, що сервер досягає рядка
SERVER STARTED.
/.cache/saves/multiplayer/, або зверніться до підтримки Legion Hosting, щоб дізнатися про варіанти запланованих резервних копій на вашому тарифному плані.
Виправлення 3 — Пошкоджений SandboxVars.lua або конфігурація сервера
Project Zomboid зберігає налаштування світу у файлі Lua під назвою SandboxVars.lua. Якщо цей файл відредагувати вручну та зберегти із синтаксичною помилкою, або якщо передачу файлу було перервано, сервер негайно аварійно завершить роботу під час запуску, коли спробує проаналізувати файл.
Симптоми
- Консоль показує
ERROR: SandboxVars,LuaManager errorабо помилку аналізу Lua з номером рядка. - Збій почався одразу після того, як ви відредагували налаштування у файлі
.iniабоSandboxVars.luaбезпосередньо. - Сервер може показувати
Bad argument #1 toабо подібні помилки виконання Lua.
Кроки — перевірка та виправлення SandboxVars.lua
- У GPanel перейдіть до File Manager та перейдіть до
/.cache/saves/multiplayer/<YourServerName>/. - Відкрийте
SandboxVars.luaдля редагування. - Перевірте, що файл починається з
VERSION = 1,(або подібного) всередині блокуSandboxVars = {та закінчується закриваючою}. Будь-яка відсутня кома, незакрита дужка або зайвий символ призведе до помилки аналізу. - Якщо ви не можете визначити помилку, найбезпечнішим виправленням є повне видалення
SandboxVars.lua. Сервер відтворить його зі значеннями за замовчуванням під час наступного запуску. Примітка: це скидає ваші налаштування пісочниці (видобуток, кількість зомбі тощо) до значень за замовчуванням — дані вашої карти та дані гравців не зачіпаються. - Також перевірте файл
.iniу/.cache/server/на наявність подібних проблем, якщо ви нещодавно редагували його вручну. Переконайтеся, що кожен рядок дотримується форматуKey=Valueбез порожніх рядків усередині значення. - Збережіть зміни та перезапустіть сервер.
SandboxVars.lua. Натомість використовуйте внутрішньоігрову адмін-панель або інтерфейс налаштувань сервера в GPanel, якщо він доступний. Прямі редагування схильні до помилок і можуть зламати сервер однією пропущеною комою.
Виправлення 4 — Порожній пароль адміністратора, що спричиняє збій
Project Zomboid потребує непорожнього пароля адміністратора для запуску багатокористувацького сервера. Якщо поле пароля порожнє, процес сервера негайно завершується після спроби ініціалізувати обліковий запис адміністратора.
Симптоми
- Абсолютно новий сервер або нещодавно скинутий сервер не вдається запустити при кожній спробі.
- Вивід консолі дуже короткий — сервер виводить кілька рядків ініціалізації, а потім зупиняється.
debug.logможе містити посилання на обліковий запис адміністратора або перевірку пароля.
Кроки
- У GPanel натисніть на свій сервер та перейдіть на вкладку Startup.
- Знайдіть поле з міткою Admin Password або RCON Password. Переконайтеся, що воно містить значення — воно не повинно бути порожнім.
- Якщо поле порожнє, введіть пароль. Використовуйте щонайменше 8 символів. Уникайте спеціальних символів, таких як
!,#,$або@у паролі адміністратора, оскільки деякі версії PZ не вдається правильно проаналізувати їх в аргументах запуску. - Натисніть Save та перезапустіть сервер.
- Як додаткову перевірку, відкрийте файл
.iniу/.cache/server/та переконайтеся, що рядокAdminPassword=має значення після знака рівності.
Виправлення 5 — Скидання світу (крайній захід для постійних збоїв)
Якщо збереження світу стає пошкодженим — наприклад, після жорсткого збою сервера, невдалого оновлення або помилок файлової системи — самі дані збереження можуть бути невідновними. У цьому випадку видалення світу та початок з нуля є єдиним варіантом.
Кроки
- Зупиніть свій сервер у GPanel, перш ніж вносити будь-які зміни до файлів збереження. Редагування файлів на працюючому сервері може спричинити подальше пошкодження.
- У GPanel перейдіть на вкладку File Manager.
- Перейдіть до
/.cache/saves/multiplayer/. - Ви побачите одну або кілька папок з іменем вашого сервера (наприклад,
servertest). Перед видаленням за бажанням завантажте папку як резервну копію, вибравши її та скориставшись опцією завантаження — навіть пошкоджене збереження може бути частково відновленим пізніше. - Видаліть папку, що відповідає імені вашого сервера, всередині
Multiplayer/. Не видаляйте саму папкуMultiplayer. - Також перейдіть до
/.cache/db/та видаліть файл<YourServerName>.db. Ця база даних містить статистику гравців і може посилатися на старий світ — її відтворення дозволяє уникнути невідповідностей. - Запустіть свій сервер. Він згенерує новий світ, використовуючи налаштування у вашому файлі
.ini.
.ini, пароль адміністратора, список модів та налаштування портів — усе зберігається. Наступний запуск використає точно ті самі налаштування для генерації нового світу.
Швидкий діагностичний довідник
| Що ви бачите в журналі | Найбільш імовірна причина | Виправлення |
|---|---|---|
OutOfMemoryError або Java heap space |
Недостатньо оперативної пам'яті для запуску B42 | Виправлення 1 — помилка пам'яті B42 |
IOException: No space left on device |
BackupsOnStart заповнює /tmp |
Виправлення 2 — BackupsOnStart |
Помилка SandboxVars або помилка аналізу Lua |
Пошкоджений або відредагований вручну файл конфігурації | Виправлення 3 — SandboxVars.lua |
| Сервер негайно завершує роботу, дуже короткий вивід консолі | Порожній пароль адміністратора | Виправлення 4 — пароль адміністратора |
| Постійно аварійно завершує роботу незалежно від змін конфігурації | Пошкоджене збереження світу | Виправлення 5 — скидання світу |
Усе ще аварійно завершує роботу після всіх кроків?
Якщо ваш сервер усе ще аварійно завершує роботу після проходження кожного виправлення вище, відкрийте тикет підтримки з Legion Hosting. Включіть наступне, щоб допомогти команді підтримки швидко діагностувати проблему:
- Останні 50 рядків виводу консолі GPanel на момент збою
- Повний вміст найновішого файлу
debug.logабоDebugLog-server.txt - Версію збірки Project Zomboid вашого сервера (показана в консолі під час запуску, наприклад
Build 42.x.x) - Ваше виділення оперативної пам'яті, як показано в GPanel
- Чи відбувається збій при кожному запуску, чи лише після того, як сервер деякий час працював
- Будь-які зміни, які ви внесли до початку збоїв (додавання модів, редагування конфігурації, оновлення гри)
Відкрийте тикет підтримки та включіть ID вашого сервера і повідомлення про помилки з консолі GPanel.