n8n 2.0 重大变更
n8n 2.0 已经发布,随之而来的是一些重要的变化。本文档重点介绍了重大变更以及您为准备过渡应采取的行动。这些更新提高了安全性、简化了配置并删除了旧功能。
n8n 2.0的发布延续了n8n对提供安全、可靠和生产就绪的自动化平台的承诺。此主要版本包括重要的安全增强功能和已弃用功能的清理。
行为改变
当子工作流从等待恢复时返回期望的子工作流数据(等待webhook、表单、HITL等)
以前,当执行(父执行)调用子执行(子执行),其中包含导致子执行进入等待状态的节点并且将父执行设置为等待子执行完成时,父执行将收到不正确的结果。
例如,如果子执行包含超时时间高于 65 秒的 Wait 节点、Webhook 调用或表单提交,或者人机交互节点(如 slack 节点),就会发生进入等待状态。
家长工作流程:

子工作流程:

n8n 1.0:父执行将子执行的输入再现为其输出。:

n8n 2.0:父执行接收子执行的结果:

这允许在子工作流程中使用人机交互节点,并在父工作流程中使用结果(例如批准或拒绝操作)。
迁移路径: 查看调用子工作流并期望接收子工作流输入的任何工作流。更新这些工作流以处理新行为,其中父工作流改为从子工作流末尾接收输出。
删除起始节点
不再支持开始节点。该节点是开始工作流程的原始方式,但现在更具体的触发节点取代了它。
迁移路径: 根据您使用工作流程的方式替换“开始”节点:
- 手动执行: 将 Start 节点替换为 手动触发 节点。
- 子工作流程: 如果另一个工作流程将此工作流程调用为子工作流程,请将 Start 节点替换为 执行工作流触发器 节点并激活该工作流程。
- 禁用的启动节点: 如果启动节点被禁用,请将其从工作流中删除。
保存和发布工作流程
新的工作流发布系统取代了以前的活动/非活动切换。这意味着旧的“激活/停用”切换变成新的“发布/取消发布”按钮。此更改使您可以更好地控制工作流程更改何时生效,从而降低意外将正在进行的更改部署到生产中的风险。更多信息可以在这里找到:保存和发布工作流程。
删除了已停用服务的节点
以下节点已被删除,因为它们连接的外部服务不再可用:
- 自发节点
- crowd.dev 节点
- 风筝制造者节点
- 自动节点
迁移路径: 如果您的工作流程使用这些节点中的任何一个,请更新或删除这些工作流程以避免错误。
安全
默认阻止从代码节点访问环境变量
为了提高安全性,n8n 默认会阻止 Code 节点对环境变量的访问。 N8N_BLOCK_ENV_ACCESS_IN_NODE 的默认值现在设置为 true。
迁移路径: 如果您的工作流程需要访问代码节点中的环境变量,请在环境配置中设置 N8N_BLOCK_ENV_ACCESS_IN_NODE=false。对于敏感数据,请使用凭据或其他安全方法而不是环境变量。
强制设置文件权限
n8n 将要求配置文件严格的文件权限以提高安全性。默认情况下,配置文件必须使用 0600 权限,这意味着只有文件所有者才能读取和写入它们。这种方法类似于 SSH 保护私钥的方式。
迁移路径: 要在 n8n 2.0 之前测试此行为,请设置 N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true。如果您的环境不支持文件权限(例如,在 Windows 上),请设置 N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=false 以禁用此要求。
默认启用任务运行程序
n8n 将默认启用 任务执行者 以提高安全性和隔离性。所有代码节点执行都将在任务运行器上运行。
迁移路径: 在升级到 n8n 2.0 之前,设置 N8N_RUNNERS_ENABLED=true 来测试此行为。确保您的基础架构满足运行任务运行程序的要求。为了提高安全性,请考虑使用 外部模式。
$evaluateExpression 不再在代码节点 中工作
由于代码节点执行现在默认以安全模式在任务运行器上运行,因此 $evaluateExpression() 便捷方法不再在代码节点内工作。安全模式禁止将字符串计算为代码,这是表达式所依赖的机制,因此代码节点中的 $evaluateExpression() 调用会返回 null 或错误。常规节点字段(例如“编辑字段(集)”节点)中的表达式不受影响。
迁移路径: 将表达式计算移出代码节点,按优先顺序:
- 直接用 JavaScript 编写逻辑,而不是调用
$evaluateExpression()。 - 评估代码节点之前的编辑字段(集)节点中的表达式,然后从传入项目中读取结果。
- 如果您没有其他选项,请设置
N8N_RUNNERS_INSECURE_MODE=true以重新启用禁用的 JavaScript 功能。这会关闭任务运行程序的安全措施,并且不鼓励用于生产用途。
代码节点中的 $evaluateExpression() 可能会在未来版本中完全删除,因此请将 N8N_RUNNERS_INSECURE_MODE=true 视为临时解决方法而不是永久解决方案。
从 n8nio/n8n docker 镜像 中删除任务运行程序
从 n8n 2.0 开始,主 n8nio/n8n Docker 映像将不再包含外部模式的任务运行程序。您必须使用单独的 n8nio/runners Docker 映像在外部模式下运行任务运行程序。
迁移路径: 如果您在 Docker 中使用外部模式运行任务运行程序,请更新您的设置以使用 n8nio/runners 映像而不是 n8nio/n8n。
删除基于 Pyodide 的 Python 代码节点和工具
n8n 将删除基于 Pyodide 的 Python 代码节点和工具,并将其替换为使用本机 Python 的 基于任务运行器 实现,以实现更好的安全性和性能。从 n8n 2.0 开始,您只能将 Python 代码节点与 外部模式 中的任务运行器和本机 Python 工具一起使用。
本机 Python 代码节点不支持内置变量,例如 _input 或点访问表示法,这些变量在基于 Pyodide 的版本中可用。有关详细信息,请参阅 代码节点文档。
本机 Python 工具支持 _query 作为 AI 代理在调用该工具时传递给该工具的输入字符串。
迁移路径: 要继续在代码节点中使用 Python,请在外部模式下设置任务运行程序并检查现有的 Python 代码节点和工具的兼容性。
默认禁用 ExecuteCommand 和 LocalFileTrigger 节点
n8n 将默认禁用 ExecuteCommand 和 LocalFileTrigger 节点,因为它们会带来安全风险。这些节点允许用户运行任意命令并访问文件系统。
迁移路径: 如果您需要使用这些节点,请通过更新 NODES_EXCLUDE 环境变量将它们从 n8n 配置中的禁用节点列表中删除。例如,设置 NODES_EXCLUDE="[]" 以启用所有节点,或仅删除您需要的特定节点。
默认情况下需要对 OAuth 回调 URL 进行身份验证
默认情况下,n8n 将要求对 OAuth 回调端点进行身份验证。 N8N_SKIP_AUTH_ON_OAUTH_CALLBACK 的默认值将从 true(无需身份验证)更改为 false(需要身份验证)。
迁移路径: 在升级到 n8n 2.0 之前,设置 N8N_SKIP_AUTH_ON_OAUTH_CALLBACK=false 并测试您的 OAuth 集成,以确保它们在启用身份验证的情况下工作。
设置 N8N_RESTRICT_FILE_ACCESS_TO 的默认值
n8n 将为 N8N_RESTRICT_FILE_ACCESS_TO 设置默认值,以控制文件操作可以发生的位置。这会影响 ReadWriteFile 和 ReadBinaryFiles 节点。默认情况下,这些节点只能访问~/.n8n-files目录中的文件。
迁移路径: 检查使用文件节点的工作流程并确保它们仅访问允许目录中的文件。如果您需要允许访问其他目录,请将 N8N_RESTRICT_FILE_ACCESS_TO 环境变量设置为您所需的路径。
将 N8N_GIT_NODE_DISABLE_BARE_REPOS 的默认值更改为 true
默认情况下,出于安全原因,Git 节点现在将阻止裸存储库。 N8N_GIT_NODE_DISABLE_BARE_REPOS 的默认值设置为 true,这意味着除非您更改此设置,否则裸存储库将被禁用。
迁移路径: 如果您的工作流程需要使用裸存储库,请在环境配置中设置 N8N_GIT_NODE_DISABLE_BARE_REPOS=false 来启用它们。
数据
删除 MySQL/MariaDB 支持
n8n 将不再支持 MySQL 和 MariaDB 作为存储后端。这项支持自 n8n 1.0 起已弃用。为了获得最佳兼容性和长期支持,请使用 PostgreSQL。MySQL 节点将继续像以前一样受到支持。
迁移路径: 在升级到n8n 2.0之前,请使用数据库迁移工具将数据从MySQL或MariaDB迁移到PostgreSQL或SQLite。
删除 SQLite 旧版驱动程序
由于可靠性问题,n8n 将删除旧版 SQLite 驱动程序。池驱动程序将成为默认且唯一的 SQLite 驱动程序。池驱动程序使用 WAL 模式、单个写入连接和读取连接池。我们的基准测试表明它的速度最多可以提高 10 倍。
迁移路径: sqlite-pooled 驱动程序将自动成为默认驱动程序。您现在可以通过将 DB_SQLITE_POOL_SIZE 设置为大于 0 的值来启用池化。默认池大小将设置为 2。
删除内存中二进制数据模式
n8n 将为 N8N_DEFAULT_BINARY_DATA_MODE 删除 default 模式,该模式在执行期间将执行二进制数据保留在内存中。为了获得更好的性能和稳定性,从 n8n 2.0 开始将提供以下选项:
filesystem:二进制数据存储在文件系统中。常规模式下的默认选项。database:二进制数据存储在数据库中。队列模式下的默认选项。s3:二进制数据存储在S3兼容存储中。
N8N_AVAILABLE_BINARY_DATA_MODES 设置也将被删除,因此模式现在仅由 N8N_DEFAULT_BINARY_DATA_MODE 确定。
迁移路径: 将根据配置自动使用文件系统或数据库模式。确保您的 n8n 实例有足够的磁盘空间来存储二进制数据。有关详细信息,请参阅 二进制数据配置。
配置&环境
升级dotenv
n8n 使用 dotenv 库从 .env 文件加载环境配置。该库将从版本 8.6.0 升级到最新版本,这可能会改变 .env 文件的解析方式。关键的突破性变化包括:
- 反引号支持 (#615):如果您的值包含反引号,请将它们用单引号或双引号引起来。
- 多行支持:您现在可以使用多行值。
#标记注释的开始:以 # 开头的行被视为注释。
迁移路径: 查看 dotenv 变更日志 并更新您的 .env 文件以确保与新版本的兼容性。
删除 n8n --tunnel 选项
n8n --tunnel 命令行选项将从 n8n 2.0 中移除。
迁移路径: 如果您当前使用 --tunnel 选项进行开发或测试,请切换到替代隧道解决方案,例如 ngrok、localtunnel 或 Cloudflare Tunnel。更新您的工作流程和文档以反映此更改。
删除 QUEUE_WORKER_MAX_STALLED_COUNT
QUEUE_WORKER_MAX_STALLED_COUNT 环境变量和针对停滞作业的 Bull 重试机制将被删除,因为它们经常引起混乱并且无法可靠地工作。
迁移路径: 从您的配置中删除此环境变量。升级后,n8n 将不再自动重试停滞的作业。如果您需要处理停滞的作业,请考虑实施您自己的重试逻辑或监控。
删除 N8N_CONFIG_FILES
N8N_CONFIG_FILES 环境变量已被删除。
迁移路径: 从您的配置中删除此环境变量。将配置移至环境变量、.env 文件或基于 _FILE 的配置中。
CLI 和工作流程
替换CLI命令更新:工作流程
update:workflow CLI 命令将被弃用,并由两个新命令取代,以提供类似的功能和更清晰的功能:
publish:workflow,参数为id和versionId(可选)--all参数将被删除,以防止在生产环境中意外发布工作流程
unpublish:workflow,参数为id和all
迁移路径: 使用新的 publish:workflow 命令按 ID 单独发布工作流程,并可选择指定版本。要取消发布,请使用新的 unpublish:workflow 命令。这提供了对工作流发布状态的更好的清晰度和控制。
外部挂钩
已弃用的前端工作流程挂钩
挂钩 workflow.activeChange 和 workflow.activeChangeCurrent 将被弃用。这些将被新的挂钩 workflow.published 取代。当工作流的任何版本发布时,都会触发新的挂钩。
迁移路径: 更新您的代码以使用新的 workflow.published 挂钩,而不是 workflow.activeChange 和 workflow.activeChangeCurrent。该钩子提供了更一致的行为,并且每当发布工作流版本时都会触发该钩子。
发布渠道
n8n 已将发布通道从 latest 和 next 分别重命名为 stable 和 beta。
stable 标签指定最新的稳定版本,beta 标签指定最新的实验版本。这些标签在 npm 和 Docker Hub 上均可用。目前,n8n 将继续将版本标记为 latest 和 next。这些标签将在未来的主要版本中删除。
建议: 将您的 n8n 版本固定到特定版本号,例如 2.0.0。
报告问题
如果您在更新到 n8n 2.0 时遇到任何问题,请访问社区 论坛 寻求帮助和支持。