N8n cron

N8n Cron: Полное руководство по планированию и автоматизации рабочих процессов

N8n — это инструмент с открытым исходным кодом для оркестрации рабочих процессов (workflow automation), который позволяет соединять различные приложения и сервисы без единой строчки кода. Одним из ключевых триггеров для запуска workflow в n8n является Cron-узел (Schedule Trigger). Он использует cron-выражения — стандартный синтаксис для определения расписания выполнения задач в Unix-подобных системах. Этот механизм является фундаментальным для создания автоматизированных процессов, которые должны выполняться периодически: ежечасно, ежедневно, в конкретное время или по сложным расписаниям.

Принцип работы Cron-узла в n8n

Cron-узел в n8n действует как триггер, инициирующий выполнение всего рабочего процесса. После его активации выполнение переходит к следующим узлам в цепи. Узел не требует входных данных от предыдущих узлов и всегда является отправной точкой workflow. Его основная функция — генерировать запускающее событие в строго заданные моменты времени, определяемые пользователем через cron-выражение. Внутри n8n используется библиотека `node-cron`, которая интерпретирует эти выражения и вызывает выполнение workflow в соответствии с системным временем сервера, на котором развернут n8n. Это критически важно учитывать: если сервер находится в другом часовом поясе, время выполнения будет привязано к его часовому поясу.

Структура и синтаксис cron-выражения

Cron-выражение в n8n состоит из пяти или шести полей, разделенных пробелами. Стандартный формат включает пять полей (минута, час, день месяца, месяц, день недели). N8n также поддерживает расширенный формат с шестью полями, где первое поле — секунды (необязательно, по умолчанию 0).

Поле	Допустимые значения	Специальные символы
Минуты (Minutes)	0-59	, — /
Часы (Hours)	0-23	, — /
День месяца (Day of month)	1-31	, — / ? L W
Месяц (Month)	1-12 или JAN-DEC	, — /
День недели (Day of week)	0-7 (0 и 7 = воскресенье) или SUN-SAT	, — / ? L

Специальные символы для создания сложных расписаний:

• (Звездочка): Любое значение. Например, в поле «часы» означает «каждый час».
• , (Запятая): Перечисление значений. «1,15» в поле «день месяца» означает 1-е и 15-е число.
• — (Дефис): Диапазон значений. «10-18» в поле «часы» означает с 10:00 до 18:00 включительно.
• / (Слеш): Шаг (increment). «*/5» в поле «минуты» означает «каждые 5 минут». «0/15» — то же самое, начиная с 0 минуты.
• ? (Вопросительный знак): «Любое значение», используется только в полях «день месяца» и «день недели» для указания «не важно».
• L (Last): «Последний». «L» в поле «день месяца» — последний день месяца, в поле «день недели» — последняя суббота месяца.
• W (Weekday): Ближайший рабочий день (понедельник-пятница). «15W» — ближайший рабочий день к 15-му числу.
• 
  

  (Решетка): N-й день недели в месяце. «6#3» — третья пятница месяца (6=пятница).

Практические примеры cron-выражений в n8n

В интерфейсе n8n Cron-узел предлагает удобный режим «Every» для простых интервалов (каждые X минут/часов/дней), но для полного контроля необходимо использовать режим «Cron Expression».

Выражение	Значение	Пояснение
0	Каждый час, в 0 минут	Запуск в 00:00, 01:00, 02:00 и т.д.
/15 *	Каждые 15 минут	Запуск в 00:00, 00:15, 00:30, 00:45.
0 9 1-5	В 9:00 утра с понедельника по пятницу	Ежедневный рабочий отчет.
0 0 1	В 00:00 первого числа каждого месяца	Мониторинговая задача в начале месяца.
30 18 6	В 18:30 каждую субботу	Еженедельное резервное копирование.
0 8-18 *	Каждый час с 8:00 до 18:00	Запуск процесса в рабочее время.
0 0 0	В полночь каждое воскресенье	Еженедельный сброс данных.
0 4 1,15	В 4:00 1-го и 15-го числа каждого месяца	Запуск дважды в месяц.

Настройка Cron-узла в интерфейсе n8n

При добавлении Cron-узла в workflow открывается панель его настройки. Ключевые параметры:

• Trigger Times: Выбор между «Every» (простой интервал) и «Cron Expression» (продвинутый режим).
• Rules: В режиме «Every» задается величина (например, 2) и единица измерения (Minutes, Hours, Days, Weeks).
• Cron Expression: Поле для ввода выражения вручную. При вводе корректного выражения под полем отображается расшифровка на человеческом языке (например, «At every minute»).
• Timezone: Важнейшая настройка. По умолчанию используется часовой пояс системы, но его можно переопределить на любой другой (например, Europe/Moscow). Все вычисления времени будут вестись относительно выбранного пояса.
• Additional Options:
  • Max Runs Limit: Ограничение количества запусков. Полезно для тестирования.
  • Notes: Поле для комментариев о назначении узла.

Особенности, ограничения и лучшие практики

Использование Cron-узла связано с рядом важных технических нюансов, которые необходимо учитывать при проектировании надежных рабочих процессов.

Длительность выполнения и перекрытие (Overlap)

N8n не блокирует новый запуск Cron-узла, если предыдущее выполнение workflow еще не завершилось. Если workflow выполняется 10 минут, а cron-выражение настроено на запуск каждую минуту, это приведет к наложению множества параллельных выполнений, что может вызвать перегрузку системы и ошибки в логике (например, дублирование данных). Для предотвращения этого необходимо:

• Оптимизировать workflow для максимально быстрого выполнения.
• Использовать флаг «Active» workflow для принудительной остановки.
• Внедрять внешние механизмы блокировки (например, запись статуса в базу данных или файл).

Точность времени и дрифт

Cron в n8n не является системой реального времени высокой точности. Запуск осуществляется по системным часам с минимальной задержкой, определяемой внутренним планировщиком. Не следует полагаться на запуск ровно в указанную миллисекунду. Для задач, требующих точного времени, лучше использовать внешние, более надежные планировщики, которые будут вызывать n8n через Webhook-узел.

Обработка пропущенных запусков (Missed Runs)

Если сервер n8n был выключен или недоступен в момент, запланированный cron-выражением, пропущенный запуск не будет выполнен позже. Планировщик проверит время при следующем запуске сервера и активирует workflow только в следующий запланированный момент. Это критично для систем, где пропуск задачи недопустим. Решением является использование внешних отказоустойчивых планировщиков (например, облачных Cloud Scheduler от Google или AWS EventBridge) в паре с Webhook-узлом n8n.

Масштабирование и нагрузка

При работе с сотнями активных workflow, использующих Cron-триггер, нагрузка на планировщик возрастает. В облачной редакции n8n или при самостоятельном развертывании необходимо мониторить нагрузку на сервер. Распределение времени запуска (например, не все процессы в 00:00) помогает сгладить пики.

Альтернативы Cron-узлу в n8n

Cron-узел — не единственный способ запуска по расписанию. В зависимости от архитектуры, могут быть предпочтительны другие методы:

• Webhook-узел в комбинации с внешним планировщиком: Надежный метод для продакшн-сред. Внешний сервис (cron-задача на отдельном сервере, облачный планировщик) периодически отправляет HTTP-запрос на уникальный URL Webhook-узла, тем самым запуская workflow. Это дает контроль, логирование и отказоустойчивость на стороне планировщика.
• Триггер «On a specific day» или «After a specific time»: Встроенные триггеры для разовых или отложенных задач, которые можно активировать вручную или из другого workflow.
• Запуск через API: Workflow, содержащий любое начало (в том числе и Manual Trigger), можно запустить, отправив POST-запрос к REST API n8n. Это позволяет создать собственную систему управления расписанием.

Отладка и мониторинг Cron-задач

Для обеспечения надежности cron-задач необходим процесс отладки и мониторинга.

• Ведение логов: Обязательно добавление в конец workflow узлов для логирования успешного завершения или ошибок (например, отправка уведомления в Telegram, запись в базу данных или Google Sheets).
• Использование узла «Wait»: Для симуляции долгого выполнения при тестировании проблемы overlap.
• Проверка часового пояса: Первый шаг при несоответствии времени запуска — проверка настроек Timezone в узле и на сервере.
• Execution History: Вкладка «Executions» в интерфейсе n8n показывает все запуски workflow, их статус (Success, Error, Running) и точное время начала. Это основной инструмент для аудита.

Ответы на часто задаваемые вопросы (FAQ)

Почему мой workflow запускается не в то время, которое я указал в cron?

Наиболее вероятная причина — несоответствие часового пояса. Убедитесь, что в настройках Cron-узла выбран правильный часовой пояс (Timezone), а не стоит значение «DEFAULT» (системный). Проверьте системное время сервера, на котором работает n8n.

Как запускать workflow каждые 5 минут в рабочее время (с 9 до 18) с понедельника по пятницу?

Используйте cron-выражение: /5 9-18

1-5. Оно означает: каждые 5 минут, с 9 до 18 часов, в любой день месяца, любой месяц, с понедельника (1) по пятницу (5).

Можно ли поставить cron на запуск раз в месяц, последним числом?

Да. Используйте символ «L» в поле «день месяца»: 0 0 L . Это запустит workflow в 00:00 последнего дня каждого месяца.

Что произойдет, если выполнение workflow не успеет завершиться до следующего запуска по cron?

Новый экземпляр workflow запустится независимо от предыдущего. Они будут выполняться параллельно, что может привести к конфликтам и повышенной нагрузке. Необходимо проектировать workflow с учетом их потенциальной длительности или реализовывать механизм блокировки.

Как остановить запланированный запуск workflow?

Есть несколько способов:

• Деактивировать весь workflow, переведя тумблер «Active» в неактивное состояние на главной странице workflow.
• Удалить или отключить Cron-узел внутри workflow (перевести его тумблер в неактивное состояние).
• Изменить cron-выражение на заведомо невыполнимое (например, 0 0 30 2 * — 30 февраля).

Поддерживает ли n8n секунды в cron-выражениях?

Да, поддерживается нестандартный формат с шестью полями, где первое поле — секунды. Например, выражение /30 будет запускать workflow каждые 30 секунд. Однако, для частых интервалов в секунды предпочтительнее использовать циклы внутри workflow или внешние вызовы, чтобы не перегружать планировщик.

Можно ли задать несколько различных расписаний для одного workflow?

Нет, один Cron-узел может содержать только одно cron-выражение. Для реализации нескольких расписаний необходимо:

• Использовать несколько Cron-узлов в одном workflow, ведущих к общей логике.
• Создать несколько отдельных workflow с разными расписаниями.
• Использовать более сложное единое выражение с операторами перечисления «,» или диапазона «-«.

Где можно проверить корректность моего cron-выражения?

В интерфейсе n8n при вводе выражения в поле «Cron Expression» под ним автоматически появляется расшифровка на английском языке (например, «At every 5th minute»). Также существуют онлайн-валидаторы, такие как crontab.guru или freeformatter.com, которые помогают составить и проверить выражение.