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 虚拟机上使用 Docker Compose 和 Caddy 部署 HTTPS n8n 实例。
它区分单实例 SQLite 部署与使用 Postgres、Redis 及配对外部任务运行器的队列模式。这是运维技能,不是工作流构建器。
摘自该技能的 SKILL.md: # Deploying self-hosted n8n
功能
- 部署前收集模式、域名、SSH 和时区信息。
- 在服务器端生成密钥,并保持内部服务不对外开放。
- 验证健康状态、TLS 与工作进程,记录备份和恢复流程。
产出内容
- Compose 配置、Caddyfile 与私有环境文件。
- 部署检查结果与后续维护交接说明。
适用场景
- 在已授权的 Linux 服务器上部署 n8n。
- 修复 Python 运行器或队列工作进程配置。
不适用的场景
- 构建工作流或管理 n8n Cloud。
所需条件
- Linux 虚拟机、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 虚拟机规划单实例部署,更改前先检查 DNS 和访问权限。
- 检查队列部署的工作进程环境一致性与配对外部运行器。
- 编写保留 n8n 加密密钥的备份和恢复检查表。
如何安装 n8n-self-hosting
服务器访问
单独使用该文件夹需要 SSH 与系统操作能力。这里未验证 Claude.ai 上传或沙箱 API 能完成此工作流。
完整 n8n 插件还会添加路由与 hooks。只需部署指导时,可仅复制此文件夹,不安装整个合集。
技能(Skill)是一个包含 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 文件夹。四者在项目中都认可的文件夹是 .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 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;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łonkowski为 n8n 代理设计明确的工具、记忆、结构化输出和人工审核。n8n Code JavaScript 技能
社区 · Romuald Członkowski按执行模式编写或调试 n8n JavaScript Code 节点的数据读取与返回值。n8n Code Python 技能
社区 · Romuald Członkowski按明确的沙箱和模式限制,为 n8n 2.x Code 节点编写原生 Python。n8n Code Tool 技能
社区 · Romuald Członkowski为代理编写以 query 输入、字符串输出的 n8n Custom Code Tool。n8n Node Configuration 技能
社区 · Romuald Członkowski按实时结构、操作和属性依赖配置 n8n 节点。