Cron-выражения: шпаргалка с примерами, которую не стыдно добавить в закладки

Cron-выражение — это строка из 5 полей, разделённых пробелами. Поля (по порядку):

1. Минуты (0–59)
2. Часы (0–23)
3. День месяца (1–31)
4. Месяц (1–12)
5. День недели (0–7, где 0 и 7 — воскресенье)

В каждом поле можно ставить:

• Звёздочку * — любое значение (например, каждую минуту).
• Число — конкретное значение.
• Список через запятую — несколько значений (например, 1,15,30).
• Диапазон через дефис — 9-17 (каждый час с 9 до 17).
• Шаг через слеш — */10 (каждые 10 минут) или 0-30/5 (каждые 5 минут в первые 30 минут).

Пример: 30 8 * * 1-5 — в 08:30 по будням.

Не путайте: день месяца и день недели — разные поля. Если оба не *, то задача выполняется, когда совпадает хотя бы одно.

Для быстрой генерации используйте Cron генератор онлайн.

В некоторых реализациях (например, cron от GNU, Vixie cron, но не во всех) доступны сокращения:

Важно: @reboot поддерживается не везде (например, в busybox cron его нет). Проверяйте документацию вашей системы.

Пример: @daily /usr/bin/backup.sh — то же, что 0 0 * * * /usr/bin/backup.sh.

Для расчёта времени выполнения удобен Калькулятор времени выполнения cron-задач.

Задача: делать дамп PostgreSQL каждые 2 часа с 9:00 до 21:00 по будням, с очисткой старых бэкапов раз в месяц.

1. Определяем частоту дампа: с 9 до 21 каждый будний день — каждые 2 часа. Выражение: 0 9-21/2 * * 1-5. Разберём:
   • Минуты: 0 — в начале часа.
   • Часы: 9-21/2 — каждый 2-й час в диапазоне 9–21 (9,11,13,15,17,19,21).
   • Дни месяца: * — любой.
   • Месяцы: * — любой.
   • Дни недели: 1-5 — понедельник–пятница.
2. Очистка старых бэкапов: 1-го числа каждого месяца в 3:00 ночи. Выражение: 0 3 1 * *.
3. Комбинируем в crontab:

   0 9-21/2 * * 1-5 pg_dump -U postgres mydb > /backup/db_$(date +\%Y\%m\%d_\%H\%M).sql
   0 3 1 * * find /backup -name '*.sql' -mtime +30 -delete

   Edge case: если бэкап может идти дольше 2 часов — накладывается следующий. Используйте flock или временные файлы.

Когда оба поля дней (3-е поле и 5-е поле) заданы не звёздочкой, задача сработает при совпадении хотя бы одного из них.

Пример: 0 0 1,15 * 1,3 — задача выполнится 1-го и 15-го числа любого месяца, а также по понедельникам и средам (необязательно одновременно). Это не то же самое, что «1-го и 15-го, если они приходятся на понедельник или среду». Чтобы задать строгое совпадение, используют логические AND в скрипте.

Интервалы: 0 8-18 * * 1-5 — каждый час в будни с 8:00 до 18:00. Шаг: */15 — каждые 15 минут. Комбинированно: 0,30 9-17 * * * — в 0 и 30 минут каждого часа с 9 до 17.

Ошибка: 0 0 * * 0,6 — это не «выходные», а воскресенье и суббота (если 0=воскресенье, 6=суббота). В некоторых системах 7 тоже воскресенье.

Всегда проверяйте работу через Cron генератор онлайн.

• Часовой пояс: cron использует системный часовой пояс, обычно UTC. Если сервер в UTC, а вы в Москве (UTC+3), то @daily сработает в 3 часа ночи по местному времени.
• Переход на летнее/зимнее время: задачи могут сработать дважды или не сработать вовсе (в час перевода). Рекомендуется использовать UTC.
• Символ процента % в команде cron — специальный символ. Его нужно экранировать обратной косой чертой, иначе cron воспримет % как перевод строки. Пример: date +\%Y\%m\%d.
• Среда выполнения: cron использует ограниченную среду (переменные PATH, HOME и т.д.). В командах лучше указывать полные пути к исполняемым файлам (например, /usr/bin/pg_dump).
• Права доступа: cron-задачи выполняются от имени пользователя, который их добавил. Если команде нужны sudo-права — используйте visudo.
• Логи: по умолчанию cron отправляет вывод на email владельца задачи. Если не перенаправить его в файл или /dev/null, можно забить почтовый ящик.

Пример перенаправления: 0 2 * * * /usr/bin/backup.sh >> /var/log/backup.log 2>&1.

1. Проверьте, запущен ли cron-демон: systemctl status cron или service cron status.
2. Просмотрите логи cron: обычно в /var/log/syslog или /var/log/cron. Команда: grep CRON /var/log/syslog.
3. Используйте онлайн-калькулятор: Калькулятор времени выполнения cron-задач покажет ближайшие срабатывания.
4. Протестируйте команду вручную: запустите команду из cron-задачи напрямую в терминале, чтобы убедиться, что она работает и вывод в нужное место.
5. Используйте временную быструю задачу: поставьте * * * * * /path/to/command на минуту и проверьте логи — увидите, срабатывает ли вообще что-то.
6. Проверьте права на запускаемый файл: chmod +x и владелец.

Никогда не полагайтесь на «глазами» — логи дадут точный ответ, выполнилась ли задача и с какой ошибкой.

Если ваша задача должна выполняться раз в день и неважно в какое время (например, обновление кэша), anacron удобнее. Для высокоточных задач (каждые 5 минут) — только cron.

Чтобы избежать наложения задач (если команда не успела завершиться), используйте flock:

*/5 * * * * /usr/bin/flock -n /tmp/my.lock /usr/bin/script.sh

Переменные внутри crontab: можно задать MAILTO="" для отключения отправки почты, или HOME=/path.

Использование rand: полезно для рандомизации времени старта

0 * * * * sleep $(( RANDOM % 3600 )) && /script.sh

Если нужно, чтобы задача выполнялась только в рабочие дни, используйте условный оператор в скрипте: проверка date +%u.