Настройка cron для Bitrix на Ubuntu 24.04
Задачи Bitrix запускаются системным cron от имени пользователя сайта. Настройка сводится к одной строке в таблице www-data с полным путём к PHP и скрипту bitrix/modules/main/tools/cron_events.php. После сохранения проверьте запуск по логу cron и по времени изменения файлов.
01Проверьте, что cron установлен и работает
На Ubuntu 24.04 cron установлен по умолчанию. Убедитесь, что служба активна: команда systemctl status cron должна показать active (running). Если пакета нет, установите его одной командой sudo apt install cron и запустите службу.
systemctl status cron
02Определите пользователя сайта и путь к PHP
Файлы Bitrix должны принадлежать тому пользователю, от имени которого работает cron. Для nginx с PHP-FPM это обычно www-data. Проверьте владельца каталога сайта и путь к интерпретатору: в cron нельзя полагаться на PATH, поэтому нужен полный путь, например /usr/bin/php.
ls -ld /var/www/example.com
command -v php
sudo -u www-data php -v
03Откройте таблицу crontab пользователя www-data
Таблицу текущего пользователя правит crontab -e, таблицу www-data, sudo crontab -u www-data -e. Файлы лежат в /var/spool/cron/crontabs/, руками их не редактируют. Выберите редактор, если система спросит, и добавьте строку расписания.
sudo crontab -u www-data -e
04Добавьте строку запуска агентов Bitrix
Агенты и почтовая очередь Bitrix обрабатываются скриптом bitrix/modules/main/tools/cron_events.php из корня сайта. Запускайте его каждую минуту от имени www-data, с полным путём к PHP и с перенаправлением вывода в лог: без почтового сервера вывод иначе теряется. Символ % в команде экранируйте как \%.
* * * * * cd /var/www/example.com && /usr/bin/php -f bitrix/modules/main/tools/cron_events.php >> /var/log/bitrix-cron.log 2>&1
05Проверьте синтаксис и содержимое таблицы
После сохранения выведите таблицу командой sudo crontab -u www-data -l: строка должна быть на месте, без лишних пробелов и с полным путём. Ошибка в расписании не мешает сохранению, поэтому проверяйте именно вывод.
sudo crontab -u www-data -l
06Убедитесь, что задача выполняется
Подождите минуту и посмотрите записи cron в системном журнале: grep CRON /var/log/syslog или journalctl -u cron. Затем проверьте лог, куда перенаправлен вывод скрипта, и время изменения файлов в bitrix/managed_cache или в каталоге агентов. Если запись в журнале есть, а лог пуст, скрипт завершился без вывода: проверьте код возврата и права на запись.
grep CRON /var/log/syslog
sudo tail -n 50 /var/log/bitrix-cron.log
ls -l /var/www/example.com/bitrix/managed_cache
Частые ошибки
-
В crontab указан
phpбез пути, и задача не выполняется: у cron окружение сPATH=/usr/bin:/bin, а нужный интерпретатор может лежать в другом каталоге.Пропишите полный путь, например
/usr/bin/php, и проверьте его командойcommand -v php. -
Строка добавлена в таблицу
root, а файлы сайта принадлежатwww-data. Скрипт падает на правах записи вbitrix/managed_cache.Правьте таблицу владельца файлов:
sudo crontab -u www-data -e, а старую строку изrootудалите. -
Вывод скрипта не перенаправлен, и при отсутствии почтового сервера ошибки Bitrix не видны.
Допишите в конец команды
>> /var/log/bitrix-cron.log 2>&1и проверяйте этот файл после запуска. -
После смены часового пояса задачи срабатывают не в то время.
После
sudo timedatectl set-timezoneперезапустите службу:sudo systemctl restart cron.
Deploykin
Как это делается в Deploykin
В Deploykin cron-задачи и демоны Supervisor создаются из панели: одиннадцать готовых расписаний или своё выражение, пресеты демонов для Horizon, очередей, планировщика и Reverb. Вывод задач пишется в лог и читается в панели.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
От какого пользователя запускать cron для Bitrix?
От владельца файлов сайта, обычно www-data. Тогда скрипт сможет писать в bitrix/managed_cache и другие каталоги без смены прав.
Какую команду прописать в crontab?
cd /var/www/example.com && /usr/bin/php -f bitrix/modules/main/tools/cron_events.php >> /var/log/bitrix-cron.log 2>&1. Расписание * * * * * запускает её каждую минуту.
Почему задача в crontab не выполняется, хотя в консоли команда работает?
У cron другое окружение и PATH, поэтому нужны полные пути. Также проверьте права пользователя таблицы, экранирование % и наличие перевода строки в конце файла.
Где смотреть результат работы cron для Bitrix?
Запуски видны в grep CRON /var/log/syslog или journalctl -u cron, а вывод скрипта, в файле, указанном после >>.
Ещё по теме
- Руководство · Cron crontab guru: как читать формат crontab и настроить задание Разбираем формат crontab по полям, показываем команды crontab -e и crontab -l, проверку через syslog и типичные ошибки при настройке cron на Ubuntu 24.04.
- Руководство · Cron Как настроить cron каждые 5 минут на Ubuntu 24.04 Как настроить задание cron каждые 5 минут на Ubuntu 24.04: строка crontab, полные пути, логирование вывода и проверка запусков по syslog.
- Руководство · Cron Настройка crontab на Ubuntu 24.04: от расписания до проверки Пошаговая настройка crontab на Ubuntu 24.04: синтаксис расписания, запуск скрипта каждый час, права www-data, проверка через syslog и типичные ошибки.
- Руководство · Cron Как настроить ежедневное задание cron на Ubuntu 24.04 Пошаговая настройка ежедневного задания cron на Ubuntu 24.04: строка crontab, полные пути, логирование, проверка запуска через syslog и journalctl.
- Руководство · Cron Логи crontab на Ubuntu 24.04: где искать и как читать Где лежат логи crontab на Ubuntu 24.04: grep CRON /var/log/syslog, journalctl, вывод задач. Настройка логирования, причины молчания и решение.
- Руководство · Cron Cron calculator: как собрать и проверить расписание в crontab Как перевести cron-выражение в строку crontab на Ubuntu 24.04: разбор пяти полей, проверка через crontab -l и журнал cron, типичные ошибки.