К содержимому

crontab: планировщик задач на сервере

crontab хранит расписание задач пользователя и запускает их по времени через демон cron. Файл расписания правится командой crontab -e, а посмотреть его можно через crontab -l. Каждая строка содержит пять полей времени и команду, которая выполняется от имени владельца crontab.

Опорная Cron 4 мин чтения 16 материалов в теме

Что такое crontab и как он работает

Демон cron запускается при старте системы и раз в минуту проверяет файлы расписаний в /var/spool/cron/crontabs. Каждый пользователь имеет свой crontab, задачи выполняются от его имени и с его переменными окружения. Задачи системных служб лежат в /etc/crontab и /etc/cron.d, там дополнительно указывается пользователь. Изменения в файле через crontab -e применяются сразу, перезапуск службы не нужен.

Формат строки расписания

Строка состоит из пяти полей: минута, час, день месяца, месяц, день недели. Допустимы числа, диапазоны 1-5, списки 1,15,30 и шаг */10. После полей идёт команда, при необходимости с полным путём к исполняемому файлу. Символ % в команде cron трактует как перевод строки, поэтому его экранируют обратной косой чертой.

text
# мин час день мес дн_нед команда
*/5 * * * * /usr/bin/php /var/www/example.com/bin/worker.php
0 3 * * * /usr/bin/mysqldump -u backup -p'secret' example > /var/backups/example.sql
30 2 * * 1 /usr/bin/certbot renew --quiet

Основные команды crontab

crontab -e открывает расписание текущего пользователя в редакторе из переменной EDITOR. crontab -l выводит его на экран, это удобно для проверки после правки. Для чужого пользователя нужен sudo и ключ -u, например sudo crontab -u www-data -l. Удалить все задачи сразу позволяет crontab -r, применять её без резервной копии рискованно.

bash
crontab -e
crontab -l
sudo crontab -u www-data -l

Переменные окружения и PATH

Cron запускает задачи с минимальным окружением: PATH обычно равен /usr/bin:/bin, домашний каталог и профиль shell не подгружаются. Команды вроде php, node или composer из /usr/local/bin не находятся, и задача падает с command not found. Указывайте полный путь к бинарнику или задайте PATH в начале crontab. Переменные объявляются отдельными строками до задач.

text
PATH=/usr/local/bin:/usr/bin:/bin
MAILTO=""
*/10 * * * * /usr/bin/php /var/www/example.com/bin/worker.php >> /var/log/example-worker.log 2>&1

Права пользователя www-data

Задачи веб-приложения выполняйте от имени www-data, иначе созданные файлы окажутся с владельцем root и приложение не сможет их изменить. Свой crontab у www-data правится через sudo crontab -u www-data -e. Проверить содержимое можно командой sudo crontab -u www-data -l. Каталоги, куда пишет задача, должны быть доступны этому пользователю на запись.

bash
sudo crontab -u www-data -e
sudo crontab -u www-data -l

Где смотреть логи и результат запуска

Cron пишет факт запуска задачи в системный журнал. На Ubuntu 24.04 смотрите grep CRON /var/log/syslog или journalctl -u cron. Вывод самой команды туда не попадает: его нужно перенаправлять в файл через >> и 2>&1. Если задача не запустилась, проверьте, что демон работает: systemctl status cron.

bash
grep CRON /var/log/syslog
journalctl -u cron --since today
systemctl status cron

Долгие процессы и Supervisor

Cron не подходит для постоянных демонов: он запускает команду по расписанию и не следит за её состоянием. Долгоживущие воркеры держат под Supervisor, который перезапускает упавший процесс. После правки конфигурации в /etc/supervisor/conf.d выполните sudo supervisorctl reread и sudo supervisorctl update. Состояние процессов показывает sudo supervisorctl status.

bash
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status
sudo supervisorctl restart all

Частые ошибки

  • В crontab указана команда php без полного пути, и в логе видно command not found.

    Пропишите полный путь, например /usr/bin/php, или задайте PATH первой строкой crontab.

  • Задача от root создаёт файлы в /var/www/example.com, и приложение не может их перезаписать.

    Запускайте задачу от www-data через sudo crontab -u www-data -e и проверьте права на каталог.

  • Вывод команды никуда не перенаправлен, и причину сбоя не видно.

    Добавьте в конец строки >> /var/log/example.log 2>&1, чтобы сохранить stdout и stderr.

  • Символ % в команде, например в формате даты, ломает строку расписания.

    Экранируйте его как \% или вынесите логику в отдельный скрипт.

Deploykin

Как это делается в Deploykin

В Deploykin cron-задачи и демоны Supervisor создаются из панели: одиннадцать готовых расписаний или своё выражение, пресеты демонов для Horizon, очередей, планировщика и Reverb. Вывод задач пишется в лог и читается в панели.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Чем crontab отличается от /etc/crontab?

crontab это расписание одного пользователя, задачи выполняются от его имени. В /etc/crontab и файлах /etc/cron.d перед командой дополнительно указывается пользователь, от которого её запускать.

Почему задача работает вручную, но не в cron?

Cron запускает команду с урезанным окружением и другим рабочим каталогом. Укажите полные пути к бинарникам и файлам, задайте PATH и проверьте запуск через grep CRON /var/log/syslog.

Как запустить задачу каждые 5 минут?

Используйте строку */5 * * * * с командой после неё. Поле минуты с шагом */5 срабатывает на 0, 5, 10 и далее минутах каждого часа.

Нужно ли перезапускать cron после правки crontab?

Нет. crontab -e сохраняет файл в /var/spool/cron/crontabs, и демон подхватывает изменения сам. Перезапуск нужен только при проблемах со службой.

Можно ли запускать долгий процесс через cron?

Cron не следит за процессом и не перезапустит его после падения. Для постоянных воркеров используйте Supervisor и команды sudo supervisorctl reread и sudo supervisorctl update.

Всё по теме Cron

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.