自动化与运维

n8n 自托管部署助手

在 Linux 服务器上通过 Docker、Caddy 和自动 HTTPS 部署生产级自托管 n8n。

46/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code · Claude.ai(部分支持)
Star 数
★ 6.4k
最近更新
19 天前
License
MIT
n8ndocker-composeself-hostingcaddy
+4reverse-proxyautomatic-httpsqueue-modelinux-server

这个 Skill 能做什么,适合哪些场景?

这个技能面向希望在自己的 VPS 或 Linux 服务器上运行 n8n 的用户。它通过 SSH 将全新的 Ubuntu/Debian 类 Linux 虚拟机部署为带 HTTPS 的 Docker Compose n8n 实例,并支持单实例模式和队列模式。流程涵盖 DNS 与端口预检、Docker 安装、模板部署、密钥生成、启动、TLS 验证以及更新、备份、恢复和加固。它不用于 n8n Cloud,也不用于构建 n8n 工作流。

通过 SSH 检查目标系统、DNS、公网 IP、80/443 端口和防火墙;必要时安装 Docker Engine 与 Compose 插件;将 Compose、Caddyfile、环境变量示例和队列初始化脚本写入服务器;在目标服务器本地生成 n8n 加密密钥及队列模式所需的数据库密钥;配置单实例 SQLite 或队列模式的 Redis、Postgres、主进程和 workers;启动服务并检查容器状态、n8n healthz、Caddy 证书和公开 HTTPS 可达性;提供加密密钥交接及更新、备份、恢复和安全加固提示。

适合
  • 个人或小团队希望在 Hetzner、DigitalOcean、AWS EC2 或裸机上运行轻量 n8n,选择单实例模式并使用 SQLite。
  • 预计有较高执行量、长时间运行任务或需要横向扩展的团队,在 Linux 服务器上部署 Redis、Postgres 和多个 n8n workers 的队列模式。
  • 需要为自托管 n8n 配置域名、Caddy 反向代理和 Let's Encrypt 自动 HTTPS 的运维人员。
  • 已有 n8n 实例、需要规划更新、备份、恢复或安全加固流程的管理员。

如何安装这个 Skill?

使用前请注意
  • 执行前必须获得用户对远程SSH操作、Docker安装、防火墙变更、公开域名/TLS和服务启动的明确确认,并核对目标主机与数据目录。
  • 材料未包含SKILL.md引用的Caddyfile和.env示例,不能仅凭本次静态证据确认端到端部署可复现。
  • 队列模式恢复依赖数据库备份与原始N8N_ENCRYPTION_KEY;升级后的数据库迁移可能使降级不可行。
  • 部署依赖Docker镜像、DNS、Let's Encrypt和外部文档服务;中国大陆网络可达性与替代方案未被说明。
  • 不要直接采用init-data.sh处理不受信任的数据库用户名或密码;应先审查SQL转义和注入风险。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • Docker Engine
  • Docker Compose
  • Caddy
  • OpenSSL
  • SSH
  • UFW

该技能随 czlonkowski/n8n-skills 仓库安装,而不是在源材料中单独提供安装命令。Claude Code 推荐使用 /plugin install czlonkowski/n8n-skills;手动安装可执行 git clone https://github.com/czlonkowski/n8n-skills.git,再执行 cp -r n8n-skills/skills/* ~/.claude/skills/ 并重新加载 Claude Code。使用前还需要按仓库说明配置 n8n-mcp MCP server;该部署技能本身的 SKILL.md 没有声明会调用 MCP。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/czlonkowski/n8n-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/n8n-self-hosting" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

向已加载该技能的助手提出明确请求,例如:Deploy n8n on my server with Docker Compose、Set up self-hosted n8n in queue mode 或 Back up and harden my n8n instance。助手会先要求选择 single/regular 或 queue 模式,再收集 SSH 目标、域名、Let's Encrypt 邮箱和时区,然后按预检、部署、启动和 HTTPS 验证流程执行。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖从全新 Linux VM 到 HTTPS n8n 实例的端到端流程。
  • 同时提供单实例 SQLite 和 Redis/Postgres/workers 队列模式。
  • 明确要求在目标服务器生成新密钥,并避免公开 n8n、Postgres 和 Redis 端口。
  • 包含 DNS、云防火墙、TLS、健康检查以及更新、备份和恢复注意事项。
局限
  • 要求用户拥有 root 或 sudo SSH 访问权、可控域名以及公网可访问的 80/443 端口。
  • 目标环境限定为新鲜的 Ubuntu/Debian 类 Linux VM;源材料没有说明 Windows、macOS 或其他发行版的支持。
  • 队列模式需要更高资源,源材料给出的粗略内存下限约为 4 GB,且每个 worker 约需 1–2 GB。
  • 技能明确不覆盖 n8n Cloud 或工作流构建;源材料也没有提供独立于 Claude Code 的详细安装流程。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
n8n 自托管部署助手 本页 46 · 谨慎使用 ★ 6.4k 19 天前 MIT
NVIDIA AI-Q 部署助手 ✓ NVIDIA · 官方 57 · 谨慎使用 ★ 3.6k 13 天前 Apache-2.0
VSS 视频嵌入部署技能 ✓ NVIDIA · 官方 57 · 谨慎使用 ★ 3.6k 13 天前 Apache-2.0
VSS 多摄像头三维检测追踪部署 ✓ NVIDIA · 官方 56 · 谨慎使用 ★ 3.6k 13 天前 Apache-2.0
AutoMagicCalib 校准栈启动器 ✓ NVIDIA · 官方 54 · 谨慎使用 ★ 3.6k 13 天前 Apache-2.0

与 n8n Cloud 相比,它针对用户自行管理的 Docker n8n 服务器;与仓库中的工作流构建技能相比,它专注于部署、运维和安全,而不是创建工作流。

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
谨慎使用
46/ 100 五分制 2.3 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全14 / 25 · 2.8/5

证据显示其要求目标机生成新密钥、将.env设为600、避免提交密钥、隔离内部端口、执行DNS/端口预检并提醒备份与首个所有者注册,降低了明显风险。扣11分:没有在SSH、Docker安装、修改防火墙和启动服务前规定明确的最终用户确认;部署需要对远程主机执行高影响操作;回滚仅部分安全;init-data.sh直接插入环境变量到SQL,缺少稳健的转义与校验;来源归因虽有官方文档链接,但未提供可核验的固定来源证据。

2可靠稳定6 / 20 · 1.5/5

证据显示流程顺序、模式分支、健康检查、TLS重试和异常提示较完整。扣4分:本次静态材料未提供可执行复现;SKILL.md引用的Caddyfile、.env示例及部分参考文件未包含在材料中;Docker安装、权限、防火墙、DNS传播和启动失败缺少足够的分支诊断;部分命令和版本假设未在目标路径内自洽验证。因此不超过静态上限10分。

3适用触发9 / 15 · 3.0/5

证据显示目标用户、Linux/SSH/Docker环境、单实例与队列模式、触发语义及不适用范围均说明清楚,并收集域名、邮箱、时区等输入。扣6分:对非Debian/Ubuntu主机、已有服务、非Docker部署、无sudo权限、复杂网络或已有n8n实例的边界不足;核心流程依赖Docker镜像、Let's Encrypt、DNS和海外文档/网络服务,未说明中国大陆可达性和替代路径;未提供中文交互支持说明。

4规范维护8 / 15 · 2.7/5

证据显示有SKILL.md编排层、分模式参考文件、资产目录、README结构、MIT许可证、README版本1.1.0和官方文档链接,信息架构较清晰。扣7分:选定技能自身没有明确维护责任人、发布/更新流程或变更日志;版本信息位于仓库README而非技能本体;材料缺少其引用的部分模板和参考文件;安装、FAQ、故障排查与兼容性说明仍依赖未展示内容;来源身份在题设中未验证。

5有效结果5 / 15 · 1.7/5

证据显示其覆盖从预检、部署、TLS验证到更新、备份、恢复和加固的完整目标,并提供可直接参考的Compose模板和命令。扣10分:静态阅读无法证明命令和模板在实际版本中可运行;缺少Caddyfile、env示例等关键资产,无法确认端到端产物可直接使用;队列模式的容量与恢复复杂度、外部依赖和迁移风险仍需人工复核;因此只能给出有限的静态效用分,不超过7分。

6证据核验4 / 10 · 2.0/5

证据显示文档引用多个官方n8n文档路径,并在模板与操作说明中提供健康检查、日志和版本检查命令,具备一定审计线索。扣6分:没有执行结果、CI工作流、提交测试套件或第三方复现记录;关键资产未全部提供,无法静态交叉核验;README中的测试和生产测试表述不能替代本技能路径的可重复证据;因此不超过静态上限5分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 05eea4848c12 评估证据[1][2][3][4][5][6][7][8][9][10][11]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能适合 n8n Cloud 用户吗?
不适合。它明确面向 Docker 上的自托管 n8n,不用于 n8n Cloud。
部署前用户需要准备什么?
需要 root 或 sudo SSH 访问、一个已指向服务器的域名、Let's Encrypt 邮箱、时区,以及可从互联网访问的 80 和 443 端口。
单实例和队列模式如何选择?
单实例适合一名用户及轻量或中等负载;队列模式适合高执行量、重任务、长任务或横向扩展,并使用 Redis、Postgres 和 workers。
丢失 N8N_ENCRYPTION_KEY 会怎样?
已保存的凭据将无法解密,因此该密钥必须安全备份到服务器之外。

同仓库的其他 Skills

均来自 czlonkowski/n8n-skills

开发与工程

n8n AI 代码工具指南

帮助你为 n8n AI Agent 编写符合工具运行契约的 JavaScript 或 Python 代码。

★ 6.4k FS 54 谨慎使用 19 天前
自动化与运维

n8n 文件与二进制数据指南

帮助你在 n8n 中正确传递文件、处理二进制数据,并让 AI 工具和聊天界面可靠使用文件。

★ 6.4k FS 53 谨慎使用 19 天前
自动化与运维

n8n 故障处理指南

让 n8n 工作流的失败可路由、可告警、可恢复。

★ 6.4k FS 53 谨慎使用 19 天前
自动化与运维

n8n 多实例定位助手

帮助 MCP 会话安全选择、验证并切换目标 n8n 实例,避免误读和误写。

★ 6.4k FS 51 谨慎使用 19 天前
自动化与运维

n8n AI Agent 架构指南

帮助你为 n8n AI Agent 正确选择节点、连接工具并处理记忆、结构化输出与人工审核。

★ 6.4k FS 50 谨慎使用 19 天前
自动化与运维

n8n MCP 工作流路由器

为 n8n-mcp 工作流任务匹配正确技能并降低生产故障。

★ 6.4k FS 50 谨慎使用 19 天前
开发与工程

n8n Python 代码节点指南

帮助你在 n8n Code 节点中可靠编写受限环境下的 Python。

★ 6.4k FS 49 谨慎使用 19 天前
自动化与运维

n8n 子工作流架构指南

帮助你把 n8n 中可复用的多步逻辑封装成清晰、可测试、可被智能体调用的子工作流。

★ 6.4k FS 49 谨慎使用 19 天前
开发与工程

n8n JavaScript 代码节点助手

帮助你在 n8n Code 节点中编写可靠、高效的 JavaScript。

★ 6.4k FS 47 谨慎使用 19 天前
开发与工程

n8n 表达式语法助手

帮助你编写、检查并修复 n8n 工作流表达式。

★ 6.4k FS 47 谨慎使用 19 天前
自动化与运维

n8n 节点配置助手

按操作和字段依赖配置 n8n 节点,减少验证错误与静默失败。

★ 6.4k FS 46 谨慎使用 19 天前
自动化与运维

n8n 验证专家

帮助 AI 解释 n8n 验证结果,并逐步修复会阻止工作流运行的问题。

★ 6.4k FS 46 谨慎使用 19 天前
自动化与运维

n8n MCP 工具专家

指导 AI 正确搜索、验证、创建和维护 n8n 工作流。

★ 6.4k FS 45 不推荐 19 天前
自动化与运维

n8n 工作流架构模式

用经过验证的架构模式设计、验证和部署可靠的 n8n 工作流。

★ 6.4k FS 40 不推荐 19 天前

相关 Skills