一键部署 n8n

要解决的问题

在 Windows 上用 npm install -g n8n 安装 n8n v2.x，几乎都会踩坑。最常见的是启动时抛出 A discriminator value for key __type could not be extracted——根目录的 zod 4.x 与 n8n 内部子包依赖的 zod@3.25.67 实例冲突，discriminatedUnion 直接失效。其次是 SQLite package has not been found installed：n8n 默认用 SQLite 做数据库，却没有把它写进自动安装的依赖列表，需要手动补上。另外首次启动要执行 100+ 条数据库迁移，端口迟迟无响应，容易被误判为安装失败。

这个技能做什么

技能把整个部署固化成一条可重复的流水线：

• 锁定依赖版本：预先写好 package.json，zod 精确锁定 3.25.67（不带 ^），并显式加入 sqlite3，从源头消除实例冲突。
• 后台安装：npm install 放后台跑（2000+ 依赖，约 15–25 分钟），装完自动通知，不用守着终端。
• 清理嵌套副本：npm 仍可能在子包的 node_modules 里塞入多余的 zod 副本，装完后统一清理并验证只剩一份。
• 隔离数据目录：用 N8N_USER_FOLDER 指向独立的 n8n-data/，数据库、配置和加密密钥都收拢其中。
• 桌面启动脚本：在桌面生成 启动n8n.bat，双击即启动服务并自动打开 http://localhost:5678，关闭窗口即停止服务。

适用边界与注意点

• 只针对 Windows；前置条件为 Node.js ≥ 20（推荐 v22 LTS）、npm ≥ 10、约 1.5GB 磁盘空间，网络需能访问 npm registry。
• 沙箱限制下无法创建 .lnk 快捷方式，技能用 .bat 等效替代；想要真正的快捷方式，可右键 .bat → 发送到 → 桌面快捷方式。
• 首次启动后 30–60 秒内端口无响应是正常的，日志出现 Editor is now accessible via: http://localhost:5678 才算就绪。
• MCP registry timeout 属于外部网络问题，不影响本地使用，可直接忽略。