Supervisor не запускается: ошибки, причины и исправление
Если Supervisor не запускается, чаще всего виноват синтаксис в ini-файле или неверный путь к программе. Сначала проверьте sudo supervisorctl status и лог /var/log/supervisor/supervisord.log, затем конфиг через sudo supervisord -c /etc/supervisor/supervisord.conf -n.
01Синтаксическая ошибка в конфиге Supervisor
Supervisor читает все файлы из /etc/supervisor/conf.d/*.conf. Одна опечатка в секции [program:...] останавливает запуск всего демона. Проверьте конфиг в foreground-режиме: sudo supervisord -c /etc/supervisor/supervisord.conf -n. В выводе будет номер строки и описание ошибки.
sudo supervisord -c /etc/supervisor/supervisord.conf -n
02Неверный путь к исполняемому файлу или рабочей директории
В секции command должен быть абсолютный путь к бинарнику. Если указать php без пути, Supervisor не найдёт программу. Проверьте путь через which php и пропишите его в конфиг. Директория из directory тоже должна существовать.
[program:example]
command=/usr/bin/php /var/www/example.com/artisan queue:work --sleep=3
directory=/var/www/example.com
user=www-data
autostart=true
autorestart=true
stderr_logfile=/var/log/supervisor/example.err.log
stdout_logfile=/var/log/supervisor/example.out.log
03Нет прав у пользователя из user
Если в секции указан user=www-data, процесс запускается от этого пользователя. У него должен быть доступ к файлам и директориям программы. Проверьте права на /var/www/example.com и лог-файлы. Ошибка permission denied в логе укажет на проблему.
sudo -u www-data /usr/bin/php /var/www/example.com/artisan queue:work --once
04Supervisor не перечитал конфигурацию
После правки ini-файла нужно выполнить sudo supervisorctl reread, затем sudo supervisorctl update. Без этого новые программы не появятся в статусе. Если supervisorctl отвечает unix:///var/run/supervisor.sock no such file, демон не запущен или сокет в другом месте.
sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl status
05Проверка, что ошибка устранена
Выполните sudo supervisorctl status: все программы должны быть в состоянии RUNNING. Перезапустите демон и проверьте, что он поднялся. Затем посмотрите лог программы на предмет ошибок приложения.
sudo systemctl restart supervisor
sudo supervisorctl status
sudo tail -n 50 /var/log/supervisor/example.err.log
Что не помогает
-
Перезапускать только
supervisorctl restart allбезrereadиupdate.Сначала выполните
sudo supervisorctl rereadиsudo supervisorctl update, затем перезапускайте программы. -
Править
/etc/supervisor/supervisord.confвместо файлов вconf.d.Держите настройки программ в
/etc/supervisor/conf.d/*.conf, а основной файл не трогайте без необходимости. -
Запускать Supervisor от root с
user=www-dataв секции program.Убедитесь, что пользователь
www-dataимеет доступ к файлам, или запускайте программу от того пользователя, которому принадлежат файлы.
Deploykin
Как это делается в Deploykin
В Deploykin демоны Supervisor создаются из панели, и там же видно их состояние: работает, падает при старте или остановлен. Вывод каждого демона пишется в свой лог и читается в панели, а если воркер упал и Supervisor не смог его поднять, придёт оповещение.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Почему supervisorctl пишет no such file?
Демон supervisord не запущен или сокет находится по другому пути. Проверьте sudo systemctl status supervisor и путь unix:///var/run/supervisor.sock в конфиге.
Как проверить конфиг Supervisor без запуска?
Запустите sudo supervisord -c /etc/supervisor/supervisord.conf -n. Он выведет ошибки конфигурации и не будет работать в фоне.
Где смотреть логи Supervisor?
Основной лог: /var/log/supervisor/supervisord.log. Логи программ задаются в секции stdout_logfile и stderr_logfile.
Нужно ли перезагружать Supervisor после изменения конфига?
Да, выполните sudo supervisorctl reread и sudo supervisorctl update. Полный перезапуск демона нужен только при изменении основного файла supervisord.conf.
Ещё по теме
- Ошибка · Cron Crontab не выполняется: почему задача не запускается и что исправить Почему cron не запускает задачу: окружение и PATH, права пользователя, экранирование %, формат файлов в /etc/cron.d. Команды проверки и исправления.
- Руководство · Cron crontab guru: как читать формат crontab и настроить задание Разбираем формат crontab по полям, показываем команды crontab -e и crontab -l, проверку через syslog и типичные ошибки при настройке cron на Ubuntu 24.04.
- Конфиг · Cron Crontab: примеры расписаний и как их применить Готовый crontab с примерами расписаний: каждые 5 минут, каждый час, по будням, @reboot. Как применить через crontab -e и проверить по /var/log/syslog.
- Руководство · Cron Настройка cron для Bitrix на Ubuntu 24.04 Как настроить cron для Bitrix на Ubuntu 24.04: таблица пользователя www-data, запуск агентов и почтовой очереди, полные пути, логи и проверка выполнения.
- Руководство · 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 и типичные ошибки.