Skip to content

n8n v2.0 迁移工具#

¥n8n v2.0 migration tool

迁移工具通过识别升级前需要注意的工作流和配置，帮助你准备 n8n 实例以升级到 2.0 版本。

¥The migration tool helps you prepare your n8n instance for upgrading to version 2.0 by identifying workflows and configurations that need attention before the upgrade.

Migration tool

你可以查看 v2 版本 本页内容 的所有重大变更。

¥You can see all breaking changes for v2 on this page.

访问工具#

¥Accessing the Tool

导航至“设置”>“迁移报告”以查看你的兼容性状态。

¥Navigate to Settings > Migration Report to view your compatibility status.

User role access

迁移工具仅对全局管理员可用。

¥The migration tool is available for global admins only.

了解你的迁移状态#

¥Understanding Your Migration Status

在页面顶部，你将看到：

¥At the top of the page, you'll see:

"Y 个工作流中有 X 个与 n8n 2.0 兼容"

¥"X out of Y workflows are compatible with n8n 2.0"

此信息显示升级后有多少工作流无需更改即可继续运行。你的目标是解决导致剩余工作流不兼容的问题以及全局实例问题。

¥This tells you how many workflows will continue working without changes after upgrading. Your goal is to address the issues preventing the remaining workflows from being compatible, as well as global instance issues.

查看问题#

¥Viewing Issues

该工具将潜在问题分为两类：

¥The tool organizes potential problems into two categories:

工作流问题选项卡#

¥Workflow Issues Tab

显示影响你实例中特定工作流的重大更改。每个问题你将看到的内容：

¥Shows breaking changes that affect specific workflows in your instance. What you'll see for each issue:

  • 问题标题：问题的清晰名称

¥Issue title: A clear name for the problem

  • 严重性徽章（严重/中/低）：修复此问题的紧迫性

¥Severity badge (Critical/Medium/Low): How urgent this is to fix

  • 关键信息：升级前请修复，否则工作流将失败

    ¥Critical: Fix before upgrading or workflows will fail

  • 媒介：可能会导致意外行为或需要尽快处理。

    ¥Medium: May cause unexpected behavior or require attention soon

  • 低：不会影响功能的细微更改或弃用

    ¥Low: Minor changes or deprecations that won't break functionality

  • 描述：解释更改的内容及其重要性。

¥Description: Explanation of what's changing and why it matters

  • 文档链接：点击以阅读详细的迁移说明。

¥Documentation link: Click to read detailed migration explanations

  • 受影响的工作流程数量：有多少个工作流存在此问题？

¥Affected workflow count: How many of your workflows have this issue

工作流问题详情页面#

¥Workflow Issue Detail Page

点击“受影响的 X 个工作流”查看所有受影响的工作流。每个工作流你将看到的内容：

¥Click X workflows affected to see all affected workflows. What you'll see for each workflow:

  • 名称：工作流名称。点击名称以打开工作流编辑器。

¥Name: The workflow name. Click on the name to open the workflow editor.

  • 状态：工作流处于激活状态还是停用状态。

¥State: Whether workflow is active or deactivated

  • 受影响的节点：受问题影响的所有工作流节点列表。你可以点击每个工作流以打开工作流编辑器，并打开相应的节点视图。

¥Node affected: The list of all the workflow nodes affected by the issue. You can click on each to open the workflow editor with the specific node view opened.

  • 执行次数：工作流执行总数

¥Number of executions: The total number of executions of the workflow

  • 上次执行时间：工作流上次执行的日期。

¥Last executed: The date the workflow was last executed

  • 上次更新时间：工作流上次更新的日期。

¥Last updated: The date the workflow was last updated

实例问题选项卡#

¥Instance Issues Tab

显示影响你整个 n8n 实例（而非特定工作流）的配置更改。每个问题你将看到的内容：

¥Shows configuration changes that affect your entire n8n instance, not specific workflows. What you'll see for each issue:

  • 与工作流问题相同的信息（标题、严重性、描述、文档）

¥Same information as workflow issues (title, severity, description, docs)

  • 无工作流计数：这些是全局设置，适用于整个实例。

¥No workflow count: These are global settings that apply instance-wide

v2.0 迁移工具会扫描你的 n8n 实例，以识别潜在的兼容性问题以及升级到 v2.0 所需的配置更改。此参考文档详细介绍了工具执行的每项检查，解释了检测到的问题的影响，并提供了迁移实例的建议。

¥The v2.0 migration tool scans your n8n instance to identify potential compatibility issues and configuration changes required for upgrading to v2.0. This reference details each check the tool performs, explains the impact of detected issues, and provides recommendations to prepare your instance for migration.

了解空状态#

¥Understanding Empty States

未发现工作流问题#

¥No Workflow Issues Found

你的所有工作流均与 v2.0 兼容。检查“实例问题”选项卡，确保你的服务器配置也已准备就绪。

¥All your workflows are compatible with v2.0. Check the Instance Issues tab to ensure your server configuration is also ready.

未发现实例问题#

¥No Instance Issues Found

你的实例配置与 v2.0 兼容。检查“工作流问题”选项卡，确保所有工作流均已准备就绪。

¥Your instance configuration is compatible with v2.0. Check the Workflow Issues tab to ensure all workflows are also ready.

两个标签页均为空#

¥Both Tabs Empty

你的 n8n 实例已完全准备好升级到版本 2.0。

¥Your n8n instance is fully ready to upgrade to version 2.0.

推荐工作流程#

¥Recommended Workflow

初始评估#

¥Initial Assessment

  • 审核兼容性摘要

¥Review the compatibility summary

  • 浏览两个选项卡中的所有问题以了解范围。

¥Browse all issues in both tabs to understand the scope

按严重性排序#

¥Sort by Severity

  • 从关键问题开始（它们会破坏工作流程）。

¥Start with Critical issues (they'll break workflows)

  • 移动到中等风险级别（可能会导致问题）

¥Move to Medium issues (may cause problems)

  • 最后处理低优先级问题（弃用警告）

¥Address Low issues last (deprecation warnings)

修复工作流问题#

¥Fix Workflow Issues

  • 点击每个问题以查看受影响的工作流程。

¥Click into each issue to see affected workflows

  • 请阅读文档以获取修复说明

¥Read the documentation for fix instructions

  • 根据需要更新每个工作流

¥Update each workflow as needed

  • 在开发环境中测试工作流。

¥Test workflows in a development environment

解决实例问题#

¥Address Instance Issues

  • 更新环境变量或服务器配置

¥Update environment variables or server configuration

  • 请遵循每个实例级别更改的文档。

¥Follow documentation for each instance-level change

验证你的工作#

¥Verify Your Work

  • 点击“刷新”重新扫描。如果你看不到任何“刷新”按钮，请重新加载页面以重新扫描。

¥Click Refresh to re-scan. If you don't see any Refresh button, just reload the page to re-scan.

  • 确认没有未解决的问题。

¥Confirm that unresolved issues don't remain

  • 验证兼容性计数是否与工作流总数匹配

¥Verify compatibility count matches total workflows

继续升级#

¥Proceed with Upgrade

解决所有问题后，即可升级到 n8n 2.0

¥After addressing all issues, you're ready to upgrade to n8n 2.0