调度触发节点
使用 Schedule Trigger 调度触发器节点以固定的时间间隔运行工作流。其工作方式类似于类 Unix 系统中的 Cron 工具。
提示
You must publish the workflow 您必须发布工作流程
如果工作流使用“计划”节点作为触发器,请确保保存并发布该工作流。
提示
Timezone settings 时区设置
The node relies on the timezone setting. n8n 使用:
- The workflow timezone, if set.详细信息请参阅工作流程设置。
- n8n 实例时区(如果未设置工作流时区)。自托管实例的默认值为
America/New York。n8n Cloud 会在实例所有者注册时尝试检测实例所有者的时区,并回退到 GMT 作为默认值。自托管用户可以使用环境变量更改实例设置。n8n Cloud 实例所有者可以在 n8n Cloud 控制台中更改实例时区。
节点参数
添加 Trigger Rules 触发规则 以确定触发器的运行时间。
使用 Trigger Interval 触发间隔 选择触发器的时间间隔单位。所有其他参数取决于你选择的间隔。可选项包括:
- Seconds trigger interval 秒级触发间隔
- Minutes trigger interval 分钟级触发间隔
- Hours trigger interval 小时级触发间隔
- Days trigger interval 天级触发间隔
- Weeks trigger interval 周级触发间隔
- Months trigger interval 月级触发间隔
- Custom (Cron) interval 自定义(Cron)间隔
你可以添加多个 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 集成模板 或 搜索所有模板
常见问题
有关常见问题和建议的解决方案,请参阅常见问题。