n8n 中文文档

调度触发节点

使用 Schedule Trigger 调度触发器节点以固定的时间间隔运行工作流。其工作方式类似于类 Unix 系统中的 Cron 工具。

提示

You must publish the workflow 您必须发布工作流程

如果工作流使用“计划”节点作为触发器,请确保保存并发布该工作流。

提示

Timezone settings 时区设置

The node relies on the timezone setting. n8n 使用:

  1. The workflow timezone, if set.详细信息请参阅工作流程设置。
  2. n8n 实例时区(如果未设置工作流时区)。自托管实例的默认值为 America/New York。n8n Cloud 会在实例所有者注册时尝试检测实例所有者的时区,并回退到 GMT 作为默认值。自托管用户可以使用环境变量更改实例设置。n8n Cloud 实例所有者可以在 n8n Cloud 控制台中更改实例时区。

节点参数

添加 Trigger Rules 触发规则 以确定触发器的运行时间。

使用 Trigger Interval 触发间隔 选择触发器的时间间隔单位。所有其他参数取决于你选择的间隔。可选项包括:

你可以添加多个 Trigger Rules 触发规则,以便在不同的计划下运行该节点。

请参阅下方各节了解如何配置不同的 Trigger Interval 触发间隔。更多示例请参阅 Templates and examples 模板和示例。

提示

n8n 2.45.0 起的默认计时方式

只要 N8N_USE_WORKFLOW_PUBLICATION_SERVICE 保持启用(默认设置),Schedule Trigger 节点默认使用持久调度器。Seconds 和 Minutes 触发间隔从工作流发布时起按固定间隔运行,而不是与时钟边界对齐。自定义(Cron)间隔的计时方式保持不变。如需与时钟对齐的计时,请参阅 Schedule Trigger 计时;如需切换调度器,请参阅使用内存中调度器。

秒触发间隔

  • Seconds Between Triggers 触发间隔秒数:输入每次工作流触发之间的秒数。例如,若在此输入 30,触发器将每 30 秒运行一次。

分钟触发间隔

  • Minutes Between Triggers 触发间隔分钟数:输入每次工作流触发之间的分钟数。例如,若在此输入 5,触发器将每 5 分钟运行一次。

小时触发间隔

  • Hours Between Triggers 触发间隔小时数:输入每次工作流触发之间的小时数。
  • Trigger at Minute 触发分钟:输入节点运行时触发的分钟数,范围为 0 到 59。

例如,如果你输入 6 Hours Between Triggers 触发间隔小时数 并输入 30 Trigger at Minute 触发分钟,该节点将每 6 小时在第 30 分钟运行一次。

天数触发间隔

  • Days Between Triggers 触发间隔天数:输入每次工作流触发之间的天数。
  • Trigger at Hour 触发小时:选择触发节点的小时。
  • Trigger at Minute 触发分钟:输入节点运行时触发的分钟数,范围为 0 到 59。

例如,如果您输入 2 Days Between Triggers 触发间隔天数、Trigger at Hour 每小时触发 输入 9am、15 Trigger at Minute 分钟触发,则节点将每两天上午 9:15 运行一次。

周触发间隔

  • Weeks Between Triggers 触发间隔周数:输入每次工作流触发之间的周数。
  • Trigger on Weekdays 触发星期:选择要触发节点的星期。
  • Trigger at Hour 触发小时:选择触发节点的小时。
  • Trigger at Minute 触发分钟:输入节点运行时触发的分钟数,范围为 0 到 59。

例如,如果你输入 2 Weeks Between Triggers 触发间隔周数,在 Trigger on Weekdays 触发星期 中选择 Monday,在 Trigger at Hour 触发小时 中选择 3pm,并在 Trigger at Minute 触发分钟 中输入 30,该节点将每两周在周一下午 3:30 运行。

月触发间隔

  • Months Between Triggers 触发间隔月数:输入每次工作流触发之间的月数。
  • Trigger at Day of Month 触发日期:输入每月触发的日期,范围为 1 到 31。如果该月没有该日期,则不会触发。例如,若在此输入 30,则二月不会触发。
  • Trigger at Hour 触发小时:选择触发节点的小时。
  • Trigger at Minute 触发分钟:输入节点运行时触发的分钟数,范围为 0 到 59。

例如,如果你输入 3 Months Between Triggers 触发间隔月数,在 Trigger at Day of Month 触发日期 中输入 28,在 Trigger at Hour 触发小时 中选择 9am,并在 Trigger at Minute 触发分钟 中输入 0,该节点将每季度在每月 28 日上午 9:00 运行。

自定义(Cron)间隔

输入自定义的 Cron Expression 表达式 以设置触发器的计划。

你可以使用 crontab guru 生成 Cron 表达式,并将生成的 Cron 表达式粘贴到 n8n 的 Expression 表达式 字段中。

示例

类型 Cron 表达式 描述
每 X 秒 */10 * * * * * 每 10 秒。
每 X 分钟 */5 * * * * 每 5 分钟。
每小时 0 * * * * 每小时整点。
每日 0 6 * * * 每天早上 6:00。
每周 0 12 * * 1 每周一中午。
每月 0 0 1 * * 每月 1 号午夜。
每 X 天 0 0 */3 * * 每 3 天午夜。
仅限工作日 0 9 * * 1-5 周一至周五上午 9:00。
自定义每小时范围 0 9-17 * * * 每天上午 9:00 到下午 5:00 每小时。
每季度 0 0 1 1,4,7,10 * 每年 1 月、4 月、7 月和 10 月 1 日午夜。

警告

Using variables in the Cron expression 在 Cron 表达式中使用变量

虽然变量可以在计划触发器中使用,但它们的值仅在发布工作流时才会评估。如果您在发布工作流后更改设置中的变量值,则这些更改不会更改 cron 计划。要重新评估变量,请取消发布工作流程,然后重新发布。

为什么 Cron 表达式中有六个星号

Cron 表达式中的第六个星号代表秒。该设置为可选项,即使不设置秒的值,节点也会执行。

(*) * * * * *
(秒) 分钟 小时 月中的天 月份 星期(周日-周六)

Node options 节点选项

节点的 Settings 设置 选项卡提供用于控制执行错过计划时间(例如实例停机)后如何处理的选项:

  • If Execution Is Missed 如果错过执行:选择如何处理错过的执行:
    • Don't Run Missed Executions 不运行错过的执行(默认):丢弃错过的执行并恢复按计划运行。
    • Run the Most Recent Missed Execution 运行最近一次错过的执行:在最近一次错过的时间运行一次补偿执行,然后恢复按计划运行。
    • Run the Most Recent Missed Execution Per Rule 按规则运行最近一次错过的执行:与上一个选项类似,但每条触发规则都会运行自己的补偿执行。
  • Missed Execution Grace Period (Seconds) 错过执行的宽限期(秒):执行可延迟启动多久才会被视为错过。设置为 0 可使用实例设置(N8N_SCHEDULER_MISFIRE_GRACE,默认为 60 秒)。n8n 会将低于实例最小值(使用默认设置时为 60 秒)的值提升到该最小值,并将超过 30 天的值限制为 30 天。

提示

Feature availability 功能可用性

这些选项从 n8n 2.36 开始提供,并仅适用于从该版本起添加的 Schedule Trigger 节点。只有实例运行持久调度器时,这些选项才会生效;从 n8n 2.45.0 开始,默认启用该调度器。如果设置 N8N_SCHEDULER_ENABLED=false,Schedule Trigger 节点将使用内存中调度器,该调度器绝不会运行错过的执行。

模板和示例

浏览 n8n-nodes-base.scheduletrigger 集成模板 或 搜索所有模板

常见问题

有关常见问题和建议的解决方案,请参阅常见问题。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。