本指南将引导你完成从 n8n 工作流程迁移到 JieGou 的每个步骤。无论你有 5 个还是 500 个工作流程，流程都相同 — 而且大部分都是自动化的。
预估时间： 典型的 20-50 个工作流程部署需要 1-2 小时。
先决条件
开始之前：
- n8n 存取权限 — 你需要管理员存取权限来汇出工作流程（自架或云端）
- JieGou 帐户 — 免费注册或部署 Docker Compose 入门套件用于气隙环境
- 整合凭证 — 你的 n8n 工作流程连接的任何服务的 API 金钥或 OAuth token（Slack、Gmail、GitHub 等）
步骤 1：汇出你的 n8n 工作流程
选项 A：汇出所有工作流程（推荐）
- 开启你的 n8n 实例
- 前往设定 → 汇出所有工作流程
- 下载 JSON 档案 — 它包含你实例中的每个工作流程
汇出的档案看起来像这样：
[
{
"name": "Lead Enrichment Pipeline",
"nodes": [
{ "name": "Webhook", "type": "n8n-nodes-base.webhook", ... },
{ "name": "HTTP Request", "type": "n8n-nodes-base.httpRequest", ... },
{ "name": "Set", "type": "n8n-nodes-base.set", ... }
],
"connections": { ... }
},
...
]选项 B：汇出个别工作流程
- 开启你想迁移的工作流程
- 点击 ⋮ 选单 → 下载
- 储存 JSON 档案
你可以一次汇入一个工作流程或批次汇入。
汇出内容
| 包含 | 不包含 |
|---|---|
| 工作流程名称和结构 | 凭证值（API 金钥、token） |
| 节点类型和设定 | 执行历史 |
| 节点间的连接 | 环境变数 |
| 标签和注解 | 自订节点套件 |
| 静态参数 |
重要： n8n 基于安全考量从不汇出凭证值。你将在 JieGou 中以 MCP 伺服器连接的方式设定新凭证。
步骤 2：注册 JieGou
云端（最快）
- 前往 console.jiegou.ai
- 使用 Google、GitHub 或电子邮件注册
- 选择你的部门（汇入工具在任何部门都可使用）
- 你会到达仪表板 — 导航至整合 → 迁移
自架（Docker Compose）
适用于需要资料留在本地的受监管环境：
# 复制入门套件
git clone https://github.com/JieGouAI/self-hosted.git
cd self-hosted
# 设定
cp .env.example .env
# 编辑 .env 填入你的 Firebase 凭证和 LLM API 金钥
# 启动
docker compose up -d控制台将在 http://localhost:3000 提供服务。
混合 VPC 部署（企业版）
适用于需要云端便利性并同时在本地处理资料的团队：
- 联系 sales@jiegou.ai 进行 VPC 代理设定
- 控制平面（控制台、排程、监控）在 JieGou 云端运行
- 工作流程执行在你的 VPC 内进行 — 资料永不离开你的网路
- 查看我们的混合部署文章了解架构详情
步骤 3：使用汇入精灵
- 在你的 JieGou 控制台中导航至
/migrations/n8n - 你会看到 n8n 汇入精灵 — 一个三步骤流程
上传
- 直接将你的 n8n 工作流程 JSON 贴上到文字区域，或
- 使用档案选择器上传
.json档案
点击预览转换来分析工作流程。
分析过程
汇入工具：
- 解析 n8n 工作流程 JSON（验证结构、提取节点和连接）
- 对应每个 n8n 节点类型到最接近的 JieGou 步骤类型
- 侦测触发节点（webhook、排程、手动触发）并转换为工作流程输入
- 识别整合节点并建议匹配的 MCP 伺服器
- 建构连接图（保留执行顺序和分支逻辑）
- 生成转换报告，标注需要手动处理的项目
步骤 4：审查和调整对应
分析完成后，你会看到详细的转换报告。
摘要卡片
报告顶部显示四个指标：
- 总节点数 — 工作流程中有多少 n8n 节点
- 已对应 — 完全转换为 JieGou 步骤类型的节点
- 已跳过 — 不需要转换的节点（例如 NoOp、StickyNote）
- 警告 — 需要你注意的项目
节点对应表
每个 n8n 节点都显示其转换状态：
| 状态 | 含义 | 需要操作 |
|---|---|---|
| 已对应 | 完全转换为 JieGou 步骤 | 无 — 确认步骤看起来正确 |
| 部分 | 已转换但某些参数需要手动审查 | 检查步骤设定 |
| 手动 | 无法自动转换 | 手动建构等效步骤 |
| 已跳过 | 节点类型不需要转换 | 无 |
n8n 节点如何对应到 JieGou 步骤
| n8n 节点 | JieGou 步骤 | 说明 |
|---|---|---|
Set / Code / Function | LLM 步骤 | AI 执行转换而非程式码 |
IF / Switch / Filter | 条件步骤 | 直接对应 — 相同分支逻辑 |
SplitInBatches | 回圈步骤 | 直接对应 — 迭代阵列输入 |
Merge / Aggregate | 聚合器步骤 | 合并平行分支的输出 |
HTTP Request | LLM 步骤 + MCP 工具 | 使用 HTTP MCP 伺服器进行 API 呼叫 |
Slack / Gmail / GitHub | LLM 步骤 + MCP 伺服器 | 使用匹配的 MCP 伺服器整合 |
Webhook（触发） | 工作流程输入 | 成为工作流程的输入架构 |
Schedule Trigger | 排程 | 在 JieGou 排程中另行设定 |
OpenAI / LangChain Agent | LLM 步骤 | 多供应商 BYOK — 自带金钥 |
Postgres / MySQL | LLM 步骤 + MCP 伺服器 | 使用资料库 MCP 伺服器 |
Google Sheets | LLM 步骤 + MCP 伺服器 | 使用 Google Sheets MCP 伺服器 |
理解警告
警告分为三类：
- 🔴 错误 — 无法自动转换。例如：「自订函式节点使用了 JieGou 中不可用的 npm 套件」
- 🟡 警告 — 转换成功但需要验证。例如：「侦测到 Slack 节点 — 请设定 Slack MCP 伺服器以使用此整合」
- 🔵 资讯 — 有用的背景。例如：「Webhook 触发已转换为工作流程输入架构」
常见警告及解决方法：
| 警告 | 解决方法 |
|---|---|
| 「设定 [X] MCP 伺服器」 | 前往整合 → 市集，安装 MCP 伺服器并连接你的凭证 |
| 「复杂表达式可能需要调整」 | 审查步骤的提示/设定 — n8n 表达式如 {{$json.field}} 已转换为输入对应 |
| 「自订程式码节点」 | 审查生成的 LLM 提示 — 它描述了程式码的功能，LLM 将执行相同任务 |
| 「不支援的节点类型」 | 手动建构等效步骤或检查是否有 MCP 伺服器提供该功能 |
步骤 5：设定你的 MCP 伺服器
MCP（模型上下文协定）伺服器取代 n8n 的内建整合节点。每个 MCP 伺服器提供 LLM 步骤可使用的工具。
安装 MCP 伺服器
- 前往整合 → 市集
- 搜寻你需要的整合（例如「Slack」、「GitHub」、「PostgreSQL」）
- 点击安装将其新增到你的帐户
- 使用你的 API 金钥或 OAuth 凭证连接
将 n8n 凭证对应到 MCP 伺服器
| n8n 凭证 | JieGou MCP 伺服器 | 连接方法 |
|---|---|---|
| Slack OAuth | Slack MCP 伺服器 | OAuth 2.0（透过 Klavis） |
| Gmail API | Gmail MCP 伺服器 | OAuth 2.0（透过 Klavis） |
| GitHub Token | GitHub MCP 伺服器 | 个人存取 Token |
| Postgres 连接 | PostgreSQL MCP 伺服器 | 连接字串 |
| HTTP Header 验证 | HTTP MCP 伺服器 | API 金钥 / Bearer token |
| OpenAI API 金钥 | 帐户 BYOK 设定 | 金钥保管库中的 API 金钥 |
| AWS 凭证 | AWS MCP 伺服器 | 存取金钥 + 密钥 |
| Google Sheets OAuth | Google Sheets MCP 伺服器 | 服务帐户或 OAuth |
验证工具存取
安装 MCP 伺服器后：
- 开启汇入的工作流程
- 检查每个使用 MCP 工具的 LLM 步骤
- 确认选择了正确的 MCP 伺服器
- 透过快速手动运行测试连接
步骤 6：用效能比拼测试
上线之前，并排运行你的 n8n 工作流程和 JieGou 工作流程以比较输出品质。
建立效能比拼
- 前往效能比拼 → 新增效能比拼
- 选择工作流程对比工作流程模式
- 将你的 JieGou 工作流程新增为 A 组
- B 组有两个选项：
- 分别运行你的 n8n 工作流程并贴上输出
- 建立另一个具有不同 LLM 设定的 JieGou 工作流程变体
生成测试输入
- 点击生成输入 — JieGou 建立匹配你工作流程输入架构的合成测试资料
- 或从你的 n8n 执行历史提供真实输入
- 我们建议 5-10 个多样化输入以进行有意义的比较
审查结果
效能比拼在每个输入上运行两组并提供：
- LLM 评审评估 — AI 评估者对每个输出的准确性、完整性和相关性进行评分
- 统计信心度 — 标准差和 95% 信赖区间
- 并排比较 — 并排查看输出以进行手动审查
注意事项
- 输出格式 — JieGou 工作流程是否以你下游系统预期的格式产生输出？
- 资料完整性 — 所有栏位都已填充吗？有遗漏的资讯吗？
- 边界情况 — 两者如何处理空输入、大型负载或不寻常的资料？
- 错误处理 — API 呼叫失败时会发生什么？
步骤 7：上线
一旦你对转换有信心：
逐步切换
- 从低风险工作流程开始 — 内部通知、报告生成、资料同步
- 监控 48 小时 — 在 JieGou 的运行历史中检查执行日志
- 迁移关键工作流程 — 面向客户的整合、支付处理、资料管线
- 停用 n8n — 一旦所有工作流程都已验证，关闭你的 n8n 实例
设定排程
如果你的 n8n 工作流程使用了排程触发：
- 前往自动化 → 排程
- 为每个工作流程建立新排程
- 设定 cron 表达式（JieGou 支援与 n8n 相同的 cron 语法）
- 设定时区和输入参数
设定 webhook 触发
如果你的 n8n 工作流程使用了 webhook 触发：
- 前往自动化 → 触发器
- 建立新的 webhook 触发
- 复制新的 webhook URL
- 在你的上游系统（例如 Stripe、GitHub、Slack）中更新 webhook URL
启用监控
- 执行警报 — 设定失败运行的通知
- 稽核日志 — 所有工作流程执行都自动记录 30 种操作类型
- SOC 2 证据 — 从合规仪表板汇出合规证据
疑难排解
上传时出现「无效 JSON」错误
- 验证档案是有效的 JSON（尝试贴上到 jsonlint.com）
- 如果你汇出了多个工作流程，档案是 JSON 阵列 — 汇入工具处理单一工作流程和阵列
- 检查 BOM 字元或编码问题（储存为 UTF-8）
节点标记为「需要手动」
这表示汇入工具无法自动转换此节点类型。常见情况：
- 自订函式节点具有复杂的 npm 依赖 → 将逻辑改写为 LLM 提示或使用 HTTP MCP 伺服器呼叫外部 API
- FTP / SFTP 节点 → 使用档案系统 MCP 伺服器或基于 HTTP 的档案传输服务
- XML 节点 → LLM 步骤原生处理 XML 解析 — 在提示中描述转换
汇入后工作流程执行失败
- 检查运行详情页面的具体错误
- 常见原因：
- MCP 伺服器未设定（从市集安装）
- 输入架构不匹配（检查工作流程的输入设定）
- LLM 供应商缺少 BYOK 金钥（在帐户设定 → API 金钥中新增）
效能差异
JieGou 工作流程是 AI 原生的 — 而非在 VM 中执行程式码，它们使用 LLM 步骤来执行转换。这意味着：
- 延迟可能较高 — 对于简单的资料转换（LLM 呼叫 vs. 记忆体内程式码）
- 品质可能较高 — 对于非结构化资料处理（LLM 理解 vs. 正规表达式/程式码）
- 维护更低 — API 变更时无需除错程式码
如果延迟很关键，使用条件步骤跳过确定性操作的 LLM 呼叫，并将 LLM 步骤保留给受益于 AI 的任务。
迁移检查清单
使用此检查清单追踪你的迁移进度：
- 将所有 n8n 工作流程汇出为 JSON
- 建立 JieGou 帐户（云端、自架或混合）
- 上传工作流程到汇入精灵
- 审查每个工作流程的转换报告
- 从市集安装所需的 MCP 伺服器
- 设定 MCP 伺服器凭证
- 为关键工作流程运行效能比拼
- 为 cron 触发的工作流程设定排程
- 在上游系统中更新 webhook URL
- 监控执行 48 小时
- 停用 n8n 实例
- 汇出 SOC 2 证据作为稽核轨迹
需要帮助？
- 汇入工具： console.jiegou.ai/migrations/n8n
- MCP 市集： console.jiegou.ai/integrations/marketplace
- 社群： community.jiegou.ai
- 企业支援： sales@jiegou.ai
- 安全详情： 为什么我们选择混合部署