コンテンツへスキップ

n8n セルフホスティング スキル

Docker版n8nをデプロイ・保守し、Caddy HTTPS、非公開サービス、検証済みバックアップを整えます。

コミュニティ · Romuald Członkowski
作者Romuald Członkowski
ライセンスMIT
ソースczlonkowski/n8n-skills · GitHub 上の SKILL.md
プロジェクトサイトdocs.n8n.io/deploy/host-n8n
対応環境Claude Code · Codex、Gemini CLI、Cursor、Copilot
ソースを確認した日

n8n-self-hostingは新しいLinux VMからDocker ComposeとCaddyを使い、HTTPSのn8nを構築する手順をエージェントに示します。

単体SQLite構成と、Postgres・Redis・外部タスクランナーを組み合わせるキュー構成を分けます。運用向けで、ワークフロー作成用ではありません。

スキルの SKILL.md より: # Deploying self-hosted n8n

これは Romuald Członkowski によるコミュニティスキルで、当サイトや Anthropic による確認は受けていません。スキルはエージェントにコードの実行、ファイルの読み取り、ネットワークへのアクセスを指示できます。インストール前に SKILL.md とフォルダー内のすべてのスクリプトを読み、説明と食い違う動作がないか確認してください。

できること

  1. 構築前にモード、ドメイン、SSH、タイムゾーンを確認します。
  2. サーバー上で新しい秘密情報を生成し、内部サービスを非公開にします。
  3. ヘルス、TLS、ワーカーを検証し、バックアップと復元を文書化します。

得られるもの

  • Compose設定、Caddyfile、非公開の環境ファイル。
  • デプロイ確認結果と稼働後の保守引き継ぎ。

使う場面

  • 許可されたLinuxサーバーへn8nを構築する場合。
  • Pythonランナーやキューワーカー設定を修正する場合。

向かない場面

  • ワークフロー作成やn8n Cloudの管理。

必要なもの

  • Linux VM、rootまたはsudoでのSSH、ドメインDNS、公開ポート80/443。
  • Docker ComposeとCaddy。サーバー、ドメイン、任意のn8n有料機能は別費用です。

スキルに含まれるファイル

ファイル・フォルダー用途
SKILL.mdモード選択と構築順序。
TASK_RUNNERS.md外部Python・JavaScriptランナーの設定。
DAY2.md更新、バックアップ、復元手順。
assets/単体・キュー用のCompose、Caddy、環境設定テンプレート。

2026-11-17 時点でリポジトリに記載されていたライセンス:MIT。

プロンプト例

インストール後に次のいずれかを入力してください。スキル名を書くと確実にそのスキルが使われます。

  • 私のLinux VMに単体構成を計画し、変更前にDNSとアクセス権を確認してください。
  • キュー構成のワーカー環境の一致と、対応する外部ランナーを確認してください。
  • n8n暗号鍵を保持するバックアップ・復元チェックリストを作ってください。

n8n-self-hosting のインストール方法

サーバーへのアクセス

個別フォルダーの利用にはSSHとシステム操作が必要です。Claude.aiへのアップロードやサンドボックスAPIでの全工程は、ここでは検証していません。

n8nプラグイン全体はルーターやフックも追加します。構築ガイドだけなら、全パックではなくこのフォルダーのみコピーできます。

スキルは SKILL.md ファイルを含むフォルダーです。インストールは一度だけで、エージェントは各セッションの開始時に短い説明を読み、リクエストが当てはまったときにだけ完全な指示を読み込みます。使う環境を選んでください:

Claude Code:スキルフォルダーにフォルダーをコピー

このパソコン上のすべてのプロジェクトで使うならスキルのフォルダーを ~/.claude/skills/ に、作業者全員で共有するならリポジトリ内の .claude/skills/ に置きます(コミットしてください)。

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p ~/.claude/skills
cp -R n8n-skills/skills/n8n-self-hosting ~/.claude/skills/

Claude Code はセッション中にこれらのフォルダーで新しいスキルや変更されたスキルを検出します。セッション開始時にスキルフォルダーが存在しなかった場合は、/reload-skills を一度実行してください。その後 /n8n-self-hosting と入力するか、作業内容をそのまま伝えます。

Windows では Git Bash または WSL でコマンドを実行するか、エクスプローラーで同じ場所にフォルダーをコピーしてください。

Codex、Gemini CLI、Cursor、GitHub Copilot

これらのエージェントも同じ SKILL.md フォルダーを読みます。4 つすべてがプロジェクト内で読むフォルダーは .agents/skills/ なので、次のコマンドでスキルをそこにコピーします:

git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git
mkdir -p .agents/skills
cp -R n8n-skills/skills/n8n-self-hosting .agents/skills/
エージェントプロジェクトのフォルダーユーザーのフォルダーメモ
OpenAI Codex
.agents/skills/
~/.agents/skills/
$ と入力するか /skills を実行してスキルを選びます。タスクが当てはまれば Codex が自動で選ぶこともあります。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
または gemini skills install <git URL> --path <folder> --consent で Git からインストールします。Google は 2026 年 6 月 18 日、無料枠と Google One のユーザー向けに Gemini CLI を Antigravity CLI に置き換えました。Antigravity はプロジェクトでは .agents/skills/、ユーザー用には ~/.gemini/config/skills/ を使います。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Agent チャットで / を入力してスキルを選びます。Cursor は Claude Code の .claude/skills/ フォルダーも読みます。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Copilot CLI、クラウドエージェント、VS Code・Visual Studio・JetBrains のエージェントモードで動きます(IDE の対応はバージョンによります)。または gh skill install OWNER/REPOSITORY SKILL を実行します(パブリックプレビュー、GitHub CLI 2.90.0 以降)。
信頼できるスキルだけをインストールする. Anthropic は、信頼できる入手元のスキルだけを使い、それ以外のスキルは使う前にすべてのファイルを読むよう勧めています。スキルは、説明に書かれていない方法でエージェントにコマンドの実行、ファイルの読み取り、データの送信を指示できるからです。

これらの手順の出典

2026-11-14 に各ベンダーのドキュメントと照合しました:

運用上の境界

既存インスタンスにコマンドを実行する前に、対象、保守時間、バックアップを確認します。テンプレートは出発点で、正常稼働の証拠ではありません。

セルフホスト版n8nには、このMITスキルとは別のエディションとライセンス条件があります。

n8n-self-hosting に関するよくある質問

n8n-mcpは必要ですか?

構築はSSHとDockerを使います。n8n-mcpはワークフロー作成パックの一部で、サーバー構築自体には不要です。

どのモードを選びますか?

構築前に単体かキューかを明示的に選びます。キューはPostgresとRedisが必要で、SQLiteは使いません。

保存した認証情報を失う可能性はありますか?

暗号鍵を失うか変更すると失うことがあります。データとともに、保護した鍵のコピーをサーバー外へ保存してください。

HTTPヘルス応答だけで十分ですか?

いいえ。公開TLS、準備完了状態、必要な場合はワーカー環境の一致とタスクランナーも確認します。

ほかの AI スキル

関連スキル

スキルのカテゴリー