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

NodをVPSにDocker Composeで構築する方法

n8nチームのApache-2.0エージェントNodをVPSへ導入します。Docker Composeでタグを固定し、ポート4310を非公開にする方法と、復元に必要なVault keyのバックアップを解説します。

Nod の概要と構築するもの

Nod は、n8n を開発したチームによる個人用 AI エージェントです。専用リポジトリにある Docker Compose キットを使い、VPS 上で実行できます。このガイドでは、キットをタグ nod-v0.8.1 に固定し、アプリをプライベートポートで待ち受けさせます。SSH トンネルまたは HTTPS 経由でアクセスします。保存した認証情報は 1 つのキーなしでは復元できないため、バックアップの手順もインストールに含めています。

README では、Nod を独自のコンピューターとブラウザーを備えたエージェントとして説明しています。「実際の Web サイト上で請求書を追跡し、通話の準備をし、トライアルをキャンセルします。選択したモデルを使って自分のマシン上で動作し、ユーザーに代わって操作する前に確認を求めます。」Nod とは 1 つのチャットで会話します。独自の Linux ワークスペースとブラウザーを持ち、Gmail、Calendar、Slack、Notion、Web に接続します。

インストール前に、2 つの点を理解しておく必要があります。1 つ目は、README が Nod を「research preview」と位置付けていることです。ドキュメントサイトにも「Early preview」というバナーがあり、「Expect rough edges and breaking changes.」と記載されています。2 つ目は、README が Nod の安全確認を「is a model's judgement」と説明していることです。プレビュー用のツールとして扱ってください。テストに使用してもよいアカウントだけにアクセスを許可してください。

Nod に VPS が適している理由は単純です。ドキュメントによると、Nod を実行しているマシンの電源が入っている間だけスケジュールが実行されます。ラップトップはスリープします。サーバーはスリープしません。

Nod と n8n AI Agent ワークフローの違い

Nod は n8n AI Assistant ではなく、実行に n8n は必要ありません。README では「n8n は必要ですか」という質問に対して、「いいえ。Nod は n8n の開発チームが作った独立したアプリです。n8n AI Assistant ではありません」と回答しています。

n8n のドキュメントでは、AI Agent node を次のように説明しています。「チャットモデルと 1 つ以上のツールを接続すると、エージェントがタスクを完了するために呼び出すツールを判断します。」このエージェントは n8n editor 内で構築し、少なくとも 1 つの tool sub-node を接続する必要があります。この構成が必要な場合は、n8n で AI Agent node ワークフローを構築するで説明しています。Docker と HTTPS を使って VPS で n8n をセルフホストするでは、その構築に使う n8n server を用意する方法を説明しています。

ここでは、2 つのドキュメント群を次のように読み分けています。AI Agent node は、n8n 内で node ごとに設計する 1 つのエージェントです。一方、Nod は独自の workspace と browser を備えた完成済みの chat app で、タスクを自然言語で指示します。両者を比較するベンダー公式ページはないため、これは公式見解ではなく要約としてお読みください。

両者を連携させることもできます。Nod の n8n ページには、「n8n を 1 回接続すれば、chat で名前を指定して呼び出せます」とあります。Nod はその後、「指定した tools と channel を備えた n8n Agent」を構築できます。依頼に n8n が含まれていない場合、Nod は独自の tasks と schedules を使用します。

ライセンス: Nod は Apache-2.0、n8n は異なる

Nod のリポジトリ github.com/n8n-io/nod は Apache License 2.0 の下で公開されており、著作権者は n8n GmbH です。README のフッターには「Copyright 2026 n8n GmbH · Apache License 2.0」と記載されています。Geist フォント、プロバイダーのロゴ、デスクトップランタイムのコンポーネントなど、同梱されているサードパーティ製アセットには、それぞれ独自のライセンス条件が適用されます。

n8n 自体は別のライセンスを使用しています。.ee. のマークが付いたファイルを除くコードは、Sustainable Use License の下で提供されています。主な制限は、次の一文です。「このソフトウェアは、自社の内部業務目的、または非商用目的もしくは個人的な目的に限り、使用または変更できます。」Apache-2.0 には、Nod の使用方法に関するこのような制限はありません。n8n を基盤に何を構築できるか判断する場合は、製品の計画を立てる前に n8n Sustainable Use License の解説を確認してください。

Nod の実行に必要な VPS の要件

セルフホスト用ドキュメントでは、Docker Engine 25 以降と Compose v2、OpenSSL、sha256sum または shasum が必要とされています。ソースからビルドする場合は Git も必要です。サポート対象のホストは、AMD64 または ARM64 の Linux、または Docker Desktop を実行する Mac です。

サイズについて、ドキュメントには「CPU 2 コア、メモリ 8 GB、ディスク 50 GB から始める」とあります。これは推奨される開始時の構成であり、計測された最小要件ではありません。ブラウザータスクとローカルモデルを同時に実行する場合は、より大きな容量が必要になるとも説明されています。キットの compose.yaml で、メモリ容量の大部分を説明できます。サーバーコンテナの上限は 2 GB、ブラウザーの上限は 3 GB、workspace の上限は 2 GB です。これらの上限は、.env 内の NOD_SERVER_MEMORY、NOD_BROWSER_MEMORY、NOD_WORKSPACE_MEMORY で変更できます。Postgres と Caddy には上限がありません。

インストールにモデル API key は必要ありません。サーバーの起動後に、アプリでモデルを接続します。

サーバーに Docker がない場合は、先にインストールします。VPS での Docker Compose の基本で手順を説明しています。次にバージョンを確認し、ほかのツールを追加します。

docker version
docker compose version
sudo apt update && sudo apt install -y git openssl

docker version の Server: セクションには、25 以降のバージョンが表示される必要があります。また、docker compose version は成功する必要があります。以下のコマンドは、ユーザーが sudo なしで docker を実行できることを前提としています。実行できない場合は、docker および sh コマンドの前に sudo を追加します。

Nod リポジトリを固定したタグで clone する

キットは deployment/self-host/ にあり、checkout した内容から Nod のイメージをビルドします。Nod 固有のものをレジストリから取得することはないため、checkout するタグが実行するバージョンになります。

git clone https://github.com/n8n-io/nod.git
cd nod
git checkout nod-v0.8.1
cd deployment/self-host
ls

ls には、ほかのファイルとともに setup.sh、compose.yaml、Caddyfile、backup.sh、restore.sh が含まれているはずです。タグ nod-v0.8.0 と nod-v0.8.1 は、いずれも 16 November 2026 に作成されたものです。これらは最新ではありません。21 November 2026 時点では、nod-v0.9.1(20 November)が Latest としてマークされています。このガイドは nod-v0.8.1 キットを基準に確認しているため、このタグを固定します。以下の更新セクションでは、先に進む方法を説明します。

compose.yaml に含まれるサードパーティーイメージは、:latest ではなくダイジェストで固定されています。対象は postgres:17-alpine、node:24.21.0-bookworm-slim、caddy:2.11.7-alpine です。Nod イメージには、デフォルトで local タグが付きます。これは NOD_IMAGE_TAG を通じて設定されます。この変数を設定しても、公開されたリリースはダウンロードされません。

setup.sh で Secret を生成する

sh setup.sh

setup.sh にフラグはありません。.env.example を非公開の .env にコピーし、Compose プロジェクト名、NOD_AUTH_TOKEN(openssl rand -hex 32 から取得)、NOD_VAULT_KEY(openssl rand -base64 32 から取得)、NOD_POSTGRES_PASSWORD の4つの生成値を設定します。その後 chmod 600 .env を実行するため、ファイルを読み取れるのは自分のユーザーだけです。

最後に Ready. Run: docker compose --file compose.yaml --env-file .env up -d --build --wait を出力します。.env がすでに存在する場合は、そのファイルを保持して Using the existing .env. Its keys and data are unchanged. を出力します。シェルですでに NOD_AUTH_TOKEN、NOD_VAULT_KEY、NOD_POSTGRES_PASSWORD のいずれかが設定されている場合、実行を拒否します。いずれかを export している場合は、先に unset してください。古い Docker では Use Docker Engine 25 or newer. で停止します。

スタックをビルドして起動する

docker compose up -d --build --wait
docker compose ps

最初のビルドには時間がかかります。kit がソースから Nod イメージをビルドするためです。コマンドが終了するまで、ターミナルを開いたままにしてください。--wait は、ヘルスチェックが設定されたサービスから healthy が報告されるまで待機します。そのため、エラーなしで戻ればスタックは起動しています。docker compose ps では、server、postgres、browser などのサービスが running として表示され、server は healthy と表示されます。

setup.sh の前に docker compose up を実行すると、Compose は起動を拒否し、Run sh setup.sh first を出力します。これは、compose.yaml が NOD_AUTH_TOKEN を必須として指定し、setup.sh だけがそれを書き込むためです。

サーバーログを確認するには、次のコマンドを実行します。

docker compose logs --tail 100 server

ドキュメントによると、トークンが起動時のログに出力されることはありません。

ポート 4310 は loopback にバインドし、ufw による保護を前提にしない

サーバーは compose.yaml で、ホストのポートを次のように公開しています。

'${NOD_BIND_ADDRESS:-127.0.0.1}:${PORT:-4310}:${PORT:-4310}'

そのため、Nod はポート 4310 で待ち受け、ホスト側は 127.0.0.1 にバインドされます。接続できるのはサーバー自身のプロセスだけです。この構成を維持してください。

これは見た目以上に重要です。Docker が公開するポートは ufw を迂回するためです。Docker のドキュメントには、公開されたコンテナポートへのトラフィックは「ufw のファイアウォール設定を通過する前に転送される」とあり、「実質的にファイアウォール設定を無視する」と説明されています。ufw deny 4310 ルールでは、すべてのインターフェースで公開されたポートを保護できません。4310 を非公開に保つのは loopback へのバインドです。Docker のポートが ufw を迂回する理由では、その仕組みと自分のサーバーでの確認方法を説明しています。

Docker にはバージョンに関する注意点もあります。28.0.0 より前のリリースでは、同じ layer 2 ネットワークセグメント上のホストから localhost に公開されたポートへ接続できます。VPS では、そのセグメントはプロバイダーのネットワークです。可能であれば、Docker 28 以降を使用してください。

リモートからアプリに接続するために、NOD_BIND_ADDRESS を 0.0.0.0 に変更しないでください。ドキュメントにも「PostgreSQL、ブラウザー、workspace、Docker connection は決して公開しないでください」とあります。以下の 2 つのアクセス経路のいずれかを使用してください。

SSH トンネルで Nod を開く

このトンネルにドメインは不要で、SSH 以外のポートを開く必要もありません。次のコマンドはサーバーではなく、自分のコンピューターで実行します。

ssh -L 4310:127.0.0.1:4310 user@203.0.113.10

そのセッションを開いたままにし、ローカルブラウザーで http://localhost:4310 にアクセスします。この構成では NOD_PUBLIC_URL をローカルのデフォルト値である http://localhost:4310 のままにします。PORT を変更した場合は、トンネルの両側とブラウザーのアドレスを同じ値に変更します。

アプリは access token を要求します。サーバーで次のコマンドを実行して表示します。

grep NOD_AUTH_TOKEN .env

= の後に値を入力フォームへ貼り付け、初期設定を完了してモデルに接続します。トンネル経由でも token は必要です。

代わりに Tailscale 経由でサーバーへ接続する場合は、Nod の前段に何かを配置する前に Tailscale Serve と Funnel の違い を確認してください。Funnel はサービスを public internet に公開するためです。

Nod を Caddy プロファイルで HTTPS 配信する

公開アドレスで使用する場合、kit には https プロファイルがあります。このプロファイルは、TLS (transport layer security) 証明書を取得・更新し、サーバーへトラフィックを転送する Caddy コンテナを追加します。VPS を指す DNS レコードを持つドメインが必要です。プロバイダーのネットワークファイアウォールがある場合は、受信 TCP 80 と 443 も開放する必要があります。

.env を編集し、正確な origin を設定します。

NOD_PUBLIC_URL=https://nod.example.com

NOD_PUBLIC_URL は「Nod を開く正確な origin」です。スキームとホストだけを記述してください。パス、クエリ文字列、フラグメントは拒否されます。このプロファイルでは、ポート 443 上の https:// origin が必要です。DNS 名または IPv4 ホストを使用してください。続いて、プロファイルを指定して stack を起動します。

docker compose --profile https up -d --build --wait

以降の start、stop、status コマンドにも --profile https を付けてください。付けない場合、Compose は Caddy コンテナを除外します。https://nod.example.com を開き、上記と同じ方法で token を貼り付けます。

この設定で何が公開されるかを把握してください。Caddy サービスは bind address を指定せずに 80:80、443:443、443:443/udp を公開するため、これらのポートはすべてのインターフェースで待ち受けます。PORT の内容に関係なく、常にホストのポート 80 と 443 を使用します。前述の Docker によるバイパスがあるため、ufw ではこれらのポートを閉じられません。すでに reverse proxy を運用している場合は、このプロファイルを使用しないでください。proxy の転送先を 127.0.0.1:4310 にし、NOD_PUBLIC_URL には proxy の HTTPS origin を設定します。

使用状況データとフィードバック: 有効になっている項目を確認する

ドキュメントには「新しい所有者では使用状況の共有が有効」と記載されています。データは、独立したインストールからのデータも含めて、Nod チームが EU でホストする PostHog プロジェクトに送信されます。デプロイメント側でもこれを許可する必要があり、NOD_ANALYTICS_ENABLED=false を指定すると常に無効になります。

nod-v0.8.1 のキットは NOD_ANALYTICS_ENABLED=false を .env.example に含めて提供され、setup.sh はその行を .env にコピーします。そのため、このガイドから新規インストールすると、サーバーレベルのアナリティクスは無効になっています。次のコマンドで確認します。

grep -n NOD_ANALYTICS_ENABLED .env

行がないか空の場合、サーバーは production mode で実行するたびにアナリティクスを許可します。古い .env や手作業で作成した .env では、この状態になることがあります。その場合は、行を自分で false に設定します。

フィードバックコレクターは別の機能です。NOD_FEEDBACK_ENABLED は .env.example に含まれておらず、ドキュメントではデフォルトで有効とされています。ドキュメントには完全なオプトアウト方法も記載されています。アナリティクスとフィードバックを false に設定し、NOD_ONBOARDING_EMAIL_URL は空のままにします。

echo 'NOD_FEEDBACK_ENABLED=false' >> .env
grep -n -e NOD_ANALYTICS_ENABLED -e NOD_FEEDBACK_ENABLED -e NOD_ONBOARDING_EMAIL_URL .env
docker compose up -d --wait server

最後のコマンドで、新しい値を指定してサーバーを再作成します。使用している場合は --profile https を追加します。所有者は、アプリの Settings、Privacy & data、Share usage data から共有を切り替えることもできます。共有を停止しても、すでに送信されたデータは削除されません。

Vault の鍵とデータをバックアップする: この手順は省略できません

NOD_VAULT_KEY は「保存済みの認証情報を暗号化する base64 32-byte の鍵」です。これはデータベースの外部にある .env に保存されます。Vault のドキュメントには「この鍵がなければ、保存済みの認証情報を読み取れません」と記載されています。暗号化済みのデータが存在すると、Nod は代替の鍵を生成しません。self-host ページにも「データベースだけでは保存済みの認証情報を復元できません」と記載されています。鍵を失うと、完全なデータベースダンプがあっても、Nod に登録したすべてのログイン情報を失います。

そのため、まず鍵だけをサーバー外のパスワードマネージャーなど、安全な場所に保存します。

grep NOD_VAULT_KEY .env

次に、キットのスクリプトで完全バックアップを作成します。保存先には、まだ存在していない絶対パスを指定する必要があります。

mkdir -p "$HOME/nod-backups"
chmod 700 "$HOME/nod-backups"
sh backup.sh "$HOME/nod-backups/nod-2026-11-21"

このスクリプトはコピー中に server、browser、workspace を停止し、完了後に再度起動します。Backup saved: とパスを出力します。ディレクトリには .env、source-commit、postgres.dump、server、workspace、tools、browser data のアーカイブ、および complete マーカーファイルが含まれます。バックアップを信頼する前に、このマーカーファイルが存在することを確認してください。

ドキュメントには「バックアップには Secret が含まれます」と記載されています。生成されたすべての Secret が含まれ、Vault の鍵も含まれます。暗号化して保存し、読み取り権限を持つユーザーを制限してください。バックアップをサーバー外にもコピーしてください。同じディスク上にあるバックアップは、ディスク障害とともに失われるためです。TLS 証明書は含まれません。

新しいチェックアウトへ Nod を復元する

復元先は新しいフォルダーと新しい Compose プロジェクトです。バックアップ取得元のコミットを確認し、そのコミットを正確にチェックアウトします。

commit="$(cat "$HOME/nod-backups/nod-2026-11-21/source-commit")"
git clone https://github.com/n8n-io/nod.git nod-restored
cd nod-restored
git checkout "$commit"
cd deployment/self-host
sh restore.sh "$HOME/nod-backups/nod-2026-11-21" nod-restored

最初に setup.sh を実行しないでください。restore.sh には .env のないチェックアウトと、チェックアウトしたリビジョンに一致する source-commit が必要です。新しいボリュームを作成してデータベースを復元しますが、アプリは起動しません。最後に Restored into a new project. Review .env before starting Nod. で終了します。

復元したサーバーを起動する前に、元のサーバーを停止してください。その後、公開アドレスには --profile https を指定して docker compose up -d --build --wait を実行します。保持するサーバーでは docker compose down --volumes を絶対に実行しないでください。データボリュームが削除されます。

新しいタグへ Nod を更新する

最初にバックアップを取得します。次に、nod/deployment/self-host で以下を実行します。

docker compose stop
git fetch origin --tags
git checkout nod-v0.9.1
docker compose up -d --build --wait

データベースのマイグレーションは Nod の起動時に実行されるため、古いタグを checkout して更新を取り消すことはできません。ドキュメントにも「アップグレード済みのデータベースを、古いアプリケーションバージョンに接続しないでください」と記載されています。ロールバックするには、更新前のバックアップを新しい checkout にリストアします。preview ラベルでは破壊的変更が想定されるため、更新するたびにリリースノートを確認してください。更新中に COMPOSE_PROJECT_NAME を変更しないでください。

アクセス token をローテーションするには、openssl rand -hex 32 を実行し、.env 内の NOD_AUTH_TOKEN の値を置き換えてから、docker compose up -d --wait server を実行します。古い token は使用できなくなります。アクセスをローテーションするために NOD_VAULT_KEY を置き換えないでください。

FAQ

Nod の実行に n8n は必要ですか?

いいえ。README によると、Nod は n8n の開発チームが作成した独立したアプリケーションであり、n8n AI Assistant ではありません。Nod は独自の Docker Compose スタックで動作します。後から n8n のインスタンスに接続し、名前を指定して利用するよう Nod に依頼することはできますが、インストールに n8n は必要ありません。

Nod は n8n と同じライセンスでオープンソースとして提供されていますか?

いいえ。Nod は Apache License 2.0 の下で提供され、著作権者は n8n GmbH です。含まれているサードパーティーのアセットには、それぞれのライセンス条件が適用されます。.ee. ファイル以外の n8n のコードは Sustainable Use License の下にあり、社内業務、非商用または個人目的に利用を制限しています。Apache-2.0 にはこのような利用制限はありません。

ドメインなしで VPS 上の Nod を開くにはどうすればよいですか?

自分のコンピューターから SSH トンネルを使用します: ssh -L 4310:127.0.0.1:4310 user@203.0.113.10。トンネルを開いたまま http://localhost:4310 にアクセスし、サーバーの .env から NOD_AUTH_TOKEN を貼り付けます。NOD_PUBLIC_URL はローカルのデフォルト値のままにします。ポート 4310 はサーバー上の loopback にのみバインドされるため、新たに外部公開されるものはありません。

NOD_VAULT_KEY を失うとどうなりますか?

保存済みの認証情報を再び読み取れなくなります。このキーは認証情報を暗号化し、データベースの外にある .env に保存されます。暗号化済みのデータが存在する場合、Nod は交換用のキーを生成しないため、データベースのダンプだけでは復旧できません。キーのコピーをサーバー外に保管してください。バックアップには .env とキーが含まれるため、sh backup.sh も絶対パスで実行してください。

ufw は Nod のポートを保護しますか?

Docker が公開するポートは保護しません。Docker は ufw のルールを迂回して、公開されたコンテナポートへトラフィックを転送します。ポート 4310 がプライベートのままになるのは、compose.yaml が 127.0.0.1 にバインドするためです。https プロファイルはすべてのインターフェースで 80、443、443/udp を公開するため、ufw でこれらを閉じることはできません。28.0.0 より古い Docker では、同じ layer 2 セグメント上のホストから localhost に公開されたポートへも到達できます。

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