用途:在单台 Vultr 或 AWS EC2 实例上开通并管理自托管 n8n 2.36.9(Caddy 反向代理、独立 task runner),后端为同机自建 Neon 存储层,由存储代理、pageserver、safekeeper 和 Postgres 17 计算节点组成,层与 WAL 存放在 Cloudflare R2 或 Amazon S3。Neon 层不在包内重写,而是 SHA 锁定 getcolors/neon 并直接渲染其 Ansible 模板。
安装与用法:执行 npx skills add getcolors/n8n,再 cp .agents/skills/package-n8n-green/green ./green 并 chmod +x green。根目录的 green 是副本而非符号链接,npx skills update -p 会重写 payload 却不改副本,更新后需重新复制。动词包括:./green build 仅渲染 .colors/<profile>/,不调用云商、不需凭据;./green create --dry-run 走流程但不产生副作用;./green create 真正收敛;./green delete 受 compute-prevent-destroy 保护。build 与 --dry-run 可在空环境的新检出上运行,退出码 2 表示校验失败并一次性列出所有问题。
凭据:非机密期望状态写在 colors.yml,凭据通过 COLORS_PAR_* 环境变量提供,一般放在 gitignored 的 .envrc.private。涉及 VULTR_API_KEY、CLOUDFLARE_API_TOKEN(需 Zone:Read 和 DNS:Edit)、R2 状态与 Neon/WAL、N8N_BACKUP_R2、N8N_ENCRYPTION_KEY 等。切忌导出 COLORS_PAR_PROFILE。AWS 场景无 provider key 与 state 对,走环境凭据链。
限制:R2 无只写模式,故即便限定范围的备份凭据也能删除自己写入的内容,需靠桶版本控制或不可变策略弥补,且属 Cloudflare 侧设置,包本身无法收敛。N8N_ENCRYPTION_KEY 不可再生,首次收敛前需另机留存副本,否则会污染数据目录。主机全丢时只能回落到逻辑备份集,RPO 等于备份间隔,默认六小时。回收演练脚本 n8n-soak.sh、n8n-rehearsal.sh、n8n-prune-drill.sh、n8n-restart-drill.sh 不属每次收敛流程。更多配置见 references/configuration.md。