SSD Nodes Learn Hosting plans →
ガイド Matt Connor著者 Matt Connor

n8n がVPSでオフラインになる4つの原因と診断

n8nのオフライン表示は、websocketの接続バナー、再起動ループ、out of memoryによるkill、スケジュール停止の4種類に分かれます。原因ごとの確認方法を解説します。

n8n がオフラインになる理由: 4 つの障害、1 つの症状

「n8n がオフラインになる」という表現は、異なる 4 つの障害をまとめて指しています。それぞれ必要な対処が異なります。コンテナは正常に稼働しているのに、エディターには接続が失われたことを示すバナーが表示される場合があります。コンテナが自動的に再起動する場合もあります。メモリを過剰に使用したために、カーネルが Node.js プロセスを強制終了することもあります。あるいは、プロセスには問題がなく、アクティブなワークフローが実行されないだけの場合もあります。誤った設定を変更すると、実際には存在しない問題に週末を費やすことになります。

そのため、設定に触れる前に、どの障害が発生しているかを特定してください。n8n は通常、TLS (transport layer security) を終端するリバースプロキシの背後で、Docker コンテナ内のメイン Node.js プロセスとして動作します。Code node では task runner プロセスも使用します。internal mode では子プロセスを起動し、external mode では通常、sidecar コンテナ内で個別に実行します。これらの各層はそれぞれ異なる形で障害が発生しますが、ブラウザーには同じメッセージで接続失敗が表示されます。

この順序で診断します

VPS(仮想プライベートサーバー)で次のコマンドを実行し、自分のマシンが出力する値を確認します。フォーラムの投稿にある数値と比較しないでください。ここで重要なのは、他人の環境ではなく、自分のサーバーを示す値です。

docker ps -a --filter name=n8n
docker logs --tail 200 --timestamps n8n
docker inspect n8n | grep -iE 'Status|Running|RestartCount|OOMKilled|ExitCode'
docker stats --no-stream

docker ps -a の STATUS 列は、コンテナが現在の状態になってからの経過時間を示します。問題が始まった時刻と比較してください。コンテナがバナーの表示よりかなり前から起動していた場合、その時点でコンテナが再起動した可能性はなくなります。ただし、n8n がその間も利用可能だったことを証明するものではありません。次のセクションで説明する websocket の確認に進む前に、到達性を /healthz で確認し、データベースが接続済みで移行済みであることを /healthz/readiness で確認してください。

RestartCount は、Docker がこのコンテナを再起動した回数です。この数値を記録し、1 分待ってからもう一度確認してください。監視中に数値が増える場合は、再起動ループが発生しています。各再起動の直前に出力されたログ行に、原因が記録されています。

OOMKilled は true または false のフラグです。True は、Docker がコンテナ内で out of memory による kill を記録したことを示します。ログとカーネルメッセージを併せて確認し、どのプロセスが kill されたのか、またメモリー圧迫がコンテナの制限によるものか、マシン全体によるものかを特定します。

ExitCode は、コンテナが最後に終了したときの終了コードです。各コードの意味を暗記する必要はありません。自分の値を確認し、同じタイムスタンプにある docker logs の末尾も確認してください。ログの末尾と out of memory フラグを併せて確認することで、何が起きたのかを判断できます。どちらか一方だけでは誤った判断につながることがあります。

docker stats は、現在のメモリー使用量を適用中の制限値と並べて表示します。別のターミナルで実行したままにし、問題を起こすワークフローを実行して、障害が発生している間に数値がどう変化するかを確認してください。


「接続が失われました」というバナーは、通常リバースプロキシが原因です

n8n エディターは、実行の進行状況をキャンバスにストリーミングするため、バックエンドへの長時間接続を 1 本維持します。デフォルトでは、この接続に WebSocket を使用します。N8N_PUSH_BACKEND がこの方式を選択し、デフォルト値は websocket です。WebSocket は、Connection: Upgrade と Upgrade: websocket のヘッダーを含む通常の HTTP リクエストとして開始されます。サーバーは 101 Switching Protocols で応答し、その後は双方が同じ TCP ソケットを双方向で使用します。

この接続は、プロキシに関する 2 つの問題で切断されます。プロキシが上流との通信に HTTP/1.0 を使用するか、アップグレード用ヘッダーを削除すると、アップグレードが成立せず、エディターは再接続を繰り返します。もう 1 つは、アップグレードが成功した後、通信がないためにプロキシがソケットを閉じるケースです。メッセージのない WebSocket は、アイドル状態の接続と区別できません。n8n 自体も、認証またはリクエスト検証に失敗した場合はプッシュ接続を拒否します。これには pushRef の欠落や、無効な origin などが含まれます。このバナーは、ブラウザーが通信チャネルの切断を通知しているだけであり、コンテナが正常であることを示すものではありません。

何かを編集する前に、ブラウザーでこの状況を確認します。開発者ツールを開き、Network タブで WS に絞り込んでから、エディターを再読み込みします。プッシュリクエストは 101 Switching Protocols に到達し、接続を維持するはずです。プッシュリクエストが通常のステータスコードを返す場合、または数秒ごとに再表示される場合は、そのレスポンスと n8n のログを確認し、プロキシ、認証、origin に関するエラーを調べます。

エディターとの接続を維持する nginx 設定

nginx は、明示的に指定しない限り upgrade を転送しません。Connection と Upgrade は hop-by-hop ヘッダーであり、nginx は転送時に削除するため、両方を再設定する必要があります。upstream とのプロトコルは nginx のリリースによって異なります。1.29.7(2026 年 3 月)以降では、proxy_pass によりデフォルトでバックエンドと HTTP/1.1 で通信します。それ以前は HTTP/1.0 を使用しており、upgrade をまったく運べません。nginx -v を実行して、使用中のバージョンを確認します。以下の設定では proxy_http_version 1.1 を明示しているため、どちらのバージョンでも動作します。1.29.7 以降では、この行はデフォルト値を再指定するだけです。map ブロックは http コンテキストに配置します。server の内部には配置しません。以下の server ブロックの残りの部分が不明な場合は、nginx の server ブロックを行ごとに解説した説明で各ディレクティブの動作を確認できます。

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}
server {
    listen 443 ssl;
    http2 on;
    server_name n8n.example.com;

    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
        proxy_buffering off;
    }
}

proxy_read_timeout のデフォルト値は 60 秒です。upgrade 後の WebSocket にも適用され、バックエンドからの読み取り間隔で測定されます。n8n は 60 秒ごとに push ping を送信するため、ワークフローインスタンスが静止していても、ソケットが通信していないとは限りません。タイムアウト値を増やすと、デフォルトのタイムアウトに達する前に ping が届く余裕ができます。定期的な ping フレームもタイムアウトをリセットします。

sudo nginx -t && sudo systemctl reload nginx
sudo nginx -T | grep -iE 'proxy_http_version|upgrade|proxy_read_timeout'

nginx -T は、実行中のプロセスにすでに読み込まれた設定を調べるのではなく、include されたファイルを含む設定ファイルをテストして出力します。reload が成功したことも確認してください。正しい修正が何も効果を示さない場合、設定がファイルに存在していても、include 行がそのファイルを読み込んでいないことが原因です。

次に、n8n にプロキシの背後で動作していることを伝えます。n8n はこれらの値から URL を生成するためです。

environment:
  - N8N_HOST=n8n.example.com
  - N8N_PROTOCOL=https
  - N8N_PORT=5678
  - N8N_PROXY_HOPS=1
  - N8N_WEBHOOK_URL=https://n8n.example.com/

N8N_PROXY_HOPS のデフォルト値は 0 です。これは、n8n が接続元アドレスをクライアントアドレスとして扱い、X-Forwarded-For を無視することを意味します。コンテナの前段にあるプロキシの数を指定します。2026 年 10 月時点では、N8N_WEBHOOK_URL が現在の名称です。古い WEBHOOK_URL も引き続き使用できますが、起動時に非推奨警告が表示されます。

Traefik は WebSocket を自動的に転送する

Traefik は、ミドルウェアも追加のラベルも使用せずに WebSocket のアップグレードを転送します。HTTP のタイムアウトのデフォルト値は、アップグレード後の WebSocket に対するタイムアウトを設定しません。以下の設定項目は entryPoint にあります。2026 年 10 月時点の Traefik v3 では、idleTimeout はアイドル状態の HTTP keep-alive 接続に対してデフォルトで 180 秒、readTimeout はリクエスト本文を含むリクエストの読み取りに対してデフォルトで 60 秒です。レスポンスの書き込みタイムアウトは、プロトコルのアップグレードを明示的に除外します。この例は HTTP のタイムアウトを変更するものであり、WebSocket banner の確実な修正方法ではありません。

entryPoints:
  websecure:
    address: ":443"
    transport:
      respondingTimeouts:
        readTimeout: 0
        idleTimeout: 3600s

Caddy は reverse_proxy でアップグレードを自動的に処理するため、そのためのディレクティブは必要ありません。プロキシをまったく変更できない場合、つまり別の担当者が管理している場合は、N8N_PUSH_BACKEND=sse を使用してプッシュチャネルを切り替えます。SSE (server-sent events) は接続を開いたままにする通常の HTTP レスポンスです。そのため、アップグレードを拒否するプロキシでも利用できます。ただし、アイドルタイムアウトが短い場合は接続が切断されます。どのプロキシを選ぶかは別の判断事項です。nginx、Caddy、Traefik の比較では、それぞれの運用コストを説明しています。

コンテナが実際に再起動を繰り返している場合

RestartCount が増えている場合、コンテナは失敗しており、Docker が再起動させています。ログのタイムスタンプを各再起動の時刻と照合し、その直前に出力された内容を確認してください。よくある原因には、起動を停止させる設定エラー、n8n から接続できないデータベース、実行開始後のクラッシュ、メモリ不足による強制終了があります。

まずボリュームを確認してください。権限の問題は気付きにくいためです。公式イメージは非特権ユーザー node として実行され、データを /home/node/.n8n に保存します。bind mount がそのユーザーから書き込み可能でない場合、プロセスはデータを書き込む時点で失敗します。再起動ポリシーが設定されていると、この失敗が再起動ループになることがあります。

docker compose config
docker run --rm -it --entrypoint sh docker.n8n.io/n8nio/n8n -c 'id'
docker exec n8n ls -ld /home/node/.n8n

新しい named volume には、Docker がデータを作成する際にイメージ内のディレクトリの所有権が引き継がれます。既存の volume では、権限を確認する必要があります。bind mount を使用する場合は、ホストディレクトリの所有者を id コマンドが出力した数値の user id に chown してください。ホストとコンテナ間の所有権マッピングは一度理解しておくと便利です。PUID と PGID の解説では、これらのイメージがファイルを書き込むユーザーを決定する仕組みを説明しています。

クラッシュに見える Out of Memory による kill

n8n プロセスには、2 つの異なるメモリ上限があります。これらは異なる形で障害になります。コンテナの control group limit は kernel が適用します。使用量が上限に達し、解放できない場合、kernel は OOM killer を起動します。使用量が一時的に上限を超えることもあります。OOM kill の対象になったプロセスは、最後のログエントリを書き込む機会を得られません。Docker はその事実を OOMKilled に記録します。V8 heap limit は Node.js 内部で適用されます。これを使い切ると、fatal heap error が発生し、kernel による OOM kill なしでプロセスが終了します。ブラウザーから見ると、これらは同じように見えます。ログと併せて docker inspect を確認し、どちらかを判別してください。

Node の heap ceiling は、コンテナの limit より低く設定してください。native allocations、buffers、その他の heap regions、コンテナ内の他のプロセスに必要な容量を残します。heap ceiling を高くすると、V8 が独自の limit に達する前に kernel が OOM kill を実行するリスクが高くなります。ただし、必ずそうなるわけではありません。メモリが reclaim または swap される場合があり、ワークロードがどちらの ceiling も使い切らない可能性もあります。heap ceiling を低くしても、container OOM kill より先に heap error が発生するとは限りません。

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: unless-stopped
    environment:
      - NODE_OPTIONS=--max-old-space-size=<MiB, below the container limit>
    deploy:
      resources:
        limits:
          memory: <your container limit>

heap placeholder を MiB 単位の数値に置き換え、--max-old-space-size=SIZE の形式を使用します。2 つの数値は、実際に VPS に搭載されている容量を基準に選んでください。database、proxy、operating system に必要な容量を残します。docker stats --no-stream は、現在の使用量と適用中の limit を並べて表示します。これにより、記述した limit が Docker によって適用された limit と同じか確認できます。Compose のメモリ制限が適用される仕組みでは、複数の limit を設定した場合にどの key が優先されるかを説明しています。

実行データは気付かないうちに増え続ける

1 回の実行中は、すべてのノードの出力が 1 つの実行データに保持されます。n8n はその後、実行データの保存設定に従ってデータを保存します。ここから 2 つの点が分かります。データ量と各ノードの処理内容はピーク時のメモリ使用量に影響します。そのため、一度に 10000 行を処理するワークフローは、同じワークフローでも一度に 200 行を処理する場合とは別のプログラムです。また、保存されたコピーは、何かによって削除されるまで増え続けます。

2 つ目の問題には pruning が対応します。2026 年 10 月時点のデフォルトは、pruning が有効で、EXECUTIONS_DATA_MAX_AGE は 336 時間 (14 日)、EXECUTIONS_DATA_PRUNE_MAX_COUNT は 10000 です。SQLite を実行する小規模な VPS では、1 つのファイルにすべてのデータが保存され、エディターを提供する同じプロセスがそのファイルの読み書きも行うため、これらは余裕のある設定です。

environment:
  - EXECUTIONS_DATA_PRUNE=true
  - EXECUTIONS_DATA_MAX_AGE=72
  - EXECUTIONS_DATA_PRUNE_MAX_COUNT=1000
  - EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
  - EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false

EXECUTIONS_DATA_SAVE_ON_SUCCESS=none は積極的にデータを削減する設定です。成功した実行の保存を無効にします。EXECUTIONS_DATA_SAVE_ON_ERROR がデフォルトの all のままであれば、失敗した実行は保持されます。個々のワークフローの設定で、これらの選択を上書きすることもできます。これは意図的に決めてください。エラーを発生させずに誤った出力を生成したワークフローでは、調査するためのデータが何も残らなくなるためです。pruning では、まず行を削除済みとしてマークし、その後の処理で削除します。また、SQLite は解放されたページを返却せず再利用するため、設定を変更してもディスク上のファイルはすぐには小さくなりません。

保存される合計量ではなくピーク時の使用量を減らすには、1 回の実行で移動するデータ量を減らします。大きな処理を、親ワークフローに小さな結果を返すサブワークフローに分割します。Loop Over Items ノードでバッチ処理を行い、データセット全体を Code ノードに渡さないようにします。

バイナリファイルをメモリ経由で処理しない

N8N_DEFAULT_BINARY_DATA_MODE のデフォルト値は default です。この設定では、実行中のプロセスのメモリにバイナリデータを保持します。ワークフローがダウンロードするファイルは、メモリ使用量を増加させます。1 つのワークフローが大きな添付ファイルを数個取得するだけで、通常の JSON 処理では到達しない上限をプロセスが超えることがあります。そのため、クラッシュは一定時間の経過ではなく、特定のワークフローの実行後に発生します。

environment:
  - N8N_DEFAULT_BINARY_DATA_MODE=filesystem

filesystem を使用すると、バイナリデータは N8N_BINARY_DATA_STORAGE_PATH 配下に書き込まれます。このディレクトリはデフォルトで n8n のユーザーフォルダー内にあるため、他のデータと同じボリュームに配置されます。切り替える前に、ボリュームに十分な空き容量があることを確認してください。N8N_PAYLOAD_SIZE_MAX は、受信する webhook ペイロードの最大サイズを MiB(メビバイト)単位で設定し、デフォルト値は 16 です。値を増やすと、より大きなリクエストを受け付けられますが、その分のメモリ消費を受け入れる必要があります。

同じサーバー上で稼働する他のサービスも、同じ RAM を使用します。データベースコンテナを追加してから OOM による kill が始まった場合、データベースを Docker で実行するかホスト上で実行するかが現在選択しているトレードオフです。

再起動ポリシーと再起動後の復旧

再起動ポリシーを設定していないコンテナは、終了後も、ホストの再起動後も停止したままです。restart: unless-stoppedを設定すると、手動で停止したコンテナには介入せず、どちらの場合もコンテナを再起動できます。restart: alwaysを設定すると、意図的に停止したコンテナも、次に Docker が起動したときに再起動します。

n8n はヘルスエンドポイントを提供しています。N8N_ENDPOINT_HEALTHで指定し、デフォルト値はhealthzです。まずホストからアクセスして、使用中のインスタンスでパスが正しいことを確認してください。

curl -fsS http://127.0.0.1:5678/healthz
docker exec n8n which wget curl
sudo systemctl is-enabled docker

ヘルスチェックだけでは、何も再起動されません。Compose はコンテナを unhealthy としてマークし、そこで処理を停止します。再起動ポリシーはコンテナの終了を契機に動作するため、unhealthy になったことを理由にコンテナを再起動するには外部の監視機構が必要です。実際に動作するヘルスチェックの作成と再起動後にスタックを再度起動する方法で、それぞれの方法を説明します。

n8n は正常なのにワークフローが一度も実行されない場合

この場合、バナーも再起動も発生しません。コンテナは起動しており、エディターも動作していますが、想定していた実行が実行履歴にありません。次の 4 点を確認してください。

  • ワークフローが公開されていません。Schedule Trigger を使用するワークフローを保存して公開し、本番スケジュールが実行されるようにします。
  • タイムゾーンが自分の環境と異なります。Schedule Trigger は、まずワークフローのタイムゾーンを使用します。ワークフローにタイムゾーンが設定されていない場合は、インスタンスのタイムゾーンを使用します。GENERIC_TIMEZONE のデフォルトは America/New_York です。ワークフローのタイムゾーンを設定するか、インスタンスのデフォルトを自分のタイムゾーンに変更してください。
  • 実行が猶予期間を過ぎています。永続スケジューラーは n8n 2.45.0 以降、デフォルトで有効になっており、今後の実行をデータベースに記録します。記録済みの実行は、猶予期間内に再起動すると遅れて実行されます。猶予期間を過ぎた場合は、設定された misfire ポリシーにより、実行をスキップするか、キャッチアップ実行を行うかが決まります。従来のメモリ内スケジューラーは、停止中に実行時刻を迎えた実行をスキップします。
  • ワークフローが自動的に無効化されています。N8N_WORKFLOW_AUTODEACTIVATION_ENABLED はデフォルトで無効です。有効にすると、繰り返しクラッシュするワークフローは非公開にされます。その後は、誰も有効化していなかった場合とまったく同じ状態に見えます。

実行履歴を開き、そのワークフローで絞り込んでください。失敗したエントリがある場合は、ワークフロー側の問題です。同じホスト上で運用している別のサービスに対するリクエストが 429 で失敗していた場合、制限を設けているのは n8n ではなく、そのサービスです。SearXNG の 429 トラブルシューティングでは、そのサービス独自のレートリミッターによる制限と、エンジンがサーバーの IP アドレスをブロックしている場合とを判別する方法を説明しています。エントリがまったくない場合は、実行履歴の保存が無効になっているか、プルーニングによって記録が削除されている可能性もあります。トリガーの問題と判断する前に、これらの設定を確認してください。

最初に変更する項目

  1. ファイルを編集する前に、使用中のコンテナ内で STATUS、RestartCount、OOMKilled を確認します。
  2. コンテナが稼働し続けている場合は、n8n への到達性とデータベースの準備状態を確認します。続いて、プロキシ、認証、origin、タイムアウトに関するエラーがないか push 接続を調べます。
  3. OOMKilled が true の場合は、意図して決めたコンテナの制限値を設定します。Node の heap 上限を設定するときは、その制限値より低い値に余裕を残します。バイナリデータは filesystem に切り替えます。
  4. 何も実行されなかった場合は、ワークフローが公開済みであること、実効タイムゾーンが自分の環境と一致していること、スケジューラーと misfire の設定が想定どおりであることを確認します。

これらの大半は、動作するインストール環境の上に一度設定すれば、通常はそのまま使える項目です。まだインストールを構築中であれば、HTTPS 対応の Docker 上の n8n 手順が、これらの設定の基盤になります。

FAQ

n8n のコンテナが実行中なのに、エディターに接続切断のバナーが表示されるのはなぜですか?

エディターは、実行の進行状況をストリーミングするために WebSocket 接続を維持します。リバースプロキシが Connection: Upgrade ヘッダーと Upgrade: websocket ヘッダーを転送しない場合、または upstream に HTTP/1.1 を使用しない場合、アップグレードが完了しません。そのため、n8n が正常でもブラウザーは再接続を繰り返します。nginx では proxy_set_header の 2 行と、1.29.7 より前のリリースでは proxy_http_version 1.1 が必要です。新しいリリースでは、デフォルトで HTTP/1.1 が使用されます。proxy_read_timeout をデフォルトの 60 秒より長くすると、n8n の定期的な ping が届く時間を確保できます。ワークフローが静止しているだけで接続がアイドル状態になるわけではありません。n8n は無効な push リクエストと認証失敗も拒否するため、レスポンスとアプリケーションログを確認してください。sudo nginx -T で設定ファイルを確認し、reload が成功したことを確認します。

メモリ不足による kill と通常のクラッシュを見分けるにはどうすればよいですか?

docker inspect n8n | grep -iE 'OOMKilled|ExitCode|RestartCount' を実行し、OOMKilled フラグを確認します。True の場合、Docker はメモリ不足による kill を記録しています。対象プロセスは最後のログエントリを書き込む機会を得られませんが、それ以前のコンテナログは役立つ場合があります。False で、docker logs の末尾に fatal heap error がある場合は、Node.js が V8 ヒープを使い果たした可能性があります。コンテナの上限より小さい MiB 単位の数値を NODE_OPTIONS=--max-old-space-size=SIZE に設定し、他のメモリ使用分を残してください。これにより V8 の old space は制限されますが、カーネルによる OOM kill より前に必ず heap error が発生するとは限りません。

execution data の pruning で、すぐにディスク容量が解放されますか?

いいえ。EXECUTIONS_DATA_PRUNE は古い execution を削除対象としてマークし、その後の処理で削除します。実行される時期は EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL で設定されたスケジュールによります。SQLite では、ファイルは解放されたページをファイルシステムに返さず再利用します。そのため、行が削除された後もしばらくディスク上のサイズは変わりません。EXECUTIONS_DATA_MAX_AGE と EXECUTIONS_DATA_PRUNE_MAX_COUNT を環境に適した値に設定し、すぐにではなく翌日に再度確認してください。

スケジュールされた workflow が、n8n の再起動中に実行されなかったのはなぜですか?

デフォルトで n8n 2.45.0 から有効になっている durable scheduler は、今後の実行予定をデータベースに保存します。記録された実行は、n8n が grace period 内に復帰すると遅れて実行されます。その期間を超えると、trigger の misfire policy によって backlog をスキップするか、catch-up 実行を行うかが決まります。バージョン、scheduler の設定、Schedule Trigger のオプションを確認してください。古い in-memory scheduler を使用するインスタンスでは、停止中に予定時刻を迎えた実行はスキップされます。

healthcheck によって、応答しなくなった n8n は再起動されますか?

それだけでは再起動されません。Compose の healthcheck は、コンテナを healthy または unhealthy としてマークするだけです。restart policy はコンテナが終了したときに動作します。そのため、restart: unless-stopped を設定すると、意図的に停止したのでなく、Docker が起動する場合に限り、終了後およびホストの再起動後にコンテナが復帰します。sudo systemctl is-enabled docker で確認してください。unhealthy の状態に対して処理を行うには、ステータスを読み取り、サービスを再起動する Docker 外部の watcher が必要です。

この記事は役に立ちましたか?