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
できること
- 構築前にモード、ドメイン、SSH、タイムゾーンを確認します。
- サーバー上で新しい秘密情報を生成し、内部サービスを非公開にします。
- ヘルス、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 以降)。 |
これらの手順の出典
2026-11-14 に各ベンダーのドキュメントと照合しました:
運用上の境界
既存インスタンスにコマンドを実行する前に、対象、保守時間、バックアップを確認します。テンプレートは出発点で、正常稼働の証拠ではありません。
セルフホスト版n8nには、このMITスキルとは別のエディションとライセンス条件があります。
n8n-self-hosting に関するよくある質問
n8n-mcpは必要ですか?
構築はSSHとDockerを使います。n8n-mcpはワークフロー作成パックの一部で、サーバー構築自体には不要です。
どのモードを選びますか?
構築前に単体かキューかを明示的に選びます。キューはPostgresとRedisが必要で、SQLiteは使いません。
保存した認証情報を失う可能性はありますか?
暗号鍵を失うか変更すると失うことがあります。データとともに、保護した鍵のコピーをサーバー外へ保存してください。
HTTPヘルス応答だけで十分ですか?
いいえ。公開TLS、準備完了状態、必要な場合はワーカー環境の一致とタスクランナーも確認します。
ほかの AI スキル
関連スキル
n8n Multi Instance スキル
コミュニティ · Romuald Członkowski複数の n8n インスタンスを明示し、曖昧な MCP ルーティングから復旧します。n8n Agents スキル
コミュニティ · Romuald Członkowskin8n エージェントのツール、記憶、構造化出力、人による確認を設計します。n8n Code JavaScript スキル
コミュニティ · Romuald Członkowskin8n JavaScript Code ノードの入力と戻り値を実行モードに合わせて作成・修正します。n8n Code Python スキル
コミュニティ · Romuald Członkowskin8n 2.x Code ノード向けに、サンドボックスと実行モードの制限を踏まえた Python を書きます。n8n Code Tool スキル
コミュニティ · Romuald Członkowskiquery 入力と文字列出力を持つ、エージェント用 n8n Custom Code Tool を作ります。n8n Node Configuration スキル
コミュニティ · Romuald Członkowski最新のスキーマ、操作、プロパティの依存関係に基づいて n8n ノードを設定します。