Project Zomboid サーバーは、よく知られたいくつかの理由でクラッシュしたり起動に失敗したりすることがあります。このガイドでは、Legion Hosting のサポートチケットで見られる最も一般的な原因を扱います — 起動時に追加の RAM を必要とする Build 42 のメモリバグから、/tmp を満杯にするバックアップのオーバーフロー、破損した設定ファイルまで。以下のセクションを順番に進めてください。
始める前に — クラッシュログの場所を確認する
ほとんどすべての Project Zomboid のクラッシュは、2 つの場所のいずれかに痕跡を残します。どの修正を試みる前にも両方を確認し、このガイドのどのセクションが該当するかを把握してください。
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 タブに移動します。リソースバーまたはサーバー情報パネルに表示されているサーバーの現在の RAM 割り当てをメモしてください。
- プランに 10 GB RAM 未満が含まれている場合、B42 は初期化に約 9 GB を必要とするため、起動中にサーバーがクラッシュする可能性があります。プランをアップグレードするか、Indie Stone が修正をリリースするのを待つ必要があります。
- プランにすでに 10 GB 以上があり、それでもサーバーが起動時にクラッシュする場合は、GPanel の Startup タブに移動します。
- Java Memory、Max RAM、または Xmx というラベルの付いたフィールドを探します。利用可能な合計 RAM の 80~85% 以下に設定されていることを確認してください。たとえば、12 GB のプランでは、これを
10240(10 GB、メガバイト単位)に設定します。合計 RAM と同じかそれ以上に設定しないでください — オペレーティングシステムや他のプロセスもメモリを必要とします。 - Startup タブで Save をクリックし、サーバーを再起動します。
- 起動中にコンソールを監視してください。サーバーが
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 は、SandboxVars.lua という 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を開きます。 - ファイルが
SandboxVars = {ブロック内でVERSION = 1,(または類似のもの)で始まり、閉じ}で終わっていることを確認してください。カンマの欠落、閉じられていない波括弧、または余分な文字があると、解析が失敗します。 - エラーを特定できない場合、最も安全な修正は
SandboxVars.luaを完全に削除することです。サーバーは次回の起動時にデフォルト値でこれを再生成します。注意: これにより、サンドボックス設定(ルート、ゾンビ数など)がデフォルトにリセットされます — マップデータとプレイヤーデータには影響しません。 - 最近手作業で編集した場合は、
/.cache/server/の.iniファイルにも同様の問題がないか確認してください。すべての行がKey=Value形式に従い、値の中に空行がないことを確認してください。 - 変更を保存してサーバーを再起動します。
SandboxVars.lua を直接編集することは避けてください。代わりに、ゲーム内の管理者パネルまたは GPanel のサーバー設定 UI(利用可能な場合)を使用してください。直接編集はエラーが発生しやすく、カンマを 1 つ見逃すだけでサーバーが壊れる可能性があります。
修正 4 — 空の管理者パスワードによるクラッシュ
Project Zomboid は、マルチプレイヤーサーバーを起動するために空でない管理者パスワードを必要とします。パスワードフィールドが空白の場合、サーバープロセスは管理者アカウントを初期化しようとした直後に終了します。
症状
- 新規サーバーまたは最近リセットされたサーバーが、すべての起動試行で失敗する。
- コンソール出力が非常に短い — サーバーが数行の初期化行を出力した後で停止する。
debug.logに管理者アカウントまたはパスワード検証への参照が含まれていることがある。
手順
- GPanel でサーバーをクリックし、Startup タブに移動します。
- Admin Password または RCON Password というラベルの付いたフィールドを探します。値が含まれていることを確認してください — 空白であってはなりません。
- フィールドが空の場合は、パスワードを入力してください。少なくとも 8 文字を使用してください。一部の PZ バージョンは起動引数でこれらを正しく解析できないため、管理者パスワードに
!、#、$、@などの特殊文字を使用するのは避けてください。 - Save をクリックしてサーバーを再起動します。
- 追加の確認として、
/.cache/server/の.iniファイルを開き、AdminPassword=の行のイコール記号の後に値があることを確認してください。
修正 5 — ワールドをリセットする(持続的なクラッシュの最終手段)
ワールドセーブが破損した場合(たとえば、サーバーのハードクラッシュ、更新の失敗、ファイルシステムエラーの後など)、セーブデータ自体が回復不能になることがあります。この場合、ワールドを削除して新たに始めることが唯一の選択肢です。
手順
- セーブファイルに変更を加える前に、GPanel でサーバーを停止してください。稼働中のサーバーでファイルを編集すると、さらなる破損を引き起こす可能性があります。
- GPanel で File Manager タブに移動します。
/.cache/saves/multiplayer/に移動します。- サーバー名の付いた 1 つ以上のフォルダが表示されます(例:
servertest)。削除する前に、必要に応じてフォルダを選択してダウンロードオプションを使用してバックアップとしてダウンロードしてください — 破損したセーブでも、後で部分的に回復できる可能性があります。 Multiplayer/内のサーバー名と一致するフォルダを削除します。Multiplayerフォルダ自体は削除しないでください。- また、
/.cache/db/に移動し、<YourServerName>.dbファイルを削除します。このデータベースにはプレイヤーの統計が保存されており、古いワールドを参照している可能性があります — これを再生成することで不一致を回避できます。 - サーバーを起動します。
.iniファイルの設定を使用して新しいワールドを生成します。
.ini ファイル、管理者パスワード、Mod リスト、ポート設定はすべて保持されます。次回の起動では、まったく同じ設定を使用して新しいワールドを生成します。
クイック診断リファレンス
| ログに表示される内容 | 最も可能性の高い原因 | 修正 |
|---|---|---|
OutOfMemoryError または Java heap space |
B42 の起動に十分な RAM がない | 修正 1 — B42 メモリバグ |
IOException: No space left on device |
BackupsOnStart が /tmp を満杯にしている |
修正 2 — BackupsOnStart |
SandboxVars エラーまたは Lua 解析エラー |
破損した、または手作業で編集された設定ファイル | 修正 3 — SandboxVars.lua |
| サーバーがすぐに終了し、コンソール出力が非常に短い | 空の管理者パスワード | 修正 4 — 管理者パスワード |
| 設定の変更に関係なく一貫してクラッシュする | 破損したワールドセーブ | 修正 5 — ワールドリセット |
すべての手順を試してもまだクラッシュしますか?
上記のすべての修正を進めてもサーバーがまだクラッシュする場合は、Legion Hosting でサポートチケットを開いてください。サポートチームが問題を迅速に診断できるように、以下を含めてください:
- クラッシュ時の GPanel コンソール出力の最後の 50 行
- 最新の
debug.logまたはDebugLog-server.txtファイルの完全な内容 - サーバーの Project Zomboid ビルドバージョン(起動時にコンソールに表示されます。例:
Build 42.x.x) - GPanel に表示される RAM の割り当て
- クラッシュが毎回の起動時に起こるのか、サーバーがしばらく稼働した後にのみ起こるのか
- クラッシュが始まる前に行った変更(Mod の追加、設定の編集、ゲームの更新)
サポートチケットを開いて、サーバー ID と GPanel コンソールのエラーメッセージを含めてください。