n8nのバックアップで保存するもの|DockerのDB・暗号化キーと復元チェック
このページの目次(7 項目)
VPSでn8nを動かすなら、バックアップにはデータベースと、その認証情報を読み出すための暗号化キーを残します。起動設定や外部保存したファイルも、元の構成に応じて必要です。ワークフローのJSONを書き出しただけでは、利用者や実行履歴を含む環境全体は戻せません。
この記事は、Dockerでセルフホストしているn8nについて、保存対象の確認と復元後の点検を整理したものです。2026年10月12日に公式資料を確認しました。VPSBenchによるバックアップ・復元の実機試験は行っていません。復元時間や成功率の実測記事ではありません。機能やオプションは版によって異なるため、利用中のn8nとDBの版に合う仕様を確認してください。
ワークフローを移す場合と、環境全体を戻す場合
保存方法は、戻したい範囲から選びます。別環境へ一つの処理を移す場合と、VPSの故障後に運用を再開する場合では、必要なデータが異なります。
| 戻したいもの | 確認する保存方法 | それだけでは確認できないこと |
|---|---|---|
| 一つのワークフロー | エディターからのJSON出力 | 接続先の認証情報や利用者、実行履歴の復元 |
| 複数のワークフローと認証情報 | Server CLIのexport:workflowとexport:credentials | 環境全体の復元。--backupでもユーザー・権限、実行履歴・ログ、変数、暗号化キーなどの設定は含まれない |
| n8nの環境全体 | データの保存場所、暗号化キー、起動設定をそろえたバックアップ | 別の環境で起動し、必要な処理を再開できるか |
上のServer CLIは、n8nと同じ環境で使う管理用コマンドです。ネットワーク越しに操作する「n8n CLI」とは別の機能なので、手順を探すときは名称も確認してください。Server CLIの公式説明では、両者の用途と、エクスポートの範囲を区別しています。表はワークフローと認証情報のエクスポートを対象としており、DB移行向けのexport:entitiesとは区別します。
新しくインスタンス間の移動手順を組む場合、現在の公式資料はネットワーク越しに使うn8n CLIを推奨しています。ここでは既存のJSONバックアップで戻せる範囲を整理しています。移動方法の公式案内
エディターのJSONには、認証情報の名前やIDが含まれます。cURLから取り込んだHTTP Requestノードには認証ヘッダーが残る場合もあります。ワークフローだけのファイルでも、共有前に内容を確認する必要があります。公式のエクスポート時の注意
SQLiteとPostgreSQLで保存対象を確認する
まず、現在のデータベースと保存場所を調べます。SQLiteかPostgreSQLかを、利用中の起動設定で確認してください。DBを切り替えたり、暗号化キーを新しく作ったりする作業は、この確認に含めません。
| 現在の構成 | 保存対象 | 確認する場所 |
|---|---|---|
| 標準のSQLite構成 | .n8nフォルダー。DBファイルと、暗号化キーを含む設定 | Dockerのマウント設定と、実際に使われている保存先 |
| PostgreSQL構成 | PostgreSQLのバックアップと、.n8nフォルダー | DBの保存・復元方法、n8n側の永続化設定 |
| キーを環境変数で指定 | 現在使用中のN8N_ENCRYPTION_KEYを復元できる保管方法 | 起動時にキーを渡す設定。別の値に変更しない |
| ファイルや実行データをDB外に保存 | バイナリデータ・実行データの外部ストレージや独自ディレクトリー | 実際の保存設定と、その場所を戻す手順 |
| 追加ノードを使用 | 追加ノードの配置先と版 | 再配置・再導入できるか |
| すべての構成 | Composeファイルなどの起動設定と、環境変数・シークレットを復元する方法 | DB接続先、暗号化キー、外部保存先の設定 |
n8n公式のバックアップ対象一覧は、.n8nと外部DBに加え、独自のファイル保存先やカスタムノードの配置先も確認するよう案内しています。表は標準的な構成の整理であり、すべての導入テンプレートに同じボリューム名が使われるわけではありません。
バイナリデータは、画像や添付ファイルなどのデータです。保存モードや保存先を変更している場合、DBのダンプだけでそれらが戻るとは限りません。バイナリデータの保存設定で設定を照合してください。
暗号化キーは、DBに保存した認証情報を読み出すために使います。n8nは初回起動時にキーを生成して.n8nに保存し、独自のキーを指定する構成も提供しています。DBを戻しても対応するキーを用意できなければ、暗号化された認証情報を復号できません。保管の確認時に、キーの値をチャット、公開リポジトリー、スクリーンショットへ載せないようにします。バックアップや起動設定にも秘密情報が含まれるため、保管先の暗号化とアクセス制限を確認します。暗号化キーの公式説明
Dockerの永続化とバックアップを分けて確認する
Dockerのボリュームは、コンテナを作り直してもデータを残すために使います。そのボリュームが同じVPSにしかなければ、VPSごと失ったときに読み出せるコピーは残りません。別の保管先から取り出せるかも確認します。Dockerのボリュームとバックアップ
保存先の名前を記事の例から決めつけず、次の三つを対応づけて記録してください。
- n8nから見える保存ディレクトリー
- そこへ接続しているボリューム名、またはホスト側のディレクトリー
- バックアップファイルを実際に保管する場所
コンテナ内へエクスポートする場合も、その出力先が永続化されているか確認します。マウントしていない場所へ書き出したファイルは、コンテナの再作成で失われます。ファイルが一度作れたことと、障害時に取り出せることは別の確認項目です。
操作の末尾に付くオプションにも注意が必要です。docker compose downに-vを付けると、Composeで定義された名前付きボリュームと、接続された匿名ボリュームも削除の対象になります。停止や更新のつもりで、保存先を消さないようにしてください。externalとして定義したボリュームは、このコマンドでは削除されません。Docker公式のdownコマンド説明
DBに合った方法でコピーを作る
SQLiteの標準構成では、n8nを停止してから.n8nをコピーする方法が公式に案内されています。動作中のDBファイルを単純にコピーすると、整合しないバックアップになる可能性があります。停止できない場合は、SQLiteの整合したスナップショットを取得できる方法が必要です。n8n公式の保存時の注意
PostgreSQLは、DBに対応したバックアップ方法を使います。たとえばpg_dumpは、開始時点のDBの整合した内容を書き出せます。ただし、一つのDBのダンプには、DBクラスタ共通のロールなどは含まれません。復元先で必要になる利用者・所有者・権限も確認します。PostgreSQL公式のSQLダンプ
保存形式によって戻し方も変わります。SQLテキストと、pg_restoreで戻すアーカイブを混同しないように、使用したDBの版、バックアップ方法、出力形式を記録してください。n8nとDBを同時に更新しようとしている場合は、各製品の更新手順を別々に確認します。
DBと外部ファイルを別々に保存する構成では、取得時刻と対応関係も記録します。DB単体の整合性だけでは、別の時点にコピーした添付ファイルまで一致することは保証できません。復元点検では、必要な実行データからファイルを参照できるかを確かめます。
復元できたかを確認する六つの項目
復元の点検は、本番のDBやボリュームと分けた環境で行います。起動設定も確認し、本番DBや書き込み可能な本番ストレージへ誤って接続しないようにします。復元した定期処理やWebhookが、実際の顧客への通知・業務データの更新を二重に起こさないよう、n8nの起動前に実行の入口と外部への送信先を制限します。
インポート後の無効化だけで二重実行を防げるとは決めつけないでください。確認時点のServer CLI公式資料には、稼働中の構成によっては有効だったワークフローの定期実行が再起動まで残る既知の問題も記載されています。版・実行モードごとの挙動は今回試験していないため、復元先を隔離して確認します。
次の表はVPSBenchが整理した確認項目です。特定の構成での成功を保証する手順ではありません。
| 点検項目 | 残す結果 |
|---|---|
| 保存物を取り出せる | 保存日時、構成との対応、ファイルを取り出せたか。空ファイルや処理エラーの有無 |
| 元の構成を再現できる | バックアップ取得時のn8n・DBの版、マウント先、ファイルの所有者・権限、起動設定、必要な追加ノード |
| 必要なデータが戻る | 使うワークフロー、利用者・権限、必要な実行履歴や添付ファイルの確認結果 |
| 認証情報を利用できる | 対応するキーを使えているか。許可したテスト先での接続確認結果 |
| 処理を再開できる | 通知・書き込み先をテスト用にした代表処理の結果。未確認の処理は未確認と記録 |
| 許容する停止時間に収まる | 復元開始から必要な処理を再開するまでの時間と、手作業が必要だった箇所 |
画面にログインできても、外部ファイルや認証情報まで戻ったとは限りません。点検で不足が分かったら、足りない保存対象や設定を追加し、同じ項目で再確認します。テスト先を用意できない接続について、成功したことにはしません。
Server CLIのインポートでは、既存のワークフローや認証情報とIDが重なると、それらは上書きされます。また、認証情報を平文で出力する--decryptedは、保存ファイル自体に秘密情報を含める操作です。本番へ直接取り込む前に、対象と上書き範囲、保存ファイルの扱いを公式のコマンド仕様で確認してください。
更新前に残すものと、日々の確認
更新前には、その時点のバックアップと、元のn8n・DBの版、起動設定をそろえます。n8n公式は、リリースノートの変更点を読み、先にテスト環境で更新することを勧めています。n8n公式の更新案内
古いイメージへ戻す前に確認すること
更新でDBの構造が変わっていた場合、n8nのイメージだけを旧版へ戻しても、DBの構造は戻りません。npm版の公式案内でも、DB移行を伴う更新では、必要な手動変更とDBの巻き戻しを確認するよう案内しています。戻し方は版と変更内容に依存するため、対象版の手順を確認してください。
実際に、n8n 1.111.0から1.109.0へ戻した際、PostgreSQLでUser.role列が存在しないというエラーが出た個別報告があります。これは2025年9月の特定環境の報告で、すべての旧版への変更が同じ結果になるという意味ではありません。更新前の状態へ戻す準備では、次の情報をバックアップと対応づけます。
- バックアップ取得時のn8n・DBの版と、戻すイメージのタグまたはdigest
- DB、暗号化キー、起動設定、外部ファイルそれぞれの保管先と、同じ構成に対応すること
- 保存したデータの時点とタイムゾーン。DBと外部ファイルの取得時刻が異なる場合は、その差
- 戻した環境で確認する代表処理と、確認中に本番の通知・書き込みを起こさない方法
バックアップに残らない処理を照合する
バックアップに含まれない変更や実行記録は、そのバックアップを戻すだけでは復元できません。一方、n8nが外部サービスへ送信済みの通知や書き込みは、n8nのDBを戻しても取り消されません。復元後の実行履歴に見当たらないことだけを理由に処理を再実行すると、同じ通知や登録を繰り返すおそれがあります。
照合対象は、保存時点ですでに処理中だったもの、その後にn8nが受けたもの、停止中に送信元で発生してまだ届いていないものです。送信元の履歴と通知・登録先の結果を、イベントIDや注文番号などで対応づけ、どこまで処理されたかを個別に確認してください。
- 必要な外部処理がすべて完了したと確認できたものは、再実行の対象から外す
- 未処理と確認できたものは、送信元の再送方法と重複防止の仕組みを確認してから再処理する
- 一部だけ完了したものや処理状況が分からないものは、全体の再実行を保留する。完了済みの処理を繰り返さない方法を確認して、未完了部分の扱いを決める
これはVPSBenchが整理した復旧時の確認案です。送信元に履歴や再送機能がない場合もあるため、すべてのイベントを回収できるとは限りません。更新・切り戻しやイベント再処理の実機試験は未実施です。この二つの小節は2026年10月13日に資料を照合しました。
日々の保存間隔は、失っても再入力できる変更の量と、運用を止められる時間から決めます。決めた時刻に実行されたか、最後に成功した保存はいつか、保管先へ取り出しに行けるかを確認し、保存先の容量不足や認証切れも点検の対象にします。取得の成功記録だけで終えず、復元確認の日付と未確認項目も残してください。
容量の選定を続ける場合は、n8nを1GB・2GB・4GBで測った記事を参照できます。そちらはメモリと処理件数の測定であり、本稿のバックアップや復元を実測したものではありません。
復元を試す環境を用意する
復元の確認は、本番とは別の環境で行います。手元に使える環境がなければ、時間課金のVPSを確認する間だけ借りる方法があります。保存時と同じn8nとDBの版をそろえ、通知や書き込みが外部へ送られない設定にしてから戻してください。
ConoHa VPSは新規受付を一時停止中です
2026年11月14日から、新しい申し込みを受け付けていません。再開の日は決まっておらず、公式のお知らせで案内されます(2026年11月15日確認)。ConoHa VPS公式のお知らせ
これから新しくVPSを借りる場合は、各社の受付状態を2GB VPSの比較で、時間課金や短い契約で借りたときの費用を契約期間ごとの料金の記事で確かめてください。