【免费下载链接】n8n-as-codeGive your AI agent n8n superpowers. 537 nodes with full schemas, 7,700 templates, Git-like sync, and TypeScript workflows.项目地址https://gitcode.com/gh_mirrors/n8/n8n-as-code点击查看免费下载本文介绍如何用n8n-as-code工具链在 10 分钟内搭建一套完整的n8n 本地开发环境通过配套的n8n-manager命令一键创建、启动本地 n8n 实例按需开启公网隧道再用n8nac env把实例绑定到工作区最后拉取、推送工作流形成拉取—编辑—推送的 GitOps 同步闭环。全程无需云账号新手也能照做。 先搞懂两个角色n8nac 与 n8n-managern8n-as-code 把职责拆得很清楚理解这一点就不容易用错命令你关心的事由谁负责说明工作区环境定义连接哪个 n8n、项目、工作流路径n8nac env存进仓库可随项目共享本地 n8n 实例的创建 / 启停 / 删除n8n-manager机器本地资源基于 Docker 管理公网隧道n8n-manager tunnel把本地实例暴露成公网 URL工作流文件同步list / pull / pushn8nacGitOps 风格显式同步不会偷偷覆盖一句话记忆环境配置归n8nac本地运行时归n8n-manager。n8n-as-code 通过适配层 packages/manager-adapter/src/index.ts 调用独立的 n8n-manager 运行时引擎。右下角那张多实例管理插画正是 n8n-manager 要解决的场景同时管理多个本地 n8n 实例并各自绑定不同的工作区环境。✅ 开始前的准备工作3 项Node.js 20 或更高版本CLIn8nac、n8n-manager运行依赖Docker 已安装并在运行本地托管实例就跑在 Docker 容器里Docker 守护进程没启动时命令会直接报后端诊断信息并停止一个工作区文件夹存放工作流文件与n8nac-config.json的项目目录可以是新建的空目录。完整前置条件见 docs/docs/getting-started/index.md。1️⃣ 一键创建并启动本地 n8n 实例n8n-manager instance list n8n-manager instance create n8n-manager instance start idinstance list先看看机器上已有哪些实例避免重复创建instance create创建一个新的本地托管 n8n 实例输出会给出实例idinstance start id按 id 启动实例。 如果list里已有可用实例直接复用它的id即可不必新建。2️⃣可选开启公网隧道Webhook 和远程回调才需要默认情况下本地实例只在本机可达。如果你的工作流包含Webhook 触发器、表单提交、聊天机器人回调需要外部系统访问到本地 n8n此时再开启隧道n8n-manager tunnel start id n8n-manager tunnel stop id两个注意点隧道 URL 可能会轮换重启后可能变化所以不要把它硬编码进仓库按需开启没有公网访问需求时就别启动隧道保持本地环境最小暴露面。3️⃣ 把本地实例绑定到工作区关键一步实例跑起来后用n8nac env把它挂到当前仓库n8nac env add Local --managed-instance id --workflows-path workflows/local n8nac env use Local n8nac update-ai--managed-instance id引用 n8n-manager 创建的本地实例--workflows-path workflows/local工作流源码在仓库中的存放目录update-ai生成AGENTS.md与 AI 上下文让编辑器里的 Agent 带着真实的 n8n 知识干活。这一步完成后运行n8nac env status --json看到accessStatus: ready即代表环境就绪。4️⃣ 拉取与推送工作流完成同步闭环n8nac list n8nac pull workflow-id n8nac push workflows/local/my-workflow.workflow.ts --verify同步是显式的不 pull、不 push就不会有任何东西被自动读写——这是 GitOps 风格的核心纪律。️偏好图形界面的同学在 VS Code / Cursor 中安装 n8n-as-code 扩展打开文件夹后运行n8n: Configure在n8n environments里选择本地托管实例选好项目和工作流路径保存即可。扩展侧栏的Managed local instances只负责查看本地实例增删环境不会误删 Docker 实例。5️⃣ n8n-manager 常用命令速查表目的命令列出本机实例n8n-manager instance list创建实例n8n-manager instance create启动 / 停止实例n8n-manager instance start id/instance stop id删除实例n8n-manager instance remove id启动 / 停止隧道n8n-manager tunnel start id/tunnel stop id绑定到工作区n8nac env add Local --managed-instance id --workflows-path workflows/local切换活动环境n8nac env use Local查看环境就绪状态n8nac env status --json完整命令清单参考 docs/docs/usage/commands.md 与 docs/docs/usage/n8n-manager.md。 最佳实践什么进 Git什么绝不进 Git可以提交工作流文件workflows/**下的.workflow.ts/ JSONn8nac-config.json环境映射只要不含密钥就是工作区安全的内容团队共享的 AI 上下文AGENTS.md等生成物不要提交API Keyn8n-manager本地存储实例清单、Docker 状态、隧道状态日志原因是本地细节天然不可移植本机端口、Docker 容器名、卷名、隧道 URL 在另一台机器上可能完全不同实例本身也可能只在你的电脑上存在。所以仓库里只保留环境映射运行时细节留在机器上。 常见问题与排错1. 环境引用的本地实例不存在比如换了电脑实例是机器本地资源仓库克隆过来不会自动带出来。二选一重建实例或把环境改指向远程 n8nn8nac env update environment --base-url url n8nac env auth set environment --api-key-stdin2. 删除了工作区环境实例会不会跟着没了不会。n8nac env remove只删环境映射不碰本地实例反过来删除环境也不会创建或删除 Docker 实例。要真正清理实例请用n8n-manager instance remove id破坏性操作确认用户明确需要后再执行。3. push 被拒绝 / 出现冲突远端在你上次 pull 之后有改动先 pull 再处理冲突n8nac resolve workflow-id --mode keep-current n8nac resolve workflow-id --mode keep-incoming4. 隧道连不上或 URL 失效隧道 URL 可能轮换重新执行n8n-manager tunnel start id获取最新地址并把新地址配到工作流的 Webhook 节点。更多排查思路见 docs/docs/troubleshooting.md 的 Managed Local Instances 一节。 小结本地 n8n 开发环境的搭建路径其实非常短n8n-manager管运行时n8nac env管环境映射同步全靠显式命令n8n-manager instance createinstance start→ 拥有本地 n8n 实例需要 Webhook 回调时tunnel start→ 获得公网入口n8nac env add Local --managed-instance id→ 实例进入工作区n8nac list / pull / push→ 开始 GitOps 式工作流开发。掌握这三条主线的分工你就可以在完全离线的机器上搭出生产级的 n8n 开发闭环了。赞分享【免费下载链接】n8n-as-codeGive your AI agent n8n superpowers. 537 nodes with full schemas, 7,700 templates, Git-like sync, and TypeScript workflows.项目地址https://gitcode.com/gh_mirrors/n8/n8n-as-code点击查看免费下载相关推荐n8n-workflows 仓库实战指南一键部署 n8n Agent Zero ComfyUI 本地 AI 自动化栈n8n workflows 仓库实战指南一键部署 n8n Agent Zero ComfyUI 本地 AI 自动化栈 ai stack/ 目录是 n8工作流自动化文档n8n-workflows 的 AI Stack 实战指南用 n8n Agent Zero ComfyUI 搭建本地 AI 自动化栈n8n workflows 的 AI Stack 实战指南用 n8n Agent Zero ComfyUI 搭建本地 AI 自动化栈 本文以仓库中 A工作流自动化文档Self-hosted AI Starter Kit用 Docker Compose 一键搭建本地 n8n Ollama Qdrant 私有 AI 工作流环境Self hosted AI Starter Kit用 Docker Compose 一键搭建本地 n8n Ollama Qdrant 私有 AI 工人工智能大模型本地部署低代码AI 应用AI Agent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
