SuperAPI AI 工具集

n8n-agents-project-scaffolder

部署与运维

查看项目

更新于 10-26 08:07

技能介绍

用途

该技能用于在从零创建 n8n 项目时生成完整的、可直接投入生产的项目骨架。它针对四类构建需求提供分诊决策树:新建 n8n 服务器部署、高流量水平扩展部署、自定义社区节点包、起始工作流 JSON 文件。

主要能力

部署脚手架(PostgreSQL + Traefik) 生成目录包含 docker-compose.yml、.env、.env.example、backup.sh、restore.sh、local-files/ 与 backups/。docker-compose.yml 要求包含:带命名卷的 PostgreSQL 服务、挂载 /home/node/.n8n 命名卷的 n8n 服务、带 Let's Encrypt TLS 的 Traefik 反向代理、本机文件绑定挂载、显式 N8N_ENCRYPTION_KEY 及 N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true、N8N_RUNNERS_ENABLED=true、NODE_ENV=production、所有服务 restart: always、PostgreSQL 健康检查与 n8n 依赖健康条件。

队列模式脚手架(Redis + Workers) 生成 docker-compose.yml(n8n 主实例 + workers + PostgreSQL + Redis)、.env、.env.example、backup.sh 与 local-files/。要求所有 n8n 服务设置 EXECUTIONS_MODE=queue,使用带命名卷的 Redis、独立的 n8n-worker 服务(command: worker)、所有实例共享同一加密密钥与镜像版本、PostgreSQL 13+、S3 兼容存储用于二进制数据、QUEUE_BULL_REDIS_HOST 指向 Redis 服务名、worker 并发设置。

自定义节点脚手架 生成 n8n-nodes-<your-name>/ 包结构,包含 package.json(含 n8n 注册块)、tsconfig.json、.eslintrc.js、LICENSE、README.md、credentials/、nodes/ExampleNode/ 与 icons/。规定包名必须以 n8n-nodes- 开头、keywords 必须含 n8n-community-node-package、n8n.nodes 与 n8n.credentials 必须指向 dist/ 中的编译后 .js 文件、n8n-workflow 仅作 peerDependency、@n8n/node-cli 作 devDependency、不得直接修改 this.getInputData() 数据须先克隆。

工作流模板脚手架 提供 Webhook 工作流、定时工作流、错误处理器、子工作流四类模板,并给出工作流 JSON 结构规范:settings 中包含 executionOrder: v1、错误处理方式、节点位置不重叠、节点名称唯一。

环境变量与安全参考 列出生产必备变量(N8N_ENCRYPTION_KEY、N8N_HOST、N8N_PORT、N8N_PROTOCOL、NODE_ENV、WEBHOOK_URL、DB_TYPE、GENERIC_TIMEZONE 等)及安全变量(N8N_BLOCK_ENV_ACCESS_IN_NODE、N8N_SECURE_COOKIE、N8N_COMMUNITY_PACKAGES_ENABLED、NODES_EXCLUDE)。

备份脚本要求 要求包含 pg_dump 数据库导出、n8n export:workflow --backup、n8n export:credentials --backup、带时间戳输出目录、保留策略与加密密钥备份提醒;禁止在自动化脚本中使用 --decrypted 导出凭据、禁止在缺少加密密钥时存储备份、禁止跳过 PostgreSQL 导出。

安全默认项清单 每次脚手架均要求:用 openssl rand -hex 32 生成加密密钥、启用设置文件权限强制、启用 runners、设置 NODE_ENV=production、在共享环境阻断节点内环境访问、排除 executeCommand 等危险节点、通过反向代理使用 HTTPS、设置强数据库密码、不公开数据库端口、配置执行数据清理。

使用方式

根据决策树判断要构建的类型,选择对应脚手架并在生成时应用该类型下的 ALWAYS 要求与 NEVER 禁忌。完整模板见于 skill 包内的 references/methods.md(方法模板)、references/examples.md(项目示例)等文件。资料未提供具体调用命令或安装命令。

适用场景与限制

适用于新 n8n 部署搭建、水平扩展配置、社区节点包初始化、工作流起始文件生成。限制:队列模式必须使用 PostgreSQL 且不能使用 SQLite;自定义节点需通过 n8n-node CLI 构建;资料未提供定价、运行平台要求或具体安装步骤,暂未提供相关信息。