n8nが開かない・実行が終わらないときの初動確認|Dockerの状態とログの読み分け
このページの目次(6 項目)
n8nの画面が開かないときは、まずコンテナが動き続けているかを確かめます。画面は開くのに処理が終わらないように見える場合は、同じ時刻の実行記録を先に見ます。画面の接続切れ、ワークフローの失敗、n8nの停止は重なることがありますが、同じ原因とは限りません。
このガイドの到達点は、次に調べる場所を「コンテナの終了」「n8nやDBの起動」「画面までの接続」「個別のワークフロー」に絞ることです。原因が分からないまま再起動、再実行、プラン変更へ進まないための確認順を示します。
対象は、Linux上のDocker Composeで単一のn8nを運用し、その管理権限を持つ方です。2026年10月13日(日本時間)に公式資料を確認しました。VPSBenchによる障害再現・復旧の実機検証は未実施で、以下のコマンドも実環境では試していません。queue modeのworker、複数main、Kubernetes、n8n Assistant用サンドボックスの個別障害は対象外です。
最初に、症状と発生時刻をそろえる
調べる前に、発生時刻とタイムゾーン、最後に正常だった時刻、直前の変更を控えます。変更にはn8nの更新だけでなく、DNS・証明書・プロキシ・DB・ワークフローの変更も含めます。ログを採った時点で復帰していれば、「今の状態」と「障害時の状態」を分けて記録します。
次の表は、原因の一覧ではなく、読む場所を選ぶための入口です。複数の症状がある場合は、上の行から進みます。
| 見えている状態 | 先に見るもの | 進む節 |
|---|---|---|
| コンテナが停止している、または起動を繰り返す | 終了状態、起動時刻、停止前後のログ | 「コンテナが止まる・再起動を繰り返す場合」 |
| コンテナは動いているが、画面が開かない・接続が切れる | n8nのヘルス応答と、プロキシ側の記録 | 「画面が開かない場合」 |
| 画面は開くが、処理が失敗する・終わらないように見える | 同じ実行ID・時刻のExecutions | 「実行が終わらない・失敗する場合」 |
通知送信、注文登録、データ更新などを行うワークフローは、結果が不明なまま再実行しないでください。画面に完了が出ていなくても、送信先では処理済みの可能性があります。先に実行記録と送信先の記録を照合します。
Dockerの状態と、障害時刻のログを読む
起動に使ったComposeファイル、プロジェクト名、接続先のDocker環境を確認してから実行します。別ディレクトリーや別プロジェクトで一覧が空でも、「n8nが消えた」とは判断できません。普段と同じ管理方法が分からない場合は、構築担当者へ確認します。
停止中のものを含め、Composeプロジェクトのコンテナを表示します。
docker compose ps --allSERVICEがCompose内のサービス名、NAMEがコンテナ名です。runningやUpはコンテナの稼働を示しますが、画面へ接続できることや実行の成功までは示しません。exitedなら停止中、restartingなら再起動処理中です。正常に一度だけ動いて終了する補助サービスもあるため、n8n本体の行を特定します。Composeの一覧表示、コンテナ状態の定義
次に、n8n本体の状態を必要な項目だけ表示します。YOUR_N8N_CONTAINERを、一覧で確認したコンテナ名に置き換えてください。
docker container inspect --format 'ID={{.Id}} Status={{.State.Status}} OOMKilled={{.State.OOMKilled}} ExitCode={{.State.ExitCode}} StartedAt={{.State.StartedAt}} FinishedAt={{.State.FinishedAt}} RestartCount={{.RestartCount}}' YOUR_N8N_CONTAINER同じコンテナ名でも作り直し後は別のコンテナです。上のコマンドで表示したIDも手元に控え、別のコンテナや別時刻の値を混ぜないようにします。RestartCountは永久に残る障害履歴ではなく、Dockerの公式APIではコンテナ作成後、またはデーモン起動後の再起動回数として定義されています。inspectの書式、Docker Engineの状態項目
ログは障害が起きた時間帯に絞ります。次は「直近30分のうち末尾200行まで」を表示する例です。YOUR_N8N_SERVICEを先ほどのサービス名へ置き換え、時間幅と行数は発生時刻に合わせます。表示されない古い行や、200行より前の記録まで確認したことにはなりません。
docker compose logs --since 30m --tail 200 --timestamps YOUR_N8N_SERVICEn8nの標準のログ出力先はコンソール、ログレベルはinfoです。ファイル出力や別のログ保存先へ変更した構成では、その保存先も確認します。何も表示されなくても、エラーがなかった証明にはなりません。障害調査の入口で、全構成を一律にdebugへ変更する必要はありません。Composeのログ表示、n8nのログ設定
ログと実行詳細には、入力データ、メールアドレス、接続URL、認証ヘッダーなどが含まれる場合があります。手元で読み、公開フォーラムへ全文を貼らないようにします。Composeや.env、ワークフローJSON、docker inspectの全出力も、そのまま共有する資料にはしません。
コンテナが止まる・再起動を繰り返す場合
停止の直前から次の起動までを、時刻でつなげて読みます。最後に出た行や目立つ警告だけで原因を決めず、実行開始、エラー、終了、再起動の順序を確認してください。
| 観測したもの | 読み取れること | 次に見るもの |
|---|---|---|
OOMKilled=true |
そのコンテナで、最後の起動以降にメモリ不足でプロセスが終了した記録がある | 同時刻の実行、コンテナのメモリ制限、ホスト側の記録 |
ログのJavaScript heap out of memory |
Node.jsのヒープメモリ不足を示す手掛かり | どの処理中か、入力の量、同時実行、適用中のメモリ設定 |
終了コード137だけ |
SIGKILLによる終了。手動killなどでも発生する | OOM記録、管理操作、Docker側の停止・再起動の時刻 |
| 起動のたびにDB接続・移行のエラーが出る | 起動時のDB処理を調べる必要がある | DB側の状態、接続先、直前の版・設定変更 |
RestartCountが増える |
同じコンテナで再起動が観測されている | 終了直前のログ。再起動設定だけを直して終えない |
OOMKilled=falseだけでは、メモリ問題を否定できません。この項目の範囲は最後の起動以降であり、再起動前の全履歴を表すものではありません。また、Node.jsのヒープ不足と、Dockerが記録するOOM終了は別の観測です。確認時点の値と、障害時刻のログを併記します。Dockerの状態定義、137の説明、n8nのメモリ問題
稼働中の使用量を見るなら、次の読み取り例を使えます。ただし障害後の1回の値から、停止直前の最大使用量は分かりません。停止中のコンテナからは使用量を取得できません。
docker stats --no-stream YOUR_N8N_CONTAINERDockerのメモリ表示とVPS全体の空きメモリは同じ指標ではありません。まずホストのメモリ容量、コンテナの上限、同居するDBなどの構成を分けます。statsのLinux表示にはキャッシュの扱いもあるため、別の測定方法の値と単純比較しないようにします。Docker statsの説明
メモリが関係すると分かった後に、入力を小分けにする、同時実行を減らす、利用可能なメモリを増やす、といった対策を検討します。容量の選び方はn8nの1GB・2GB・4GB測定へ進めます。そこに掲載した成功件数を、別のワークフローの上限として使うことはできません。
SQLiteのファイルが大きい場合は、メモリとは分けてディスクの空き容量を調べます。実行履歴を削除しても容量が減らないときは、SQLiteの削除とVACUUMの確認で、DB本体・WAL・空き容量と、保守を始める条件を確認してください。
画面が開かない場合
コンテナが動いていれば、n8nまで届いているかを調べます。独自ドメインの前にプロキシや認証用のサービスを置いている場合、そこで返ったエラーとn8n自身の応答を分ける必要があります。
n8nには、状態確認用のHTTPエンドポイントがあります。標準のパスと200の意味は次のとおりです。
| パス | 200が示す範囲 |
|---|---|
/healthz |
n8nインスタンスへ到達できる。DBの状態は確認しない |
/healthz/readiness |
DBへ接続でき、必要な移行が済み、リクエストを受け付ける準備ができている |
この200は、外部APIや各ワークフローの成功を保証しません。パスを変更した構成、認証ゲートウェイで保護した構成では、標準パスにアクセスしても同じ結果にならないことがあります。ログイン画面の200やプロキシ独自の応答を、n8nのヘルス応答として数えないでください。n8nのヘルスチェック仕様
既存の監視画面や、管理者が使っている確認方法で、公開URL側とn8n側の応答を比較します。内部の確認先が分からない場合は、構成担当者へ依頼してください。確認用に5678番ポートを新しく公開したり、TLSや認証を無効にしたりする必要はありません。
| 確認結果 | 次の確認先 |
|---|---|
| n8n側の両パスは200、公開URL側は502など | プロキシが接続している上流の宛先・ポート、同時刻のプロキシログ |
n8n側の/healthzは200、readinessは200にならない |
n8nの起動ログ、DBの接続・移行の記録。DB障害と即断はしない |
| n8n側でも応答を確認できない | コンテナの状態と起動ログへ戻る。確認した宛先・ポートが正しいかも照合 |
| 両パスは200だが、画面だけ接続が切れる | ブラウザーからn8nへの通信、プロキシ、画面更新用の接続 |
この表は公式のヘルス仕様を使った調査順です。結果だけで原因を確定する診断表ではありません。n8nの画面更新にはWebSocketまたはSSEが使われるため、通常のHTTPのヘルス確認が成功しても、画面更新の接続まで正常とは限りません。使っている方式と中継設定を照合し、理由なく方式やタイムアウトを変えないようにします。画面更新方式の設定
実行が終わらない・失敗する場合
画面の回転表示だけでは、処理中か、実行済みで表示が更新されていないかを分けられません。画面を開ける場合はOverviewのExecutionsへ進み、対象ワークフロー、発生時刻、状態で絞ります。同じ実行IDが分かるなら、その記録と突き合わせます。実行一覧の確認方法
| 実行記録の状態 | 調べること |
|---|---|
Success |
同じ実行かを確認し、期待した送信・更新が送信先にも記録されているかを照合。成功記録があるのに画面だけ終わらない場合は、画面更新側へ進む |
Failed |
失敗したノード、エラー文、接続先、時刻を確認。特定の外部APIや入力での失敗を、n8n全体の停止と混同しない |
RunningまたはWaiting |
待機する設計か、外部応答待ちか、同時刻にコンテナ停止があったかを確認。状態名だけで強制停止しない |
| 該当する記録が見当たらない | 絞り込み・閲覧範囲、実行データの保存設定と保持条件、呼び出し元の記録を確認 |
実行履歴は保存設定や削除条件によって残らない場合があります。「一覧にないから一度も実行されていない」とは判断できません。新たに保存設定を変えても、消えた過去の実行結果が戻るわけではありません。実行データの保存・保持設定
Webhookで始まる処理だけ動かない場合は、呼び出し元が使ったURLとHTTPメソッドを、対象ノードの設定と照合します。Test URLはテストイベントの待受中に使うもの、Production URLは公開されたワークフローを呼び出すものです。到達確認のつもりで本番Webhookへ送信すると、通知や書き込みまで実行されるため、初動では既存の送信記録を先に使います。WebhookのTest URLとProduction URL
失敗した処理を再実行するときは、すでに送信・更新できた部分と、未処理の部分を先に確定します。n8nには過去データを使った再試行機能がありますが、そのボタンの存在だけで、同じ業務処理を安全に繰り返せるとは判断できません。結果を確定できない処理は、接続先の管理者と再実行方法を決めます。
変更を止めて、復旧担当へ渡す条件
次の場合は、その場で設定変更を重ねず、観測した内容をまとめて担当者へ渡します。ここでいう「止める」は、サーバーを無条件に停止することではなく、根拠のない変更や再実行を止める判断です。
- 本番DB・保存先・現在の暗号化キー・バックアップの対応が分からない
- 更新直後にDBの移行エラー、データ不整合、読み書きのエラーが出ている
- 再起動を繰り返し、障害時刻のログや状態を確保できない
- 通知・注文・課金を伴う処理が、どこまで完了したか分からない
- 確認を続けるために、秘密情報の公開、認証の無効化、無計画なポート開放が必要になっている
削除・ボリューム初期化・DB直接編集・暗号化キーの作り直しを、共通の復旧手順にはしません。再起動や版の変更が必要になった場合も、対象、業務への影響、保存物、元に戻す手段を確認してから進めます。保存対象と復元の点検はn8nのバックアップガイドに分けています。
相談用には、次の内容だけで最初の状況を伝えられます。秘密の値や入力データ本文は書かず、必要になった抜粋も認証情報や個人情報を除いてから、適切な相談先へ渡してください。
- 発生時刻・タイムゾーン、最後に正常だった時刻
- n8nの版、DB、Compose構成、プロキシの有無
- 画面、実行記録、コンテナそれぞれで観測した状態
- 障害時と採取時の違い、確認できなかったもの
- エラーの種類、対応するノード・時刻。URLの秘密部分や入力内容は含めない
- 直前の変更、すでに試した操作とその時刻
この記録で、コンテナの終了を調べるのか、DBや接続を調べるのか、個別ワークフローを調べるのかを決めます。原因を絞れていなければ「未特定」のまま残し、容量増設や環境の作り直しを結論にしないでください。
状態の記録でOOMKilled=trueが残り、障害時刻の実行と対応づけられた場合は、メモリ不足が原因の候補になります。容量を選び直すかどうかは、n8nを1GB・2GB・4GBで測った記事で、処理件数とメモリの関係を確かめてから決めてください。