Не работают агенты Битрикс: как настроить запуск на cron
Не работают агенты Битрикс обычно по одной из двух причин: сайт открывают редко, а агенты по умолчанию запускаются на хитах, то есть при обращениях посетителей, либо перенос на cron начат, но не закончен. Починка: добавить константу BX_CRONTAB_SUPPORT в dbconn.php и поставить в cron запуск cron_events.php каждую минуту. Ниже пять шагов, подсказка по признаку и список причин, по которым агенты молчат и после настройки cron.
Ответ за 30 секунд
Агенты Битрикса по умолчанию живут на посетителях: нет хитов, нет запусков. Их переносят на cron: константа в dbconn.php и задача каждую минуту. Сделайте обе половины, иначе обычные агенты уйдут с хитов, а cron их не подхватит.
Задачи cron добавляются в панели хостинга. Тарифы для Битрикс от 596 ₽ в месяц, ежедневные бэкапы и 10 дней на тест (Таймвеб, на 21 октября 2026).
Какой признак у неработающих агентов Битрикс и что с ним делать1 минпериод запуска cron_events.php
BX_CRONTAB_SUPPORTконстанта в dbconn.php
5 шаговперенос агентов на cron
01 · 1 мин
Что такое агенты 1С-Битрикс и почему они зависят от посетителей сайта#
Агент это PHP-функция, которую ядро запускает по расписанию: чистит данные, пересчитывает показатели, готовит рассылки. Список агентов находится в админке, в разделе Настройки, Настройки продукта, Агенты: у каждого виден период и время следующего запуска.
По умолчанию ядро проверяет агентов при каждом хите, то есть при загрузке любой страницы сайта. У проекта с малой посещаемостью агенты запаздывают, а у проекта с тяжёлым агентом посетитель, на чьём хите тот стартовал, ждёт ответа дольше обычного. Оба недостатка снимает запуск по расписанию.
Инструмент · 1 мин
Какой признак у неработающих агентов Битрикс и что с ним делать#
Агенты редко ломаются без следов: обычно заметны запоздавшие рассылки, зависшие страницы или стоящая очередь писем. Выберите свой признак.
Что не так с агентами Битрикс
Выберите признак. Подсказка назовёт причину и первое действие
03 · 1 мин
Как перенести запуск агентов Битрикс на cron за 5 шагов#
- Узнайте пути. PHP для cron должен быть той же версии, что у сайта. На хостинге путь к нужной версии показывает панель, на VPS он обычно
/usr/bin/php. Корень сайта в окружении BitrixVM это/home/bitrix/www/, у хостинга свой. - Добавьте константу в файл
bitrix/php_interface/dbconn.php, а если файла нет, создайте его:
После этого на хитах остаются только периодические агенты, а остальные агенты и почтовые события должен запускать cron.define('BX_CRONTAB_SUPPORT', true); - Создайте задачу cron с периодом в одну минуту. В crontab она выглядит так:
В панели хостинга выберите запуск исполняемого файла, вставьте ту же команду и укажите период «каждую минуту».* * * * * /usr/bin/php -f /home/bitrix/www/bitrix/modules/main/tools/cron_events.php - Запустите команду вручную один раз в консоли. Отсутствие вывода означает, что скрипт отработал. Если выводятся ошибки, чините их до проверки расписания.
- Проверьте результат. В списке агентов время следующего запуска должно сдвигаться каждую минуту без открытия сайта, а в «Проверке системы» не должно остаться замечания про агентов на хитах, см. проверка системы 1С-Битрикс.
Самая частая причина молчания агентов
Константу добавили, а задачу cron не создали или создали с ошибкой. Тогда обычные агенты ушли с хитов, и запускать их некому. Константу BX_CRONTAB в dbconn.php не добавляйте: её выставляет сам cron_events.php. Чтобы вернуть запуск на хиты, уберите BX_CRONTAB_SUPPORT из файла.
04 · 1 мин
Почему агенты Битрикс не отрабатывают даже после настройки cron#
| Причина | Признак | Что сделать |
|---|---|---|
| Cron вызывает другой PHP | Вручную команда сообщает об отсутствии расширений | Укажите полный путь к PHP версии сайта |
| Неверный путь к скрипту | В выводе Could not open input file | Сверьте путь к cron_events.php с корнем сайта |
| Права и владелец | Cron работает от пользователя, который не читает файлы сайта | Запускайте задачу от владельца сайта |
| Агент падает с ошибкой PHP | Время запуска не меняется у одного агента, остальные идут | Откройте журнал, см. белый экран в Битрикс |
| Не хватает памяти в консольном PHP | Скрипт обрывается на тяжёлом агенте | У консольного PHP свой лимит, см. нехватка памяти в Битрикс |
Быстрая проверка через хиты: откройте несколько страниц и посмотрите список агентов. Если время запуска сдвинулось только после ваших открытий, агенты по-прежнему идут на хитах, а cron в работе не участвует.
05 · 1 мин
Вопросы об агентах Битрикс и cron#
Можно ли оставить агентов Битрикс на хитах, если на сайте много посетителей?
Можно: при частых обращениях агенты срабатывают вовремя. Но запуск зависит от трафика, а тяжёлый агент замедляет страницу конкретного посетителя. Для магазинов и рассылок запуск выносят на cron.
Как проверить, что cron_events.php запускается каждую минуту?
Найдите в списке агентов запись с коротким периодом и понаблюдайте за временем следующего запуска: оно должно сдвигаться без открытия сайта. Дополнительно один раз выполните команду вручную.
Что будет с почтой Битрикс, если добавить BX_CRONTAB_SUPPORT и не создать задачу cron?
Почтовые события не будут отправляться: их обработку берёт на себя cron_events.php. Письма накапливаются в очереди, пока задача не заработает или константа не будет убрана из dbconn.php.
Агенты Битрикс и ИИ-агенты Битрикс24: это одно и то же?
Нет. В этом материале агенты это периодические PHP-функции 1С-Битрикс: Управление сайтом. ИИ-функции и приложение относятся к другому продукту, Битрикс24.
Почему этому можно верить
Как мы проверяли
Источники цифр на этой странице: Цены 1С-Битрикс: Управление сайтом, 1c-bitrix.ru/buy/products/cms.php, проверено 21 октября 2026; Хостинг для 1С-Битрикс Таймвеб, timeweb.com/ru/services/cms/bitrix, проверено 21 октября 2026; Цены на хостинг Таймвеб, timeweb.com/ru/services/hosting/price, проверено 21 октября 2026; Документация 1С-Битрикс: курс «Администратор. Базовый» (агенты, проверка системы, резервные копии), dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=35, проверено 21 октября 2026; Таймвеб: устранение ошибок CMS Битрикс на виртуальном хостинге (агенты на cron, cron_events.php), timeweb.com/ru/docs/virtualnyj-hosting/cms/ustranenie-oshibok-cms-bitriks, проверено 21 октября 2026; Хостинг для 1С-Битрикс Таймвеб: лимиты памяти и нагрузки MySQL по тарифам, timeweb.com/ru/services/cms/bitrix, проверено 21 октября 2026.
Разместите сайт на 1С-Битрикс
Битрикс требователен к ресурсам. Хостинг Таймвеб для 1С-Битрикс от 596 ₽ в месяц: NVMe, окружение под большие нагрузки, бесплатный SSL и домен .RU в подарок.
- Тарифы от 596 ₽ в месяц
- Оптимизирован под 1С-Битрикс
- Бесплатный SSL и ежедневные бэкапы
- Домен .RU в подарок при оплате за год